La integración de Adapty Attribution con Google Cloud Storage 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 campañas, datos de atribución y eventos de adquisición de usuarios en tu bucket de Google Cloud Storage como archivos .csv.

Para configurar esta integración, tendrás que seguir unos sencillos pasos en la Google Cloud Console y en el Adapty Attribution Dashboard.

Cómo configurar la integración con Google Cloud Storage

Paso 1. Crea las credenciales de Google Cloud Storage

Esta guía te ayudará a crear las credenciales necesarias en la consola de Google Cloud Platform.

Para que Adapty Attribution pueda subir informes de datos brutos a tu bucket designado, se necesita la clave de la cuenta de servicio, así como acceso de escritura al bucket correspondiente. Al proporcionar la clave de la cuenta de servicio y conceder acceso de escritura al bucket, permites que Adapty Attribution transfiera de forma segura y eficiente los informes de datos brutos desde su plataforma a tu entorno de almacenamiento.

2.1. Crear cuenta de servicio

1. Ve a la sección IAM de tu cuenta de Google Cloud y elige el proyecto correspondiente o crea uno nuevo

2. A continuación, crea una nueva cuenta de servicio para la atribución de Adapty haciendo clic en el botón + CREATE SERVICE ACCOUNT

3. Rellena los campos del primer paso, ya que el acceso se concederá en una etapa posterior. Para obtener más detalles sobre esta página, consulta la documentación aquí

4. Para crear y descargar una clave JSON privada, ve a la sección KEYS y haz clic en el botón “ADD KEY”

5. En la sección DETAILS, localiza el valor Email vinculado a la cuenta de servicio recién creada y cópialo. Esta información será necesaria en los próximos pasos para autorizar la cuenta y permitirle escribir en el bucket.

2.2. Configurar los permisos del bucket

6. Ve a la página de Buckets de Google Cloud Storage y selecciona un bucket existente o crea uno nuevo para almacenar los informes de datos de atribución de usuarios de Adapty Attribution
7. Navega a la sección PERMISSIONS y selecciona la opción para GRANT ACCESS

8. En la sección PERMISSIONS, introduce el Email de la cuenta de servicio obtenido en el quinto paso mencionado anteriormente y selecciona el rol Storage Object Creator
9. Por último, haz clic en SAVE para aplicar los cambios

10. Recuerda guardar el nombre del bucket para consultarlo más adelante.

11. Una vez completados estos pasos, habrás finalizado correctamente la configuración necesaria en Google Cloud Console. El último paso consiste en introducir el nombre del bucket y descargar el archivo JSON para usarlo en Adapty Attribution.

Paso 2. Configurar la integración en Adapty Attribution

1. Ve a Integrations -> Google Cloud Storage
2. Activa el toggle Export install events to Google Cloud Storage
3. Rellena los campos obligatorios para establecer la conexión entre Google Cloud Storage y Adapty Attribution: | Campo | Descripción | |:------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Google Cloud service account key file | El archivo de clave JSON privado descargado. | | Google Cloud bucket name | El nombre del bucket en Google Cloud Storage donde quieres almacenar tus datos. Debe ser único dentro del entorno de Google Cloud Storage y no puede contener espacios. | | Folder inside the bucket | El nombre de la carpeta dentro del bucket donde quieres almacenar tus datos. Debe ser único dentro del bucket y puede usarse para organizar la información. Este campo es opcional. |

Exportación manual de datos

Además de la exportación automática de datos de eventos a Google Cloud Storage, Adapty UA también ofrece una 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 GCS. Esto te da mayor control sobre los datos que exportas y cuándo lo haces.

Estructura de la tabla

En la integración con Google Cloud Storage, 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, los ingresos y los beneficios, y el store de origen, entre otros puntos de datos.

Esta es la estructura de la tabla para los eventos:

Columna	Descripción
adapty_profile_id	Identificador único del 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 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 para anunciantes de iOS
idfv	Identificador para vendors 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 ASA
asa_creative_set_name	Nombre del conjunto creativo ASA
fbclid	Click ID de Facebook
ttclid	Click ID 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