Documentacion Convertmax puede enviar datos a BigQuery de dos maneras. Usa las secciones siguientes para ver que opcion coincide con tu cuenta y luego sigue los pasos de autenticacion y validacion que correspondan.
Dos formas de llegar a BigQuery
(A) Replicacion de reporting gestionada
Usa esta opcion cuando quieras datos de reporting clasificados copiados a tablas de tu proyecto de GCP en un calendario gestionado.
Tablas tipicas (segun tu configuracion de reporting):
daily_searchesacquisition_eventsconversion_eventscustom_events
Convertmax o tu equipo de onboarding configura esta ruta para tu workspace. Es independiente de la sincronizacion de almacen en tiempo real que se describe abajo.
(B) Sincronizacion de almacen de datos (flujo de eventos)
Usa esta opcion cuando Data Warehouse Sync este habilitado para tu organizacion y quieras que los eventos se entreguen en una tabla de BigQuery que tu 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 | Que esperar |
|---|---|
| Por lotes | Los eventos se recopilan y cargan en BigQuery segun un calendario o mediante un paso de carga posterior. Es el valor predeterminado en muchas cuentas. |
| Insercion 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 que estilo de entrega esta activo en tu workspace.
Autenticacion
Convertmax admite dos opciones de autenticacion para BigQuery. Elige la que encaje con tu politica de seguridad y con GCP.
Impersonacion de service account (recomendada)
Es la opcion recomendada para la mayoria 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.
Asi se evita compartir claves JSON de larga duracion y aun asi se permite escribir en tu proyecto.
Clave JSON de service account
Usa esta opcion 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 integracion
- no usan impersonacion entre proyectos
Sube o comparte la clave solo por los canales que apruebe tu equipo de seguridad.
Configuracion en la aplicacion Convertmax
Cuando Data Warehouse Sync este habilitado para tu organizacion:
- 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 Impersonacion o JSON de service account y completa los pasos.
Algunas cuentas tambien admiten configuracion de GCP en el navegador (OAuth, seleccion de dataset y comprobacion de permisos). Si no ves esos pasos, tu workspace puede usar una configuracion guiada; contacta al soporte de Convertmax.
Preparar el dataset de BigQuery de destino
Para ambas opciones, crea o confirma:
- un proyecto de GCP que sera dueno del export
- un dataset de BigQuery para los datos de Convertmax
- tablas acordes con la opcion que uses (tablas de reporting para (A), o tu tabla de eventos para (B))
Como minimo necesitas:
- ID de proyecto de GCP
- ID del dataset de BigQuery
Los nombres y esquemas de las tablas dependen de tu configuracion. Sigue la guia de onboarding o al soporte de Convertmax.
Validar el export
Tras la configuracion:
- 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.
Solucion de problemas
Permiso denegado en impersonacion
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 configuracion. Si tu cuenta usa entrega por lotes, pregunta cuando se espera la siguiente carga.
Faltan tablas de reporting
Los nombres y esquemas de las tablas de reporting varian por cuenta. Pregunta al soporte de Convertmax que tablas aplican a tu workspace antes de crear tablas manualmente.