Google Cloud Storage
La integración de Adapty UA con Google Cloud Storage te permite almacenar los datos de tus campañas de adquisición de usuarios de forma segura en un único lugar centralizado. Podrás guardar los datos de rendimiento de tus campañas, los datos de atribución y los eventos de adquisición de usuarios en tu bucket de Google Cloud Storage como archivos .csv.
Para configurar esta integración, deberás seguir unos sencillos pasos en la consola de Google Cloud y en el dashboard de Adapty UA.
Programación
Adapty UA envía tus datos a Google Cloud Storage cada 24h a las 4:00 UTC.
Cada archivo contendrá los datos de los eventos creados durante el día natural anterior completo en UTC. Por ejemplo, los datos exportados automáticamente a las 4:00 UTC del 8 de marzo incluirán todos los eventos creados el 7 de marzo desde las 00:00:00 hasta las 23:59:59 en UTC.
Cómo configurar la integración con Google Cloud Storage
Paso 1. Crear 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 UA pueda subir informes de datos sin procesar 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 UA transfiera de forma segura y eficiente los informes de datos sin procesar desde su plataforma a tu entorno de almacenamiento.
Ten en cuenta que solo admitimos la autorización mediante clave HMAC de cuenta de servicio, por lo que es imprescindible que tu clave HMAC de cuenta de servicio tenga asignados los roles “Storage Object Viewer”, “Storage Legacy Bucket Writer” y “Storage Object Creator” para habilitar el acceso correcto a Google Cloud Storage.
2.1. Crear una cuenta de servicio
- Ve a la sección IAM de tu cuenta de Google Cloud y selecciona el proyecto correspondiente o crea uno nuevo
- A continuación, crea una nueva cuenta de servicio para Adapty UA haciendo clic en el botón ”+ CREATE SERVICE ACCOUNT”
- Rellena los campos del primer paso, ya que el acceso se concederá en una etapa posterior. Para obtener más información sobre esta página, consulta la documentación aquí
- Para crear y descargar una clave JSON privada, ve a la sección KEYS y haz clic en el botón “ADD KEY”
- En la sección DETAILS, localiza el valor de 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
- 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 adquisición de usuarios de Adapty UA
- Ve a la sección PERMISSIONS y selecciona la opción GRANT ACCESS
- En la sección PERMISSIONS, introduce el Email de la cuenta de servicio obtenido en el quinto paso anterior y selecciona el rol Storage Object Creator
- Por último, haz clic en SAVE para aplicar los cambios
-
Recuerda guardar el nombre del bucket para futuras referencias
-
Tras completar estos pasos, habrás finalizado la configuración necesaria en la consola de Google Cloud. El último paso consiste en introducir el nombre del bucket y descargar el archivo JSON para usarlo en Adapty UA
Paso 2. Configurar la integración en Adapty UA
- Ve a Integrations -> Google Cloud Storage
- Activa el toggle Export install events to Google Cloud Storage
- Rellena los campos requeridos para establecer la conexión entre Google Cloud Storage y Adapty UA:
| 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 deseas 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 deseas almacenar tus datos. Debe ser único dentro del bucket y puede usarse para organizar los datos. 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 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, 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 procesa estos datos sea lo suficientemente robusto y se base en campos específicos, no en la estructura en su conjunto.
A continuación se muestra 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 | ID de conjunto de apps de Android |
channel | Canal de atribución |
campaign_id | Identificador de campaña |
campaign_name | Nombre de campaña |
adset_id | Identificador de conjunto de anuncios |
adset_name | Nombre del conjunto de anuncios |
ad_id | Identificador de 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 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 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 |