Comprendre la synchronisation des entrepôts de données dans Klaviyo

Objectif de cet article

Découvrez comment synchroniser les données Klaviyo vers votre entrepôt de données et importer les données de l’entrepôt vers Klaviyo via SFTP. Vous pouvez synchroniser votre profil client et vos données d’événement, ce qui vous permet de stocker et d’analyser des informations clés sur vos clients en dehors de Klaviyo.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Avant de commencer

Avant d’exporter des données depuis Klaviyo, configurez votre entrepôt de données comme destination :

• Assurez-vous que l’utilisateur proposé dans Klaviyo dispose des autorisations adéquates.
• Pour les destinations qui utilisent des tableaux, créez les tableaux avec les noms indiqués dans les instructions de configuration ci-dessous.

En outre, veillez à ajouter les adresses IP du trafic sortant de l’entrepôt de données de Klaviyo à la liste d’autorisation. Ainsi, les demandes de Klaviyo ne seront pas bloquées par votre couche de sécurité. Ces adresses sont représentées par les plages CIDR suivantes :

• 184.72.183.187/32
• 52.206.71.52/32
• 3.227.146.32/32
• 44.198.39.11/32
• 35.172.58.121/32
• 3.228.37.244/32
• 54.88.219.8/32
• 3.214.211.176/32

Se connecter à un entrepôt de données

1. Accédez à Gestion des données > Synchronisation. Si vous disposez déjà d’une connexion, cliquez sur Créer une synchronisation.
2. Sélectionnez Exporter les données vers votre entrepôt de données.
3. Sélectionnez votre entrepôt, puis cliquez sur Se connecter à [nom de l’entrepôt] sur sa page de configuration.

Vous pouvez également sélectionner votre entrepôt de données dans le marketplace d’applications de Klaviyo en accédant à Intégrations > Découvrir les applications et en recherchant votre plateforme.

L’option Importer des données depuis votre entrepôt de données configure une importation directe depuis l’entrepôt. Pour charger des fichiers CSV via SFTP, suivez la section suivante.

Importer des données via SFTP

Si vous souhaitez importer des données de votre entrepôt de données dans Klaviyo, vous pouvez le faire via SFTP. Pour une connexion directe à un entrepôt de données, consultez Comprendre l’importation depuis un entrepôt de données dans Klaviyo.

Accédez à Intégrations, ouvrez Gérer les données > Transfert de données SFTP, puis sélectionnez l’onglet Configuration SFTP.

Le processus d’importation des données de l’entrepôt dans Klaviyo est le suivant :

1. Exportez les données souhaitées de votre entrepôt de données.
2. Générez les clés SSH sur votre appareil.
3. Configurez le client SFTP et procédez à l’importation.

Exporter votre base de données

Tout d’abord, vous devez exporter les données de votre entrepôt. Connectez-vous à votre entrepôt et exportez les données que vous souhaitez importer vers Klaviyo dans un fichier CSV.

Générer des clés SSH sur votre appareil

Générez une nouvelle paire de clés SSH sur votre machine locale. Conservez la clé privée pour votre client SFTP.

1. Dans Configuration SFTP, cliquez sur Ajouter une clé SSH. Saisissez un Titre de la clé, puis collez votre clé publique dans clé SSH.
2. Cliquez sur Ajouter une clé.

Configurer le client SFTP et importer

Après avoir ajouté votre clé publique à Klaviyo, configurez votre client SFTP, puis téléversez votre fichier CSV.

1. Créez une connexion dans votre client SFTP à l’aide du serveur, du port, et du nom d’utilisateur affichés sous Identifiants SFTP dans Configuration SFTP. Authentifiez-vous avec la clé privée correspondante.
2. Avant de téléverser votre fichier, assurez-vous que votre fichier CSV respecte les recommandations de mise en forme indiquées ci-dessus.
3. Téléchargez le fichier CSV via votre client SFTP.

Pour vérifier l’importation, ouvrez l’onglet Importation de données dans Transfert de données SFTP. Importations récentes affiche :

