La integración de Adapty Attribution 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 los datos de rendimiento de tus 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 Adapty Attribution dashboard.

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 credenciales de Amazon S3

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

1.1. Crear 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. Una vez completada la configuración de la política, puedes añadir etiquetas (opcional) y luego hacer clic en Next para continuar al último paso
5. En este paso, pondrás nombre a tu política y simplemente harás clic en el botón Create policy para finalizar el proceso de creación

1.2. Crear usuario IAM

Para que Adapty Attribution pueda subir informes de datos sin procesar a tu bucket, deberás proporcionarle el Access Key ID y el Secret Access Key de un usuario con acceso de escritura al bucket específico.

1. Ve a la consola de IAM y selecciona la sección Usuarios
2. Haz clic en el botón Add users

3. Ponle 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 haz clic en el botón Create group

5. A continuación, asigna un nombre a tu Grupo de Usuarios 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. Una vez creado el grupo, selecciónalo y continúa con el 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 copiarlas y pegarlas directamente desde el dashboard

Paso 2. Configurar la integración en Adapty Attribution

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 Attribution: | Campo | Descripción | |:-----------------------------| :----------------------------------------------------------- | | Access Key ID | Un 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 | Una 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 | Un nombre único global que identifica un bucket S3 específico dentro de la nube de AWS. Los buckets S3 son un servicio de almacenamiento simple que permite a los usuarios 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 S3 seleccionado. Ten en cuenta que S3 simula carpetas mediante prefijos de clave de objeto, que son esencialmente nombres de carpeta. | | Region (Opcional) | Obtén tu región desde la consola de administración de AWS en 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 Attribution ofrece 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.

Esta es la estructura de la tabla para los eventos:

Columna	Descripción
adapty_profile_id	Identificador único de perfil en 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 aplicaciones (ios, android)
country	Código de país del usuario (ISO 3166-1 alpha-2)
ip_address	Dirección IP del cliente
idfa	Identificador para anunciantes de iOS
idfv	Identificador para proveedores de iOS
gaid	ID de publicidad de Google (Android)
android_id	ID de dispositivo Android
app_set_id	App Set ID de Android
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 ASA (cadena JSON)
asa_conversion_type	Tipo de conversión ASA
asa_country_or_region	País o región de ASA
asa_creative_set_name	Nombre del conjunto creativo ASA
fbclid	ID de clic de Facebook
ttclid	ID de clic de TikTok
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