Résolution des problèmes liés à l’importation de listes

Objectif de cet article

Découvrez comment résoudre les erreurs qui se produisent lors du chargement d’un CSV de contacts vers une liste nouvelle ou existante dans Klaviyo. Vous téléchargez des avis ? Consultez notre article sur la procédure d’importation des avis.

Avant de commencer

Vous voulez vous assurer que votre fichier s’importera ? Vérifiez la liste des exigences ci-dessous avant d’importer votre liste.

• Fichier CSV (aucun autre format)
• La taille du fichier est de 50 Mo ou moins
• La première ligne correspond aux en-têtes
• Chaque ligne est associée à une adresse e-mail ou à un numéro de téléphone
• Il n’y a pas d’adresses e-mail ou de numéros de téléphone en double

Notre équipe d’assistance ne peut pas importer des fichiers CSV dans Klaviyo pour vous. Si vous avez besoin d’aide pour une importation, consultez la section de dépannage ci-dessous pour obtenir des conseils sur la manière de résoudre efficacement les problèmes d’importation de liste.

Table des matières

• Délai d’importation
• Dépannage de l’importation
• Toutes les colonnes importées sous forme d’un seul champ
• Messages d’erreur de format non valide
• Format de date ou d’horodatage incorrect
• Messages d’erreur liés à un identifiant unique en double ou manquant
• Valeur manquante dans un champ obligatoire
• Problèmes de formatage du numéro de téléphone

Délai d’importation

Si vous importez un fichier volumineux contenant une grande quantité de données, le processus d'importation peut durer plusieurs heures. Malheureusement, il n'existe aucun moyen d'accélérer ce processus une fois qu'il a commencé. Cependant, une façon d'accélérer le processus d'importation est de supprimer tous les doublons de votre CSV avant l'importation. Nous vous recommandons vivement de prévoir l'importation d'une nouvelle liste au moins un jour avant la date à laquelle vous avez l'intention d'envoyer des e-mails aux contacts de la liste.

Après le début d’une importation, vous verrez d’abord une barre d’état. Si vous cliquez ailleurs, vous pourrez tout de même suivre la progression de l’importation en regardant le nombre d’éléments de la liste augmenter au fil du temps. Nous vous enverrons un e-mail dès qu’une importation de liste sera terminée.

Dépannage de l’importation

Si votre liste ne parvient pas à se charger, recherchez les erreurs courantes suivantes dans votre fichier CSV, qui pourraient être à l’origine de ce blocage :

Toutes les colonnes importées sous forme d’un seul champ

Si vous utilisez une version d’Excel qui n’utilise pas l’anglais comme langue par défaut, votre logiciel peut utiliser des points-virgules et non des virgules comme séparateur dans votre fichier. Si c’est le cas, votre fichier peut ressembler à ceci lors de l’importation :

Pour résoudre ce problème, accédez au paramètre Format des nombres ou Séparateur de liste (ou de nombres) de votre ordinateur. Ce paramètre se trouve probablement dans les paramètres Langue et région et peut se situer dans la section Paramètres avancés. Remplacez le point-virgule par une virgule et enregistrez. Désormais, lorsque vous exportez des fichiers au format CSV, ils utiliseront le format avec virgule. Notez que l’emplacement exact de ce paramètre peut varier selon les systèmes d’exploitation.

Vérifiez également que votre CSV est conforme aux exigences de formatage de Klaviyo. Si ce n’est pas déjà fait, consultez notre documentation sur le formatage de vos données. Par exemple, l’un des champs requis concerne les adresses e-mail.

Résolution des messages d’erreur de format non valide

Lorsque vous importez une liste dans Klaviyo, la page de mappage des champs vous permet d’associer toutes les propriétés à leur type de données correspondant dans Klaviyo. Par exemple, E-mail a toujours un type de données Texte ; en revanche, si vous chargez une propriété personnalisée pour Anniversaire, vous devrez définir le type de données sur Date.

Consultez les types de données, les formats acceptés et les exemples ci-dessous.

• Texte
  Tout texte ou toute combinaison de texte et de chiffres. Si vous n’êtes pas sûr du format de vos données, choisissez cette option.
  • Exemples :
    email@example.com
    Bonjour, monde
    5,00 $