• Statut
  En file d’attente, en cours de traitement, terminé, échoué ou annulé. Une importation terminée peut toujours contenir des erreurs.
• Lignes traitées
  Pourcentage du fichier traité jusqu’à présent. Développez une importation pour vérifier le nombre de lignes traitées et ignorées.
• Date d’importation
  Date de l’importation
• Importation par
  Utilisateur ayant importé les données

Exporter des données vers votre entrepôt 

Pour configurer votre entrepôt de données en tant que destination, vous aurez besoin de l’ensemble des informations et informations d’identification suivantes pour chaque entrepôt de données.

Amazon Redshift

Pour configurer Amazon Redshift en tant que destination, exécutez le script suivant afin de créer les tables klaviyo_event, klaviyo_profile et klaviyo_metric.

Demandez à votre administrateur de base de données d’adapter cet exemple avant de l’exécuter : remplacez les placeholders, corrigez le */ non apparié près du début, et exécutez les instructions GRANT spécifiques à chaque table après avoir créé les tables.

Ensuite, connectez votre entrepôt à Klaviyo à l’aide des informations d’identification suivantes :

• Nom : un nom pour identifier cette connexion. Vous pouvez utiliser le même nom que votre base de données dans Redshift.
• URL de l’hôte : point de terminaison du serveur Amazon Redshift (appelé URL de connexion dans Redshift)
• Base de données : Nom de la base de données Redshift à laquelle Klaviyo se connectera
• Port : numéro de port utilisé par Redshift
• Schéma : schéma de votre base de données
• Nom d’utilisateur : nom d’utilisateur permettant de se connecter à Redshift
• Mot de passe de la base de données : le mot de passe utilisé pour se connecter à Redshift
  

Amazon S3

Pour configurer Amazon S3 comme destination, munissez-vous du nom de votre compartiment, de la région du compartiment, ainsi que de vos identifiants d’accès AWS.

Ensuite, connectez votre entrepôt à Klaviyo à l’aide des informations d’identification suivantes :

• Nom : un nom permettant d’identifier cette connexion.
• Compartiment de stockage : nom du compartiment de stockage
• Emplacement du compartiment de stockage : nom de la zone géographique qui a été choisi lors de la création du compartiment de stockage
• Identifiant de clé d’accès : Votre identifiant de clé d’accès AWS.
• Clé d’accès secrète: votre clé d’accès secrète à AWS.
  

Google BigQuery

Pour configurer Google BigQuery en tant que destination, exécutez le script suivant afin de définir les tables klaviyo_profile, klaviyo_event et klaviyo_metric. Votre compte Google BigQuery doit disposer d’un profil de paiement pour que le processus de connexion fonctionne.

Notez que dans ce script, vous devez remplacer l’espace réservé « SERVICE ACCOUNT EMAIL » par l’e-mail de votre compte de service BigQuery.

Ensuite, connectez votre entrepôt à Klaviyo à l’aide des informations d’identification suivantes :

• Nom : Un nom pour vous aider à identifier cette destination
• Identifiant du projet : identifiant du projet que vous trouverez dans la console de votre API
• Ensemble de données : également connu sous le nom de schéma. Il doit s’agir du même nom que celui que vous avez utilisé dans le script que vous avez exécuté au moment de la configuration.
• Clé du compte de service : Collez tout le contenu du fichier JSON que vous avez téléchargé lors de la création de votre compte de service dans BigQuery.
  

Microsoft Azure Synapse Analytics

Pour configurer Microsoft Azure en tant que destination, exécutez le script suivant afin de créer les tables klaviyo_profile, klaviyo_event et klaviyo_metric. Demandez à votre administrateur de base de données d’adapter l’exemple avant de l’exécuter : il commence par des instructions DROP TABLE, y compris un DROP TABLE klaviyo_profile en double. Supprimez les instructions DROP TABLE lors de la création de nouvelles tables, ou si vous devez préserver les données existantes.

Ensuite, connectez votre entrepôt à Klaviyo à l’aide des informations d’identification suivantes :

