Documentación Convertmax puede enviar datos a BigQuery de dos maneras. Usa las secciones siguientes para ver qué opción coincide con tu cuenta y luego sigue los pasos de autenticación y validación que correspondan.
Dos formas de llegar a BigQuery
(A) Replicación de reporting gestionada
Usa esta opción cuando quieras datos de reporting clasificados copiados a tablas de tu proyecto de GCP en un calendario gestionado.
Tablas típicas (según tu configuración de reporting):
daily_searchesacquisition_eventsconversion_eventscustom_events
Convertmax o tu equipo de onboarding configura esta ruta para tu workspace. Es independiente de la sincronización de almacén en tiempo real que se describe abajo.
(B) Sincronización de almacén de datos (flujo de eventos)
Usa esta opción cuando Data Warehouse Sync esté habilitado para tu organización y quieras que los eventos se entreguen en una tabla de BigQuery que tú controles.
Los eventos se escriben con columnas estables (por ejemplo event_type, occurred_at y campos del payload del evento). La entrega puede funcionar de dos formas:
| Estilo de entrega | Qué esperar |
|---|---|
| Por lotes | Los eventos se recopilan y cargan en BigQuery según un calendario o mediante un paso de carga posterior. Es el valor predeterminado en muchas cuentas. |
| Inserción directa | Los eventos se insertan en la tabla configurada a medida que se procesan, sin esperar una carga por lotes aparte. |
Tu contacto de Convertmax puede confirmar qué estilo de entrega está activo en tu workspace.
Autenticación
Convertmax admite dos opciones de autenticación para BigQuery. Elige la que encaje con tu política de seguridad y con GCP.
Impersonación de service account (recomendada)
Es la opción recomendada para la mayoría de proyectos GCP gestionados por el cliente.
- Crea o designa una service account writer en tu proyecto de GCP con acceso al dataset de BigQuery de destino.
- Concede a Convertmax permiso para impersonar esa service account (
roles/iam.serviceAccountTokenCreatorsobre la cuenta writer). - Proporciona el correo de la service account writer cuando se solicite en Convertmax o a tu contacto de onboarding.
Así se evita compartir claves JSON de larga duración y aun así se permite escribir en tu proyecto.
Clave JSON de service account
Usa esta opción cuando prefieras entregar un archivo de clave de service account de BigQuery a Convertmax.
Encaja en equipos que:
- quieren usar una clave dedicada para la integración
- no usan impersonación entre proyectos
Sube o comparte la clave solo por los canales que apruebe tu equipo de seguridad.
Configuración en la aplicación Convertmax
Cuando Data Warehouse Sync esté habilitado para tu organización:
- Abre Integrations y el flujo Data Warehouse (BigQuery) de tu workspace.
- Introduce el ID de proyecto de GCP y el ID del dataset de BigQuery.
- Elige Impersonación o JSON de service account y completa los pasos.
Algunas cuentas también admiten configuración de GCP en el navegador (OAuth, selección de dataset y comprobación de permisos). Si no ves esos pasos, tu workspace puede usar una configuración guiada; contacta al soporte de Convertmax.
Preparar el dataset de BigQuery de destino
Para ambas opciones, crea o confirma:
- un proyecto de GCP que será dueño del export
- un dataset de BigQuery para los datos de Convertmax
- tablas acordes con la opción que uses (tablas de reporting para (A), o tu tabla de eventos para (B))
Como mínimo necesitas:
- ID de proyecto de GCP
- ID del dataset de BigQuery
Los nombres y esquemas de las tablas dependen de tu configuración. Sigue la guía de onboarding o al soporte de Convertmax.
Validar el export
Tras la configuración:
- el dataset existe en el proyecto GCP correcto
- Convertmax tiene permiso para escribir en ese dataset
- aparecen filas nuevas en las tablas esperadas (reporting para (A), o tu tabla de eventos para (B))
Deja tiempo para la primera carga por lotes si tu cuenta usa entrega por lotes.
Solución de problemas
Permiso denegado en impersonación
Comprueba:
- la service account de Convertmax puede impersonar tu service account writer (
roles/iam.serviceAccountTokenCreatorsobre el writer) - la service account writer tiene acceso BigQuery al dataset de destino
Guardado en la app pero sin datos en BigQuery
Comprueba que el ID de proyecto y el ID de dataset de GCP son correctos y contacta al soporte de Convertmax con el nombre de tu workspace y la hora aproximada en que completaste la configuración. Si tu cuenta usa entrega por lotes, pregunta cuándo se espera la siguiente carga.
Faltan tablas de reporting
Los nombres y esquemas de las tablas de reporting varían por cuenta. Pregunta al soporte de Convertmax qué tablas aplican a tu workspace antes de crear tablas manualmente.