• Numérique
  Tous les chiffres. N’incluez pas de symboles de devise dans les champs numériques.
  • Exemples :
    2
    5,0031
    130,0
• Booléen
  Valeurs vrai ou faux.
  • Exemples :
    true
    false
• Date
  Consultez notre guide sur les formats de date et d’heure acceptés pour les propriétés des profils et des événements afin d’en savoir plus sur les formats de date acceptés.
  • Exemple :
    2014-09-01 13:34:08
• Liste
  Les données doivent être formatées sous forme de tableau JSON.
  • Exemples :
    ["apples","bananas","oranges"]
    ["apples"]
• Consentement
  Le consentement est au format canal (e-mail, SMS, etc.) et type de consentement (s’il existe plusieurs types disponibles dans Klaviyo). La seule option pour l’e-mail est Consentement au marketing par e-mail; pour les SMS, ce serait soit Consentement au marketing par SMS , soit Consentement aux SMS transactionnels; etc. La valeur de ce champ doit être « Subscribe », « Never Subscribed » ou « Unsubscribed ». 

Pour en savoir plus sur ce qu’impliquent les différents types de données et sur ceux à sélectionner lors de l’importation de votre liste, consultez notre guide sur la compréhension des types de données.

Pour en savoir plus sur les messages d’erreur « Invalid [data type] format » (p. ex., « Invalid list format »), consultez notre guide de dépannage des messages d’erreur de format invalide.

Format de date ou d’horodatage incorrect

Il est possible que vous utilisiez le mauvais format pour les dates ou les horodatages. Si vous avez inclus l’un ou l’autre et que vous n’êtes pas sûr des formats acceptés par Klaviyo, consultez notre guide sur les formats de date et d’horodatage acceptables pour les propriétés de profil et d’événement.

Résolution des messages d’erreur d’identifiant unique en double ou manquant

Identifiants en double

Les enregistrements ignorés en raison de « Duplicate Unique ID » signifient qu’une adresse e-mail ou un numéro de téléphone a été répété dans votre fichier. Dans ce cas, Klaviyo traitera les données de la première ligne contenant l’identifiant répété et fournira tous les enregistrements non traités dans un fichier téléchargeable.

Cliquez sur Télécharger les enregistrements ignorés pour voir les contacts ignorés en raison d’identifiants en double et charger à nouveau ces enregistrements ignorés si nécessaire.

Identifiants uniques manquants

Les enregistrements ignorés en raison de « Missing Unique ID » signifient que les lignes ignorées ne contenaient pas d’adresse e-mail, de numéro de téléphone ou d’autre identifiant unique accepté.

Cliquez sur Télécharger les enregistrements ignorés pour voir les contacts ignorés en raison d’identifiants manquants, ajouter une adresse e-mail ou un numéro de téléphone pour chacun, puis téléverser à nouveau votre nouveau fichier.

Valeur manquante dans un champ obligatoire

Vérifiez que tous les champs obligatoires ont des valeurs qui leur sont associées. Par exemple, si l’un des contacts répertoriés n’a pas d’adresse e-mail dans la colonne e-mail, une erreur s’affichera lors de l’importation. Vérifiez que chaque contact que vous souhaitez importer dispose d’une valeur pour tous les champs obligatoires. S’ils sont vides, renseignez-les avant votre prochaine tentative d’importation.

Adresse e-mail non valide ou caractères non reconnus

Si vous recevez ce message d’erreur, vérifiez les adresses e-mail dans votre fichier afin de repérer les caractères non valides. Les caractères non valides incluent ( ) , : ; [ / ], ainsi que les espaces.

Transfert de profils entre comptes

Lors du transfert de profils d’un compte à un autre, certaines propriétés ne peuvent pas être importées dans un autre compte.

Par exemple, Profil créé le ne peut pas être transféré, car il est défini sur la date à laquelle un profil est créé dans le compte. Un autre ensemble d’exemples est First Active et Last Active, car ceux-ci sont définis automatiquement en fonction de l’activité du profil sur le compte.

Problèmes de formatage du numéro de téléphone

Les numéros de téléphone doivent inclure un indicatif de pays ou une colonne distincte indiquant leur pays, et doivent respecter un format de numéro de téléphone accepté. Découvrez comment formater et importer correctement des numéros de téléphone.

Ressources supplémentaires