Comment importer manuellement des données historiques

Objectif de cet article

Découvrez comment importer manuellement des données d'événements historiques dans Klaviyo. Nous vous recommandons d'utiliser les intégrations conçues par Klaviyo avec des plateformes telles que Shopify, Magento et BigCommerce, ainsi que notre API pour les intégrations personnalisées, mais il est également possible d'ajouter ces données manuellement. Un exemple courant est l'ajout de données d'achat historiques provenant d'une ancienne plateforme de commerce électronique pour laquelle Klaviyo ne dispose pas d'une intégration prédéfinie.

Veuillez noter que les téléchargements de fichiers CSV sont limités à 50 Mo. 

Formatez 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 relatives à une commande passée, ainsi qu'une description des champs ci-dessous. Chaque ligne de votre fichier CSV doit représenter une action ou une activité réalisée par une personne. Par exemple, "a acheté le produit" ou "s'est inscrit à un webinaire." Si vous avez plusieurs actions à suivre, vous devez les télécharger sous forme de fichiers CSV distincts. L'adresse électronique doit figurer en premier lorsque vous téléchargez votre fichier CSV.

Voici quelques exemples de fichiers CSV d'événements auxquels vous pouvez vous référer pour formater vos données.

Champs obligatoires

Les deux champs obligatoires sont un horodatage pour identifier le moment où l'événement s'est produit, et une propriété du client (un courriel ou un identifiant unique) pour identifier la personne 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, 13h30 le 14 novembre 2012 serait : 2012-11-14 13:30:00.

  Si deux événements ou plus de votre fichier CSV ont le même horodatage, vous devez inclure un $event_id unique, sinon un seul des événements sera importé et les autres seront ignorés. Voir la section sur $event_id ci-dessous.

• Personne//email ou Personne//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 deux champs spéciaux à prendre en compte.

• $event_id: Il s'agit d'un identifiant unique pour l'événement. En pratique, vous devriez envoyer un $event_id si vous avez un identifiant unique pour chaque événement, par exemple un identifiant de commande. Vous devez également définir l'identifiant $event_id si vous souhaitez que certains événements se produisent au même moment. Cela peut se produire lorsque quelqu'un entreprend une action que vous diviserez en plusieurs événements. Par exemple, si une personne achète plusieurs articles et que vous souhaitez enregistrer un événement pour chaque article acheté.
  
  Dans les deux exemples de données ci-dessous, il y a un événement de commande passée, ainsi que trois événements de produits commandés (un pour chaque produit de la commande passée). Tous ces événements ont le même horodatage, mais ils seront tous importés parce qu'ils ont chacun un $event_id unique. Si les $event_ids sont identiques ou s'ils sont absents, un seul des événements sera importé et les autres seront ignorés.
  
• $value: Utilisez ce champ si l'événement que vous importez comporte une valeur. Par exemple, si vous importez les données d'un événement "Commande passée", chaque commande aura une valeur. Il n'est pas nécessaire de faire précéder vos valeurs d'un $ ou d'un autre symbole monétaire.

Si vous avez des données supplémentaires sur la personne qui a fait quelque chose, elles doivent être placées dans une colonne dont l'intitulé commence par Personne// et ensuite le type de données de cette colonne. Par exemple, si vous disposez de l'entreprise ou de l'organisation à laquelle appartient chaque personne, vous voudrez intituler cette colonne Personne/Organisation. Le préfixe spécial nous indique qu'il faut associer les données de cette colonne à chaque personne plutôt qu'à l'activité. Les colonnes suivantes sont des colonnes spéciales que vous pouvez utiliser pour vous aider à identifier les personnes :

• Personne//Prénom: prénom
• Personne//Nom de famille: nom de famille
• Personne//téléphone: numéro de téléphone
• Personne/Organisation: organisation
• Personne//titre: titre du poste

Si vous disposez de données supplémentaires sur chaque action, vous pouvez les inclure dans des colonnes supplémentaires avec les étiquettes de votre choix. Par exemple, si une personne achète quelque chose et que vous souhaitez connaître l'article qu'elle a acheté, vous pouvez inclure ces données dans une colonne intitulée Article acheté. Vous trouverez ci-dessous quelques exemples.

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

