La integración de Adapty UA con Amazon S3 te permite almacenar de forma segura los datos de tus campañas de adquisición de usuarios en un único lugar centralizado. Podrás guardar datos de rendimiento de campañas, datos de atribución y eventos de adquisición de usuarios en tu bucket de Amazon S3 como archivos .csv.
Para configurar esta integración, deberás seguir unos sencillos pasos en la AWS Console y en el dashboard de Adapty UA.

Cómo configurar la integración con Amazon S3

Para empezar a recibir datos, necesitarás las siguientes credenciales:

1. Access key ID
2. Secret access key
3. Nombre del bucket de S3
4. Nombre de la carpeta dentro del bucket de S3

Paso 1. Crear las credenciales de Amazon S3

Esta guía te ayudará a crear las credenciales necesarias en tu AWS Console.

1.1. Crear una política de acceso

1. Ve al IAM Policy Dashboard en tu AWS Console
2. Selecciona la opción Create Policy

3. En el editor de políticas, pega el siguiente JSON y cambia adapty-s3-integration-test por el nombre de tu bucket:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowListObjectsInBucket",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        },
        {
            "Sid": "AllowAllObjectActions",
            "Effect": "Allow",
            "Action": "s3:*Object",
            "Resource": [
                "arn:aws:s3:::adapty-s3-integration-test/*",
                "arn:aws:s3:::adapty-s3-integration-test"
            ]
        },
        {
            "Sid": "AllowBucketLocation",
            "Effect": "Allow",
            "Action": "s3:GetBucketLocation",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        }
    ]
}

4. Tras completar la configuración de la política, puedes añadir etiquetas (opcional) y luego hacer clic en Next para pasar al paso final
5. En este paso, asigna un nombre a tu política y haz clic en el botón Create policy para finalizar el proceso de creación

1.2. Crear un usuario IAM

Para que Adapty UA pueda subir informes de datos sin procesar a tu bucket, necesitarás proporcionarle el Access Key ID y el Secret Access Key de un usuario con acceso de escritura al bucket correspondiente.

1. Ve a la IAM Console y selecciona la sección Users
2. Haz clic en el botón Add users

3. Asigna un nombre al usuario, elige Access key – Programmatic access y continúa con los permisos

4. En el siguiente paso, selecciona la opción Add user to group y luego haz clic en el botón Create group

5. A continuación, asigna un nombre a tu User Group y selecciona la política que creaste anteriormente
6. Una vez seleccionada la política, haz clic en el botón Create group para completar el proceso

7. Después de crear el grupo correctamente, selecciónalo y continúa al siguiente paso

8. Como este es el último paso de esta sección, puedes continuar simplemente haciendo clic en el botón Create User

9. Por último, puedes descargar las credenciales en formato .csv o bien copiarlas y pegarlas directamente desde el dashboard

Paso 2. Configurar la integración en Adapty UA

1. Ve a Integrations -> Amazon S3
2. Activa el toggle Export install events to Amazon S3.
3. Rellena los siguientes campos para establecer la conexión entre Amazon S3 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 un servicio de AWS. Encuéntralo en el archivo csv descargado.
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 un servicio de AWS. Encuéntrala en el archivo csv descargado.
S3 Bucket Name	Nombre único global que identifica un bucket de S3 específico dentro de la nube de AWS. Los buckets de S3 son un servicio de almacenamiento simple que permite guardar y recuperar objetos de datos, como archivos e imágenes, en la nube.
Folder Inside the Bucker	El nombre de la carpeta que quieres tener dentro del bucket de S3 seleccionado. Ten en cuenta que S3 simula carpetas usando prefijos de clave de objeto, que son esencialmente nombres de carpeta.
Region (Opcional)	Obtén tu región en la AWS Management Console bajo tu cuenta de usuario IAM.

Exportación manual de datos

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

Estructura de la tabla

En la integración con AWS S3, Adapty UA proporciona una tabla para almacenar el historial de datos de eventos de instalación. La tabla contiene información sobre el perfil del usuario, los ingresos y beneficios netos, y la store de origen, entre otros datos.

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 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 de fuente UTM
utm_medium	Parámetro de medio UTM
utm_campaign	Parámetro de campaña UTM
utm_term	Parámetro de término UTM
utm_content	Parámetro de contenido UTM