Comment importer manuellement des données d’événements historiques

Objectif de cet article

Découvrez comment importer manuellement des données d’événements historiques dans Klaviyo. Bien que nous recommandions d’utiliser des intégrations créées par Klaviyo avec des plateformes comme Shopify, Magento et BigCommerce, ainsi que notre API pour des intégrations personnalisées, il est également possible d’ajouter ces données manuellement. Un exemple courant consiste à ajouter des données d’achat historiques provenant d’une précédente plateforme d’e-commerce pour laquelle Klaviyo ne dispose pas d’une intégration préconfigurée.

Veuillez noter qu’il existe une limite de 50 Mo pour les importations de fichiers CSV.

Formater vos données

La première étape consiste à formater correctement vos données dans un fichier CSV. Vous trouverez ci-dessous un exemple de données d’événement Placed Order, accompagné d’une description des champs ci-dessous. Chaque ligne de votre fichier CSV doit représenter une action ou une activité effectuée par une personne, comme « Produit acheté » ou « Inscription à un webinaire ». Si vous avez plusieurs actions à suivre, vous devez les importer sous forme de fichiers CSV distincts. L’adresse e-mail doit être en premier lorsque vous importez votre CSV.

Voici quelques exemples de CSV d’événements auxquels vous pouvez vous référer lorsque vous mettez vos données en forme.

Champs obligatoires

Les 2 champs obligatoires sont un horodatage pour identifier quand l’événement s’est produit, et une propriété client (une adresse e-mail ou un identifiant unique) pour identifier qui a effectué l’action.

• Horodatage: un horodatage indiquant le jour et l’heure de l’événement. Le format est AAAA-MM+-JJ HH:MM+:SS. Par exemple, 13 h 30 le 14 novembre 2012 serait : 2012-11-14 13:30:00.

• Person//Email ou Person//ID: vous utiliserez très probablement un e-mail pour identifier vos clients. Certains clients utiliseront également un identifiant unique. Vous pouvez utiliser les deux si vous le souhaitez.

Champs facultatifs

Il y a 2 champs spéciaux à noter.

• $event_id: il s’agit d’un identifiant unique de l’événement. En pratique, vous devez envoyer un $event_id si vous disposez d’un identifiant unique pour chaque événement (par exemple, un ID de commande). Vous devez également définir le $event_id si vous vous attendez à ce que certains événements se produisent au même moment. Cela peut arriver lorsque quelqu’un effectue une action que vous allez répartir en plusieurs événements. Par exemple, si une personne achète plusieurs articles, vous pouvez vouloir enregistrer 1 événement pour chaque article acheté.
  
  Dans les 2 exemples d’ensembles de données ci-dessous, il y a 1 évènement de commande passée, ainsi que 3 évènements de produit commandé (1 pour chaque produit dans la commande passée). Tous ces évènements ont le même horodatage, mais ils seront tous importés, car ils ont chacun un $event_id unique. Si les $event_ids étaient identiques, ou s’ils étaient absents, alors un seul des événements serait importé et les autres seraient ignorés.
  

• $value: utilisez ce champ si l’événement que vous importez comprend une valeur. Par exemple, si vous importez les données d’événements Commande passée, chaque commande aura une valeur. Vous n’avez pas besoin de faire précéder vos valeurs d’un $ ou d’un autre symbole de devise.

Si vous disposez de données supplémentaires sur la personne qui a effectué une action, elles doivent se trouver dans une colonne dont l’étiquette commence par Person//, puis indique le type de données contenu dans cette colonne. Par exemple, si vous aviez l’entreprise ou l’organisation à laquelle appartient chaque personne, vous devriez étiqueter cette colonne Person//Organization. Le préfixe spécial nous indique que nous devons associer les données de cette colonne à chaque personne, plutôt qu’à l’activité. Voici des colonnes spéciales que vous pouvez utiliser pour vous aider à identifier les personnes :

• Person//Prénom: prénom
• Person//Last Name: nom
• Person//Phone: numéro de téléphone
• Personne//Organisation: organisation
• Personne//Titre: intitulé du poste

Si vous disposez de données supplémentaires sur chaque action, vous pouvez les inclure dans des colonnes supplémentaires avec les libellés de votre choix. Par exemple, si une personne achète quelque chose et que vous souhaitez inclure l’article qu’elle a acheté, vous pouvez inclure ces données dans une colonne intitulée Article acheté. Voici quelques exemples.

• Article acheté
• Catégorie d’article
• Produit
• Localisation

