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 profilage client et les données d’événement pour stocker et analyser des informations clés sur vos clients en dehors de Klaviyo. 

Avant de commencer

Vérifiez que l’entrepôt de données auquel vous vous connectez est configuré en tant que destination. Pour vous assurer que vous avez correctement configuré le système :

• Assurez-vous que l’utilisateur proposé dans Klaviyo dispose des autorisations suffisantes.
• Définissez les tables en leur attribuant les noms appropriés, indiqués ci-dessous, en fonction de votre entrepôt.

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 

Pour ajouter une connexion d’entrepôt de données à Klaviyo, accédez à Gestion des données > Synchronisation.

1. Pour ajouter un entrepôt de données, cliquez sur le bouton Nouvelle connexion. 
2. Dans la fenêtre modale Sélection de la destination, sélectionnez un entrepôt de données pris en charge pour le connecter à Klaviyo.

Vous pouvez également sélectionner votre entrepôt de données dans le répertoire d’intégration de Klaviyo en accédant à Compte > Intégration.

Lorsque vous connectez un entrepôt, vous pouvez soit importer des données de votre entrepôt de données vers Klaviyo, soit définir un entrepôt comme destination de synchronisation sortante.

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 importer vos données dans Klaviyo, sélectionnez Importer des données lors de la première connexion à une destination d’entrepôt, ou cliquez sur le bouton Importer sur la page Synchronisation des données si vous avez déjà établi une connexion.

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

Une fois que vous avez exporté les données souhaitées de votre entrepôt, générez une nouvelle clé SSH sur votre appareil et ajoutez-la à Klaviyo en sélectionnant le bouton Ajouter une clé SSH.

Configurer le client SFTP et importer

Une fois que votre clé SSH a été ajoutée à Klaviyo, vous devez configurer votre client SFTP et importer les données.

1. Ouvrez votre client SFTP et configurez une nouvelle connexion avec les informations d’identification présentées dans Klaviyo. Les informations d’identification s’afficheront après l’ajout réussi de la clé SSH.
2. Une fois la base de données authentifiée, assurez-vous qu’elle respecte les recommandations avant de procéder à l’importation.
3. Téléchargez votre fichier de base de données via votre client SFTP et révisez-le.

La liste de vos importations récentes s’affichera également et présentera les informations suivantes :

• Statut
  Terminée ou Incomplète
• Lignes traitées
  Pourcentage du nombre total de lignes traitées jusqu’à présent
• 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 données et informations d’identification suivantes pour chaque entrepôt de données.

Après avoir saisi les informations d’identification de l’entrepôt de données que vous utilisez pour effectuer la synchronisation, choisissez les données que vous souhaitez synchroniser à partir de Klaviyo. 

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

La valeur définie pour le champ Cadence de synchronisation périodique dans la section intitulée Sélectionnez la fréquence de synchronisation de vos données définit la fréquence de synchronisation de Klaviyo vers votre entrepôt de données. 

Sélection de 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

Une fois que vous avez connecté votre intégration, si la configuration a réussi, vous verrez un écran final indiquant que la connexion est Activée, ainsi que ces informations : 

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

Si la connexion de votre synchronisation a échoué, vous verrez à la place le statut Impossible de se connecter, ainsi que les options permettant de retenter la connexion ou de modifier les informations de vos données d’identification.

Une fois que vous avez réussi à connecter votre entrepôt de données, la page principale de la liste Synchronisation des données s’affiche à nouveau. Elle indique :

• La destination de l’entrepôt 
• Le statut Activée
• Toute erreur ayant pu se produire lors de la synchronisation au cours des dernières 24 heures
• La dernière synchronisation et son horodatage

Comme vous ne pourrez connecter qu’une seule destination, vous ne verrez qu’une seule destination dans cette liste.

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
  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.
  • En cours
    Les données sont en cours de synchronisation vers votre entrepôt de données et un pourcentage estimé d’achèvement apparaît.
  • 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.
  • En pause
    Vous avez interrompu la synchronisation manuellement.
  • Désactivée
    La synchronisation a été désactivée parce que l’intégration elle-même a été désactivée ou supprimé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 contient des journaux qui indiquent le statut de vos synchronisations périodiques. Au fur et à mesure que les clients interagissent avec votre marque et que de nouvelles données sont créées, elles sont régulièrement envoyées à votre entrepôt de données. Lors de l’établissement d’une connexion à un entrepôt de données, des synchronisations périodiques se produiront toutes les heures. 

Les informations suivantes s’affichent pour chaque synchronisation : 

• Nom
  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.
  • En cours
    Les données sont en cours de synchronisation vers votre entrepôt de données et un pourcentage estimé d’achèvement apparaît.
  • 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.
  • En pause
    Vous avez interrompu la synchronisation manuellement.
  • Désactivée
    La synchronisation a été désactivée parce que l’intégration elle-même a été désactivée ou supprimée.
• Actualisation des données
  Niveau d’actualisation de vos données. Par exemple, si cette section indique 2 minutes, cela signifie que toutes les nouvelles données créées dans Klaviyo au cours des 2 dernières minutes ne sont pas encore dans votre entrepôt de données. 
• Boutons permettant de Mettre en pause, Reprendre et réactiver des synchronisations individuelles.

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

Pour supprimer la connexion d’un entrepôt de données de votre compte Klaviyo, accédez à la page Intégrations dans Klaviyo à partir du menu du compte dans le coin inférieur gauche. 

Sur la page Intégrations, ouvrez le menu à côté de l’intégration de votre entrepôt de données et sélectionnez Supprimer l’intégration pour supprimer la connexion.

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 obtenir plus de détails sur une erreur particulière, cliquez sur l’exportation en question. 

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 :

• Résumé
  Brève description de l’erreur renvoyée par l’entrepôt de données 
• Code
  Code de 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 

Comprendre les échanges d’informations entre Klaviyo et les applications

Comprendre les types d’informations échangées entre Klaviyo et les applications