S3 personalizado en Adapty Attribution

La integración de Adapty Attribution con almacenamiento compatible con S3 personalizado te permite guardar de forma segura los datos de campañas de adquisición de usuarios en tu propia solución de almacenamiento compatible con S3. Podrás guardar los datos de rendimiento de campañas, datos de atribución y eventos de adquisición de usuarios en tu bucket de S3 personalizado como archivos .csv. Para configurar esta integración, deberás seguir unos sencillos pasos en la consola de tu almacenamiento compatible con S3 y en el Adapty Attribution dashboard.

Note

Adapty Attribution exporta un conjunto de archivos por día natural. El programador de exportaciones se ejecuta tres veces al día: a las 02:00, 04:00 y 06:00 UTC. Cada ejecución crea el trabajo de exportación del día anterior si aún no existe, o lo reintenta si una ejecución anterior falló. Por lo general, tus datos estarán disponibles tras la ejecución de las 02:00; las ejecuciones posteriores están pensadas para recuperarse de fallos, no para agregar datos nuevos.

Cada archivo contendrá datos de los eventos creados durante el día natural anterior completo en UTC. Por ejemplo, los datos exportados el 8 de marzo contendrán todos los eventos creados el 7 de marzo desde las 00:00:00 hasta las 23:59:59 en UTC.

Warning

La exportación programada solo se ejecuta para empresas con un plan de pago o en período de prueba. Si tu empresa no cumple ninguna de estas condiciones, el programador omite la ejecución y no escribe ningún archivo, aunque la integración siga habilitada en el dashboard. Si tu bucket está vacío y la configuración parece correcta, comprueba primero el estado de tu plan.

Configurar la integración de Custom S3

Para empezar a recibir datos, configura la integración en Adapty Attribution:

Ve a Integrations -> Custom S3
Activa el toggle Export install events to custom S3.
Rellena los campos obligatorios para establecer la conexión entre tu almacenamiento Custom S3 y los perfiles de Adapty Attribution. | Campo | Descripción | |:----------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Access Key ID | Identificador único que se utiliza para autenticar el acceso de un usuario o aplicación a tu servicio de almacenamiento compatible con S3. Encuéntralo en la consola de tu proveedor de almacenamiento. | | Secret Access Key | Clave privada que se usa junto con el Access Key ID para autenticar el acceso de un usuario o aplicación a tu servicio de almacenamiento compatible con S3. Encuéntrala en la consola de tu proveedor de almacenamiento. | | S3 Bucket Name | Nombre único a nivel global que identifica un bucket S3 específico dentro de tu entorno de almacenamiento. Los buckets S3 son un servicio de almacenamiento simple que permite guardar y recuperar objetos de datos, como archivos e imágenes, en la nube. | | Region (Opcional) | Obtén tu región desde la consola de administración. | | Folder Inside the Bucket (Opcional) | Nombre de la carpeta que deseas crear dentro del bucket S3 seleccionado. Ten en cuenta que S3 simula carpetas mediante prefijos de clave de objeto, que son esencialmente nombres de carpeta. | | Custom Endpoint URL | URL del endpoint para tu servicio de almacenamiento compatible con S3. Tu proveedor de almacenamiento debe facilitártela (por ejemplo, MinIO, DigitalOcean Spaces, Wasabi, etc.). |

Note

También puedes especificar directorios anidados en el campo del nombre del bucket de S3, por ejemplo, adapty-ua-events/com.sample-app

Exportación manual de datos

Además de la exportación automática de datos de eventos a tu almacenamiento S3 personalizado, Adapty UA también ofrece una función de exportación manual de archivos. Con esta función puedes seleccionar una fecha para los datos de adquisición de usuarios y exportarlos manualmente a tu bucket S3. Esto te da mayor control sobre qué datos exportas y cuándo lo haces.

Estructura de la tabla

En la integración personalizada con S3, Adapty Attribution proporciona una tabla para almacenar datos históricos de eventos de instalación. La tabla contiene información sobre el perfil del usuario, ingresos y beneficios, y el store de origen, entre otros datos.

Warning

Ten en cuenta que esta estructura puede crecer con el tiempo, ya que nosotros o terceros con los que trabajamos podemos añadir nuevos datos. Asegúrate de que el código que la procesa sea lo suficientemente robusto y se base en campos específicos, no en la estructura en su conjunto.

Aquí está la estructura de la tabla para los eventos:

Columna	Descripción
`adapty_profile_id`	Identificador único de perfil de Adapty
`install_id`	Identificador único de instalación
`created_at`	Marca de tiempo de creación del registro (ISO 8601)
`installed_at`	Marca de tiempo de instalación de la app (ISO 8601)
`store`	App store (`ios`, `android`)
`country`	Código de país del usuario (ISO 3166-1 alpha-2)
`ip_address`	Dirección IP del cliente
`idfa`	Identificador de anunciantes de iOS
`idfv`	Identificador de proveedores de iOS
`gaid`	Google Advertising ID (Android)
`android_id`	ID de dispositivo Android
`app_set_id`	Android App Set ID
`bundle_id`	Identificador del bundle de la app (p. ej. `com.example.app`)
`device_brand`	Marca del dispositivo (p. ej. `Apple`, `Samsung`)
`device_model`	Modelo del dispositivo (p. ej. `iPhone15,2`)
`os_version`	Versión principal del sistema operativo
`app_version`	Versión de la app reportada por el SDK de Adapty
`sdk_version`	Versión del SDK de Adapty
`channel`	Canal de atribución
`campaign_id`	Identificador de campaña
`campaign_name`	Nombre de la campaña
`adset_id`	Identificador del conjunto de anuncios
`adset_name`	Nombre del conjunto de anuncios
`ad_id`	Identificador del anuncio
`ad_name`	Nombre del anuncio
`keyword_id`	Identificador de la palabra clave
`keyword_name`	Nombre de la palabra clave
`asa_org_id`	ID de organización de Apple Search Ads
`asa_keyword_match_type`	Tipo de coincidencia de palabra clave de ASA (`Exact`, `Broad`)
`asa_attribution`	Datos de atribución de ASA (cadena JSON)
`asa_conversion_type`	Tipo de conversión de ASA
`asa_country_or_region`	País o región de ASA
`asa_creative_set_name`	Nombre del conjunto creativo de ASA
`fbclid`	Facebook Click ID
`ttclid`	TikTok Click ID
`utm_source`	Parámetro UTM source
`utm_medium`	Parámetro UTM medium
`utm_campaign`	Parámetro UTM campaign
`utm_term`	Parámetro UTM term
`utm_content`	Parámetro UTM content
`click_time`	Marca de tiempo del clic atribuido, en segundos Unix. Vacío cuando no se atribuye ningún clic a la instalación.