Si vous n’avez pas de données pour une colonne en particulier, laissez-la vide et nous l’ignorerons. Par exemple, si vous ne connaissez pas l’organisation d’une personne, vous pouvez laisser la colonne Person//Organization vide et nous ignorerons le tracking de cette propriété pour cette ligne dans vos données.

Une fois que vous avez terminé de mettre en forme vos données, enregistrez-les dans un fichier CSV.

Importer un fichier CSV de données

Une fois vos données correctement mises en forme, rendez-vous sur Klaviyo.

1. Dans Klaviyo, sélectionnez l’onglet Intégrations.
2. Sélectionnez Gérer les données > Importer via CSV.
3. Vous serez invité à importer votre fichier CSV, puis cliquez sur Suivant.
4. Vous aurez la possibilité de nommer l’événement. Si vous essayez d’associer les données importées à un indicateur d’événement qui existe déjà dans votre compte, veillez à saisir le nom de l’événement exactement tel qu’il apparaît déjà.

5. Une fois que vous avez nommé votre événement, vous pouvez prévisualiser vos données ci-dessous.
6. Lorsque vous êtes prêt à importer vos données, cliquez sur Suivant. Votre fichier commencera à être traité, et vous pourrez quitter la page.

Remarque pour les boutiques e-commerce qui chargent des données d’achat

Si vous importez des données d’achat, vous devrez importer deux fichiers : un pour la commande globale et un deuxième qui inclut des données article par article.  Par exemple, un client peut passer une commande pour plusieurs produits. Dans ce cas, il y aurait 1 évènement pour Placed Order, puis des évènements distincts pour chacun des produits commandés. Voici à quoi devraient généralement ressembler les en-têtes de ces fichiers :

Commande passée

Produit Commandé

Nous n’utilisons pas le $ pour préfixer les valeurs de commande. Utilisez uniquement des chiffres pour indiquer le prix ou la valeur d’une commande. L’utilisation de l’en-tête $value renseignera correctement les données dans votre compte Klaviyo.

La raison d'inclure deux mesures est qu'il est plus facile de déclencher ultérieurement des e-mails à partir d'une commande globale et de catégories ou d'articles spécifiques.

Pour les événements Ordered Product, $event_id doit être un identifiant unique pour chaque combinaison de la commande et du produit commandé. Un moyen simple de créer un identifiant unique consiste à combiner l’ID de commande et l’ID de produit, comme dans l’exemple ci-dessus.

Dépannage de l’importation

Vous trouverez ci-dessous quelques problèmes courants et des résolutions que vous pourriez rencontrer lors de l’importation manuelle des données d’événements historiques.

Mon importation prend beaucoup de temps

Les importations peuvent prendre entre 5 minutes et 24 heures, selon la taille de votre liste. Nous vous recommandons vivement de commencer l’importation de toute liste au moins 24 heures avant d’en avoir besoin pour une campagne donnée, afin de garantir que le processus d’importation ne retarde pas votre envoi.

Mon importation échoue sans cesse

Si votre importation échoue, cela est probablement dû à l’une des raisons suivantes :

• Votre fichier est-il un fichier .csv ? Votre fichier doit être au format .csv . Si vous essayez de télécharger un fichier Excel ou un fichier .txt, l’importation échouera.
• Avez-vous correctement mis en forme votre colonne Timestamp ? Vous devez mettre en forme la date et l’heure au format YYYY-MM-DD HH:MM:SS. Par exemple, 13:30 le 14 novembre serait : 2012-11-14 13:30:00. Comme deuxième vérification, ouvrez votre CSV dans un éditeur de texte afin de vous assurer que les 0 finaux dans vos horodatages ne sont pas supprimés lorsque vous enregistrez ou exportez vos fichiers CSV. Si vous travaillez avec des données dans une feuille de calcul, assurez-vous que les cellules Timestamp sont définies sur le bon format d’horodatage.
  

• Toutes les colonnes obligatoires ont-elles des données renseignées pour chaque ligne ? Vous devez avoir une colonne intitulée Person//Email ou Person//ID. Si l’une de ces colonnes comporte une ligne vide, cela peut entraîner l’échec de votre importation.
• Votre colonne Person//Email contient-elle des adresses e-mail non valides ? Si vous avez des valeurs dans Person//Email qui n’ont pas un format d’adresse e-mail valide, cela peut entraîner l’échec de votre importation.
• Toutes vos colonnes sont-elles correctement libellées ? Y a-t-il des espaces ? Assurez-vous que tous les en-têtes de vos colonnes correspondent à ce qui est décrit dans ce guide. Vous devez également vous assurer qu’il n’y a aucun espace dans les noms de vos colonnes.