Configuration et connexion de l’environnement

Présentation : Suivez ces étapes pour préparer BigQuery pour Klaviyo. Vous créerez les schémas requis (dans un ensemble de données/un projet), configurerez un compte de service dédié et une clé, attribuerez les privilèges minimum requis, vérifierez la configuration et connecterez BigQuery à Klaviyo.

Pour en savoir plus sur le fonctionnement de l’importation depuis un entrepôt de données dans Klaviyo (y compris la structure du schéma, les tables requises et les mappages de champs), consultez Fonctionnement de l’importation depuis un entrepôt de données dans Klaviyo.

1) Créer les schémas/jeux de données requis

Dans BigQuery, créez deux ensembles de données dans le projet que vous utiliserez pour Klaviyo.

CREATE SCHEMA `KLAVIYO_IMPORT_FROM_DWH`;
CREATE SCHEMA `KLAVIYO_TMP`;

• KLAVIYO_IMPORT_FROM_DWH: Les tables et les vues créées dans cet ensemble de données seront disponibles pour que Klaviyo puisse les lire/les écrire.
• KLAVIYO_TMP: Données temporaires ou intermédiaires utilisées pendant les opérations de synchronisation.

2) Créer le compte et la clé Klaviyo Service

Créez un compte de service Google (par exemple, KLAVIYO_DATA_TRANSFER_USER) que Klaviyo utilisera exclusivement pour cette intégration. Téléchargez une clé JSON pour ce compte et stockez-la en lieu sûr.

• Accédez à IAM & Admin → Comptes de service dans la console GCP.
• Créez un nouveau compte de service (ou sélectionnez-en un existant dédié à Klaviyo).
• Dans l’onglet Clés, créez une nouvelle clé de type JSON. Conservez ce fichier de clé en lieu sûr — vous en aurez besoin lors de la configuration de la connexion dans Klaviyo.

3) Attribuer les autorisations requises

Attribuez au compte de service les rôles suivants, limités aux deux ensembles de données que vous avez créés :

-- Example commands in GCP CLI (replace placeholders):
gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
  --member="serviceAccount:KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/bigquery.dataEditor" \
  --condition=None \
  --dataset="KLAVIYO_TMP"

gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
  --member="serviceAccount:KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/bigquery.dataViewer" \
  --condition=None \
  --dataset="KLAVIYO_IMPORT_FROM_DWH"

4) Vérifier votre configuration (facultatif)

4.1 Confirmer que les ensembles de données existent

SELECT schema_name 
FROM `YOUR_PROJECT_ID.INFORMATION_SCHEMA.SCHEMATA`
WHERE schema_name IN ('KLAVIYO_IMPORT_FROM_DWH','KLAVIYO_TMP');

4.2 Confirmer l’accès au compte de service

Utilisez la clé du compte de service pour vous authentifier avec la CLI BigQuery ou l’API et exécuter une requête simple :

bq --project_id=YOUR_PROJECT_ID \
   --dataset_id=KLAVIYO_IMPORT_FROM_DWH \
   query --use_legacy_sql=false \
   'SELECT COUNT(*) FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.some_table` LIMIT 1'

4.3 Vérifiez les autorisations sur chaque ensemble de données

SELECT * 
FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.INFORMATION_SCHEMA.OBJECT_PRIVILEGES`
WHERE grantee = 'KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com';

4.4 Optionnel : valider les opérations de création/lecture

-- Test create in KLAVIYO_TMP
CREATE TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions` (id INT64);
DROP TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions`;

-- Test select in KLAVIYO_IMPORT_FROM_DWH
SELECT * FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.some_existing_table` LIMIT 1;

Astuce : exécutez ces vérifications en utilisant le même compte de service et la même clé que vous fournirez à Klaviyo. Conservez une copie des résultats à des fins d’audit.

5) Connecter Klaviyo à BigQuery

Une fois que votre environnement BigQuery est configuré, finalisez la connexion dans Klaviyo.

1. Dans Klaviyo, accédez à Avancé → Synchronisation dans la barre latérale gauche.
2. Cliquez sur Créer une synchronisation.
3. Sélectionnez Importer ou exporter des données vers votre entrepôt de données.
4. Choisissez BigQuery comme entrepôt de données.
5. Cliquez sur Se connecter à BigQuery.

Lorsque vous y êtes invité, fournissez les détails de configuration de connexion suivants :

Après la connexion : Klaviyo validera la connexion, testera l’accès à vos ensembles de données, puis vous permettra de configurer des synchronisations, à la fois pour importer des données dans Klaviyo et exporter des données Klaviyo vers BigQuery.

Étape suivante : Après vous être connecté avec succès, créez votre première synchronisation d’importation ou d’exportation dans Klaviyo et commencez à déplacer des données vers BigQuery ou depuis BigQuery.