Si vous n'avez pas de données pour une colonne particulière, laissez-la vide et nous l'ignorerons. Par exemple, si vous ne connaissez pas l'organisation d'une personne, vous pouvez laisser la colonne Personne/Organisation vide et nous ne suivrons pas cette propriété pour cette ligne de vos données.

Une fois le formatage de vos données terminé, enregistrez-les dans un fichier CSV.

Téléchargez un fichier de données CSV

Une fois vos données correctement formatées, rendez-vous sur Klaviyo et cliquez sur votre nom de compte en bas à gauche, puis sélectionnez Intégrations > Gérer les sources > Importer via CSV.

Vous serez invité à télécharger votre fichier CSV, puis à cliquer sur Suivant.

Ensuite, vous aurez la possibilité de nommer l'événement. Si vous essayez de mapper les données importées à un indicateur d'événement qui existe déjà dans votre compte, assurez-vous de taper le nom de l'événement exactement comme il apparaît déjà.

Une fois que vous avez nommé votre événement, vous pouvez prévisualiser vos données ci-dessous. Lorsque vous êtes prêt à importer vos données, cliquez sur Suivant. Le traitement de votre fichier commence et vous pouvez quitter la page. 

Note à l'attention des boutiques de commerce électronique qui chargent les données d'achat

Si vous téléchargez des données d'achat, vous devrez télécharger deux fichiers, l'un pour la commande globale et l'autre pour les données article par article.  Par exemple, un client peut passer une commande pour plusieurs produits. Dans ce cas, il y aurait un événement pour la commande passée, puis des événements distincts pour chacun des produits commandés. Voici à quoi devraient ressembler les en-têtes de ces fichiers :

Commande passée

Produit commandé

Nous n'utilisons pas le $ pour préfixer les valeurs des commandes. Utilisez uniquement des chiffres pour indiquer le prix ou la valeur d'une commande. L'utilisation de l'en-tête $value permet de renseigner 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 relatifs aux produits commandés, $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'identifiant de la commande et l'identifiant du produit, comme dans l'exemple ci-dessus.

dépannage de l'importateur

Vous trouverez ci-dessous quelques problèmes courants et leurs solutions lors de l'importation manuelle de données d'événements historiques.

Mon importateur prend beaucoup de temps

Les importations peuvent prendre entre 5 minutes et 24 heures en fonction de la taille de votre liste. Nous vous recommandons vivement de commencer l'importation d'une liste au moins 24 heures avant d'en avoir besoin pour une campagne donnée afin de vous assurer que le processus d'importation n'entrave pas votre envoi.

Mon importateur échoue sans cesse

Si votre importation échoue, c'est probablement pour l'une des raisons suivantes :

• Votre fichier est-il un fichier .csv ? Votre fichier doit être au format .csv format. Si vous tentez de télécharger un fichier Excel ou un fichier .txt l'importation échouera.
• Avez-vous formaté correctement votre colonne Horodatage ? Vous devez formater la date et l'heure en AAAA-MM-JJ HH:MM:SS. Par exemple, 13h30 le 14 novembre serait : 2012-11-14 13:30:00. En guise de deuxième vérification, ouvrez votre fichier CSV dans un éditeur de texte pour vous assurer que les 0 de fin de vos horodatages ne sont pas supprimés lors de l'enregistrement ou de l'exportation de vos fichiers CSV. Si vous travaillez avec des données dans une feuille de calcul, assurez-vous que les cellules Horodatage sont définies au bon format d'horodatage.
  
• Les données de toutes les colonnes obligatoires sont-elles renseignées pour chaque ligne ? Vous devez avoir une colonne intitulée Personne/Email ou Personne//ID .Si l'une de ces colonnes contient une ligne vide, l'importation peut échouer.
• Votre colonne Personne/Email contient-elle des adresses électroniques non valides ? Si vous avez des valeurs dans le champ Person//Email qui n'ont pas un format d'adresse électronique valide, cela peut faire échouer votre importation.
• Toutes vos colonnes sont-elles correctement étiquetées ? Y a-t-il des espaces ? Veillez à ce que tous les en-têtes de vos colonnes correspondent à ce qui est décrit dans ce guide. Veillez également à ce qu'il n'y ait pas d'espace dans les noms de colonnes.

Ressources complémentaires

• Formats de date et d'horodatage acceptables pour les propriétés des profils et des événements
• Comment formater les dates dans les fichiers CSV
• Migrer vers Klaviyo