Custom S3
La integración de Adapty UA 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 el rendimiento de tus campañas, los datos de atribución y los eventos de adquisición de usuarios en tu bucket S3 personalizado como archivos .csv.
Para configurar esta integración, solo tienes que seguir unos pocos pasos en la consola de tu almacenamiento compatible con S3 y en el dashboard de Adapty UA.
Adapty UA envía tus datos cada 24h a las 4:00 UTC.
Cada archivo contendrá los datos de los eventos creados durante todo el día natural anterior en UTC. Por ejemplo, los datos exportados automáticamente a las 4:00 UTC del 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.
Configurar la integración con S3 personalizado
Para empezar a recibir datos, configura la integración en Adapty UA:
- Ve a Integrations -> Custom S3
- Activa el interruptor Export install events to custom S3.
- Rellena los campos obligatorios para establecer la conexión entre tu almacenamiento S3 personalizado y los perfiles de Adapty UA.
| Campo | Descripción |
|---|---|
| Access Key ID | Identificador único que se usa 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 sencillo 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 quieres 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 de tu servicio de almacenamiento compatible con S3. Tu proveedor de almacenamiento debe proporcionarla (p. ej., MinIO, DigitalOcean Spaces, Wasabi, etc.). |
También puedes especificar directorios anidados en el campo del nombre del bucket S3, p. ej. 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 con S3 personalizado, Adapty UA proporciona una tabla para almacenar el historial de eventos de instalación. La tabla contiene información sobre el perfil de usuario, los ingresos y las ganancias, y el store de origen, entre otros datos.
Ten en cuenta que esta estructura puede crecer con el tiempo, con nuevos datos introducidos por nosotros o por terceros con los que trabajamos. Asegúrate de que el código que la procesa sea suficientemente robusto y se base en campos específicos, no en la estructura como un todo.
Esta es la estructura de la tabla para los eventos:
| Columna | Descripción |
|---|---|
adapty_profile_id | Identificador único del 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 | iOS Identifier for Advertisers |
idfv | iOS Identifier for Vendors |
gaid | Google Advertising ID (Android) |
android_id | ID de dispositivo Android |
app_set_id | Android App Set ID |
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 concordancia de palabra clave 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 |