• Nom : il est recommandé d’utiliser le même nom que votre base de données dans Azure.
• Espace de travail : nom de l’espace de travail Azure Synapse
• Nom de la base de données : nom identifiant votre base de données Dedicated SQL Pool
• Nom d’utilisateur : nom d’utilisateur permettant de vous connecter à votre base de données Dedicated SQL Pool.
• Mot de passe de la base de données : mot de passe permettant de vous connecter à votre base de données Dedicated SQL Pool
• Nom du compte : votre compte de stockage Windows Azure, ou le préfixe DNS que vous avez créé
• Signature d’accès : votre chaîne de signature d’accès partagé (SAS) prouvant l’accès au conteneur Stockage Blob
• Nom du conteneur : Nom du conteneur Azure Blob pour la zone de stockage temporaire pour le transfert de données.
  

Snowflake

Pour configurer Snowflake en tant que destination, suivez les étapes suivantes :

1. Générez une clé privée en exécutant la commande suivante dans votre terminal :

textCopy

openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

2. Générez une clé publique qui fait référence à la clé privée en exécutant la commande suivante dans votre terminal :

textCopy

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

3. Exécutez le script suivant pour définir les tables KLAVIYO_PROFILE, KLAVIYO_EVENT et KLAVIYO_METRIC. Vous devez disposer des privilèges securityadmin et sysadmin pour pouvoir terminer la configuration ci-dessous. Pour vérifier quels sont les rôles dont vous disposez, exécutez SHOW GRANTS TO USER <votre_nom_d’utilisateur> et assurez-vous que les deux rôles sont indiqués. Contactez un administrateur système si vous avez besoin de modifier votre rôle. Avant d’exécuter le script, remplacez ses espaces réservés SET_ par vos valeurs, et GENERATE_PUBLIC_KEY par la clé publique que vous avez générée. Le script utilise CREATE OR REPLACE TABLE, qui remplace toutes les tables existantes portant ces noms. Utilisez une nouvelle base de données ou demandez à votre administrateur d’adapter ces instructions si vous devez conserver les données existantes.

Ensuite, connectez votre entrepôt à Klaviyo à l’aide des informations d’identification suivantes :

• Nom : il est recommandé d’utiliser le même nom que votre base de données dans Snowflake.
• Nom d’utilisateur : nom d’utilisateur permettant de vous connecter à votre base de données. Il doit être identique au nom d’utilisateur dans le script de configuration.
  
• Clé privée : clé privée Snowflake générée.
  
• Entrepôt de données : votre entrepôt de données dans Snowflake.
• Compte : votre compte dans Snowflake
• Base de données : nom de votre base de données. Il doit être identique au nom de la base de données dans le script de configuration.
• Schéma : schéma de votre base de données. Il doit être identique à schema_name dans le script de configuration.
  

Databricks

Pour configurer Databricks en tant que destination, y compris le script de configuration, les autorisations requises et les identifiants de connexion, suivez les étapes décrites dans Comment exporter les données Klaviyo vers Databricks.

Si votre formulaire de connexion affiche une section Blob store, utilisez-la pour configurer le stockage de votre exportation. Pour les destinations d’entrepôt, ce stockage met les données en phase de préchargement avant de les charger dans l’entrepôt. Pour Amazon S3, il s’agit de la destination d’exportation.

1. Pour utiliser un magasin enregistré, sélectionnez Utiliser une configuration blob si elle s’affiche, puis choisissez un magasin Blob compatible. Si vous ne sélectionnez pas Utiliser une configuration blob, continuez avec les détails de connexion indiqués ci-dessus. Si Klaviyo exige un magasin blob, sélectionnez-en un avant de continuer.
2. Pour ajouter un magasin, choisissez Créer dans le menu déroulant Blob store. Sélectionnez un fournisseur si vous y êtes invité, saisissez ses informations de connexion, puis cliquez sur Créer.
3. Si un champ Nom de la configuration de stockage s’affiche, saisissez le nom de la configuration de stockage que vous avez créée dans votre entrepôt de données.
4. Pour une destination Amazon S3, choisissez un format de fichier et indiquez si vous souhaitez compresser les fichiers exportés si ces contrôles s’affichent.

