BigQuery

Convertmax peut envoyer des donnees vers BigQuery de deux manieres. Utilisez les sections ci-dessous pour identifier l’option qui correspond a votre compte, puis suivez les etapes d’authentification et de validation adaptees.

Deux facons d’alimenter BigQuery

(A) Replication reporting gerée

Utilisez cette option lorsque vous souhaitez des donnees de reporting classifiees copiees dans des tables de votre projet GCP selon un calendrier gere.

Tables typiques (selon votre configuration de reporting) :

• daily_searches
• acquisition_events
• conversion_events
• custom_events

Convertmax ou votre equipe d’onboarding configure ce chemin pour votre espace de travail. Il est distinct de la synchronisation d’entrepot en temps reel decrite ci-dessous.

(B) Synchronisation Data Warehouse (flux d’evenements)

Utilisez cette option lorsque la synchronisation Data Warehouse est activee pour votre organisation et que vous souhaitez livrer les evenements dans une table BigQuery que vous controlez.

Les evenements sont ecrits avec des colonnes stables (par exemple event_type, occurred_at et les champs de charge utile de l’evenement). La livraison peut suivre l’un de ces modes :

Votre contact Convertmax peut confirmer le mode de livraison actif pour votre espace.

Authentification

Convertmax propose deux options d’authentification pour BigQuery. Choisissez celle qui correspond a votre politique de securite et a GCP.

Impersonation de compte de service (recommandee)

Il s’agit de l’option recommandee pour la plupart des projets GCP geres par le client.

1. Creez ou designez un compte de service writer dans votre projet GCP avec acces au dataset BigQuery cible.
2. Accordez a Convertmax l’autorisation d’impersonner ce compte writer (roles/iam.serviceAccountTokenCreator sur le compte writer).
3. Indiquez l’e-mail du compte writer lorsque Convertmax ou votre contact d’onboarding le demande.

Cette approche evite de partager des cles JSON longue duree tout en permettant les ecritures dans votre projet.

Cle JSON de compte de service

Utilisez cette option si vous preferez fournir un fichier de cle de compte de service BigQuery a Convertmax.

Elle convient aux equipes qui :

• souhaitent une cle dediee pour l’integration
• n’utilisent pas l’impersonation entre projets

Televersez ou partagez la cle uniquement via les canaux approuves par votre equipe securite.

Configuration dans l’application Convertmax

Lorsque la synchronisation Data Warehouse est activee pour votre organisation :

1. Ouvrez Integrations et le parcours Data Warehouse (BigQuery) pour votre espace.
2. Saisissez l’ID de projet GCP et l’ID de dataset BigQuery.
3. Choisissez Impersonation ou JSON de compte de service et completez les etapes.

Certains comptes prennent aussi en charge une configuration GCP dans le navigateur (OAuth, selection de dataset et verification des permissions). Si ces etapes n’apparaissent pas, votre espace peut utiliser une configuration guidee ; contactez le support Convertmax.

Preparer le dataset BigQuery cible

Pour les deux options, creez ou verifiez :

1. un projet GCP qui portera l’export
2. un dataset BigQuery pour les donnees Convertmax
3. les tables correspondant a l’option choisie (tables de reporting pour (A), ou votre table d’evenements pour (B))

Minimum requis :

• ID de projet GCP
• ID de dataset BigQuery

Les noms et schemas de tables dependent de votre configuration. Suivez la documentation d’onboarding ou le support Convertmax.

Verification

Apres configuration :

1. le dataset existe dans le bon projet GCP
2. Convertmax dispose des droits necessaires pour y ecrire
3. de nouvelles lignes apparaissent dans les tables attendues (reporting pour (A), ou votre table d’evenements pour (B))

Laissez le temps du premier chargement par lots si votre compte utilise la livraison par lots.

Depannage

Permission refusee sur l’impersonation

Verifiez :

• le compte de service Convertmax peut impersonner votre compte writer (roles/iam.serviceAccountTokenCreator sur le writer)
• le compte writer a les droits BigQuery sur le dataset cible

Enregistre dans l’app mais aucune donnee dans BigQuery

Verifiez l’ID de projet GCP et l’ID de dataset, puis contactez le support Convertmax avec le nom de votre espace et l’heure approximative de la configuration. Si votre compte utilise la livraison par lots, demandez quand le prochain chargement est prevu.

Tables de reporting manquantes

Les noms et schemas des tables de reporting varient selon le compte. Demandez au support Convertmax quelles tables s’appliquent a votre espace avant d’en creer manuellement.