BigQuery

Convertmax peut envoyer des données vers BigQuery de deux manières. Utilisez les sections ci-dessous pour identifier l’option qui correspond à votre compte, puis suivez les étapes d’authentification et de validation adaptées.

Deux façons d’alimenter BigQuery

(A) Réplication reporting gérée

Utilisez cette option lorsque vous souhaitez des données de reporting classifiées copiées dans des tables de votre projet GCP selon un calendrier géré.

Tables typiques (selon votre configuration de reporting) :

• daily_searches
• acquisition_events
• conversion_events
• custom_events

Convertmax ou votre équipe d’onboarding configure ce chemin pour votre espace de travail. Il est distinct de la synchronisation d’entrepôt en temps réel décrite ci-dessous.

(B) Synchronisation Data Warehouse (flux d’événements)

Utilisez cette option lorsque la synchronisation Data Warehouse est activée pour votre organisation et que vous souhaitez livrer les événements dans une table BigQuery que vous contrôlez.

Les événements sont écrits avec des colonnes stables (par exemple event_type, occurred_at et les champs de charge utile de l’événement). 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 à votre politique de sécurité et à GCP.

Impersonation de compte de service (recommandée)

Il s’agit de l’option recommandée pour la plupart des projets GCP gérés par le client.

1. Créez ou désignez un compte de service writer dans votre projet GCP avec accès au dataset BigQuery cible.
2. Accordez à 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 évite de partager des clés JSON longue durée tout en permettant les écritures dans votre projet.

Clé JSON de compte de service

Utilisez cette option si vous préférez fournir un fichier de clé de compte de service BigQuery à Convertmax.

Elle convient aux équipes qui :

• souhaitent une clé dédiée pour l’intégration
• n’utilisent pas l’impersonation entre projets

Téléversez ou partagez la clé uniquement via les canaux approuvés par votre équipe sécurité.

Configuration dans l’application Convertmax

Lorsque la synchronisation Data Warehouse est activée 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 complétez les étapes.

Certains comptes prennent aussi en charge une configuration GCP dans le navigateur (OAuth, sélection de dataset et vérification des permissions). Si ces étapes n’apparaissent pas, votre espace peut utiliser une configuration guidée ; contactez le support Convertmax.

Préparer le dataset BigQuery cible

Pour les deux options, créez ou vérifiez :

1. un projet GCP qui portera l’export
2. un dataset BigQuery pour les données Convertmax
3. les tables correspondant à l’option choisie (tables de reporting pour (A), ou votre table d’événements pour (B))

Minimum requis :

• ID de projet GCP
• ID de dataset BigQuery

Les noms et schémas de tables dépendent de votre configuration. Suivez la documentation d’onboarding ou le support Convertmax.

Vérification

Après configuration :

1. le dataset existe dans le bon projet GCP
2. Convertmax dispose des droits nécessaires pour y écrire
3. de nouvelles lignes apparaissent dans les tables attendues (reporting pour (A), ou votre table d’événements pour (B))

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

Dépannage

Permission refusée sur l’impersonation

Vérifiez :

• 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

Enregistré dans l’app mais aucune donnée dans BigQuery

Vérifiez 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 prévu.

Tables de reporting manquantes

Les noms et schémas des tables de reporting varient selon le compte. Demandez au support Convertmax quelles tables s’appliquent à votre espace avant d’en créer manuellement.