Après avoir saisi vos informations de connexion, cliquez sur Suivant. Ensuite, choisissez les données et la planification de votre exportation.

Objets de données

Dans la section Objets de données, vous pouvez choisir de synchroniser toutes les données de profil, uniquement les données d’événements spécifiques ou les deux types de données en cochant la ou les cases applicables à côté de chaque option.

Intégrations à exclure

Dans le champ Intégrations à exclure, vous pouvez sélectionner une ou plusieurs intégrations spécifiques pour les exclure de la synchronisation de l’entrepôt de données. Cette option est utile si vous ne souhaitez pas synchroniser des données d’une intégration spécifique que vous avez déjà connectée à Klaviyo.

Synchronisation sélective

Dans le champ Synchronisation sélective , sélectionnez les événements spécifiques que vous souhaitez synchroniser vers votre entrepôt de données à partir de Klaviyo. Par défaut, tous les événements sont inclus. Si vous utilisez ce champ pour définir des événements spécifiques à synchroniser, seuls les événements sélectionnés seront synchronisés.

Sélection de la fréquence de synchronisation des données

Dans Sélectionner la fréquence de synchronisation de vos données, choisissez un intervalle dans Toutes les: 1, 2, 4, 6, 12 ou 24 heures. Définissez la date de début, l’heure de début et le fuseau horaire pour la planification.

Sélectionnez la quantité de données historiques à synchroniser

Dans la section Sélectionnez la quantité de données historiques à synchroniser , vous pouvez définir la quantité de données historiques que vous souhaitez synchroniser depuis Klaviyo vers votre entrepôt de données lors de la connexion initiale. Vous pouvez choisir :

• 30 jours
• 90 jours
• 1 an
• Depuis toujours

Examen de la synchronisation

Cliquez sur Suivant pour ouvrir Vérifier. Vérifiez les détails de connexion et les paramètres d’exportation, notamment :

• Détails de la synchronisation que vous avez configurée
• Détails des données partagées (profils, évènements ou les deux)
• Les intégrations exclues

Cliquez sur Connecter pour enregistrer la connexion et démarrer les synchronisations selon votre calendrier.

Si Klaviyo affiche Impossible de se connecter, cliquez sur Modifier les identifiants pour corriger les détails de connexion, puis revenez à Vérifier et cliquez à nouveau sur Connecter.

Une fois la connexion enregistrée, Klaviyo vous ramène à Synchronisation des données. Le tableau des connexions affiche :

• Entrepôt de données
• Type: importer ou exporter
• Date de création

Les destinations d’exportation et les connexions d’importation directe apparaissent dans le même tableau. Cochez Type pour les distinguer.

Tableau de bord de synchronisation des données

Une fois la connexion établie, cliquez sur votre intégration dans la page contenant la liste Synchronisation des données. Vous accéderez alors au tableau de bord de la synchronisation des données, qui fournit des informations historiques et actuelles sur les synchronisations effectuées.

Vous y trouverez les informations de synchronisation réparties en deux onglets :

• Historique
• Périodique

Historique

L’onglet Historique contient des journaux qui indiquent le statut des synchronisations des données historiques. Les synchronisations historiques font référence à la synchronisation de vos données existantes de Klaviyo vers votre entrepôt de données lorsque vous établissez une connexion.

Les informations suivantes s’affichent pour chaque synchronisation :

• Nom
  Les données incluses dans la synchronisation.
