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 tus 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 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 dashboard de Adapty Attribution.
Adapty Attribution envía tus datos cada 24h a las 4:00 UTC. Cada archivo contendrá los datos de los eventos generados durante el día calendario anterior completo en UTC. Por ejemplo, los datos exportados automáticamente a las 4:00 UTC del 8 de marzo contendrán todos los eventos del 7 de marzo desde las 00:00:00 hasta las 23:59:59 UTC.
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.). |
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.
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 | Store de la app (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 iOS para anunciantes |
idfv | Identificador de iOS para proveedores |
gaid | ID de publicidad de Google (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 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 | ID de clic de Facebook |
ttclid | ID de clic de TikTok |
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 |