• Statut
  Statut et progression potentielle de la synchronisation avec une estimation du pourcentage ou des erreurs relevées. Ces statuts peuvent être les suivants :
  
  
  • Terminée
    La synchronisation ponctuelle de vos données est terminée. Celles-ci ne seront pas resynchronisées automatiquement.
  • Programmée
    Date programmée de la prochaine synchronisation automatique.
  • Synchronisation
    Les données sont en cours de synchronisation vers votre entrepôt de données, avec un pourcentage estimé d’achèvement.
  • Erreur
    Une erreur s’est produite, mais Klaviyo tentera de rétablir la connexion. Ce calendrier peut légèrement varier en fonction de l’intégration.
  • Échec
    La synchronisation a complètement échoué, même après avoir tenté de rétablir la connexion. Cela signifie que vous devrez revoir vos paramètres de configuration, et peut-être la configuration de votre entrepôt de données. Après avoir résolu le problème, cliquez sur Réactiver pour la synchronisation.
  • En pause
    Vous avez interrompu la synchronisation manuellement.
  • Annulée
    La synchronisation a été annulée et n’est plus planifiée.
• Date de début
  Date de début de la synchronisation
• Date de fin
  Date de fin de la synchronisation

Périodique

L’onglet Périodique indique le statut des synchronisations en cours. Au fur et à mesure que les clients continuent d’interagir avec votre marque et que de nouvelles données sont créées, elles sont envoyées à votre entrepôt de données selon la planification que vous avez sélectionnée. Une fois chaque exécution terminée, Klaviyo planifie l’exécution suivante.

Les informations suivantes s’affichent pour chaque synchronisation :

• Nom
  Les données incluses dans la synchronisation.
• Statut
  Le statut actuel de la synchronisation et les éventuelles erreurs. Ces statuts peuvent être les suivants :
  
  
  • Planifié
    La synchronisation attend sa prochaine exécution planifiée.
  • Synchronisation
    Les données se synchronisent activement avec votre entrepôt de données.
  • Erreur
    Une erreur s’est produite, mais Klaviyo tentera de rétablir la connexion. Ce calendrier peut légèrement varier en fonction de l’intégration.
  • Échec
    La synchronisation a complètement échoué, même après avoir tenté de rétablir la connexion. Cela signifie que vous devrez revoir vos paramètres de configuration, et peut-être la configuration de votre entrepôt de données. Après avoir résolu le problème, cliquez sur Réactiver pour la synchronisation.
  • En pause
    Vous avez interrompu la synchronisation manuellement.
  • Annulée
    La synchronisation a été annulée et n’est plus planifiée.
• Actualisation des données
  Niveau d’actualisation de vos données. Par exemple, une actualisation de 2 minutes indique que la synchronisation a traité les données jusqu’à environ 2 minutes auparavant. Les données plus récentes peuvent encore être en attente de synchronisation.
• Boutons permettant de Mettre en pause, Reprendre et réactiver des synchronisations individuelles.

Suppression des connexions à l’entrepôt de données

1. Accédez à Intégrations.
2. Ouvrez le menu à côté de l’intégration de votre entrepôt de données et sélectionnez Supprimer l’intégration. Dans la boîte de dialogue de confirmation, cliquez de nouveau sur Supprimer l’intégration.

Consulter les journaux d’erreurs

En cas de problèmes de synchronisation des données entre Klaviyo et votre entrepôt de données, les journaux d’erreurs associés peuvent fournir des informations supplémentaires sur la cause du problème.

Pour consulter les erreurs, cliquez sur la destination de l’entrepôt de données dans la page Synchronisation. Dans les onglets Historique et Périodique de la synchronisation, vous trouverez une liste des exportations et de leur état, ainsi qu’un indicateur montrant toute erreur active.

Pour afficher plus de détails sur une erreur particulière, cliquez sur l’exportation qui rencontre l’échec.

Vous y trouverez une chronologie des synchronisations sortantes, ainsi qu’un message d’erreur ou de réussite en fonction de l’état de la synchronisation.

En cliquant sur une erreur spécifique, vous ouvrirez un tiroir contenant les informations suivantes :

• Description
  Brève description de l’erreur renvoyée par l’entrepôt de données
• Code
  Code de l’erreur pour l’erreur
• Message externe
  Message d’erreur réel renvoyé par l’entrepôt de données
• Date
  Date et heure de l’erreur

Ressources supplémentaires