Cet article vous guide pour préparer correctement votre fichier CSV ou XLSX avant de l’importer dans la plateforme. Vous y découvrirez la structure attendue, les champs obligatoires ainsi que le format des valeurs pour qu’elles soient correctement reconnues lors de l’import. En respectant ces règles, vous éviterez les erreurs les plus fréquentes, comme des colonnes manquantes, des types de données incorrects ou des problèmes de correspondance des champs. Servez-vous de cet article comme d’une checklist pour vérifier votre fichier et garantir un import rapide et fiable à chaque fois.
Vous pouvez importer des données à partir des formats suivants :
CSV
XLSX
Votre fichier doit utiliser un séparateur standard pour que les données soient correctement interprétées lors de l’import
Séparateurs autorisés
virgule (,)
point-virgule (;)
tabulation
À éviter :
Doubles virgules (,,)
Virgules mal positionnées
Caractères de séparation inhabituels
L’encodage correspond à la façon dont le texte est transformé en données que le système peut lire. Il détermine comment les caractères (lettres, chiffres, symboles, accents, etc.) sont enregistrés et affichés. Un encodage incorrect peut rendre certains caractères illisibles ou les afficher de manière incorrecte, en particulier dans les contenus multilingues. Il est donc important de choisir le bon format.
Parmi les encodages les plus utilisés, UTF-8 est aujourd’hui le standard. Il prend en charge un très large éventail de caractères issus de différents systèmes d’écriture et est fortement recommandé pour les contenus internationaux, grâce à sa compatibilité et sa flexibilité.
L’encodage Cyrillic (Windows-1251) est un standard historique, couramment utilisé pour les langues cyrilliques, notamment dans les anciens environnements Windows. Cyrillic (ISO-8859-5) est un autre encodage ancien pour ces langues, aujourd’hui moins répandu que Windows-1251 ou les encodages basés sur Unicode.
Pour les langues d’Europe centrale et orientale, Eastern Europe (Windows-1250) était fréquemment utilisé dans les anciennes applications Windows. Il permet de gérer les langues utilisant l’alphabet latin avec des signes diacritiques, comme le polonais, le tchèque ou le hongrois. De manière similaire, Eastern Europe (ISO-8859-2) est un ancien standard international pour ces langues, désormais largement remplacé par Unicode dans les systèmes modernes.
Enfin, US ASCII est l’un des encodages les plus anciens et les plus limités. Il ne comprend que les lettres de base de l’alphabet anglais, les chiffres et la ponctuation, ce qui le rend adapté uniquement à des contenus simples en texte brut, sans accents ni caractères non latins.
Dans la plupart des cas, UTF-8 reste le choix le plus sûr et le plus universel. Les autres encodages sont surtout utiles pour assurer la compatibilité avec des fichiers ou systèmes plus anciens.
Chaque en-tête de colonne doit correspondre à un attribut, et chaque cellule doit contenir uniquement la valeur associée.
Si des valeurs supplémentaires sont présentes dans une ligne sans correspondre à un attribut, le système d’import peut tenter de les regrouper et de les traiter comme un seul champ. Cela peut entraîner des erreurs de validation trompeuses (par exemple, un message “last_name trop long” alors que la valeur semble correcte).
Checklist
Chaque colonne possède un en-tête clair (nom de l'attribut).
Chaque valeur correspond à un attribut existant (ou que vous allez créer).
Aucune valeur supplémentaire après la dernière colonne attendue.
Le format des données est essentiel : le système vérifie que chaque valeur correspond bien au type d’attribut attendu.
Avant de créer de nouveaux attributs, vérifiez les types disponibles :
Type | Description | Example |
Boolean | Options binaires (True/False). | Attribut "Consentement marketing", valeur "True" |
Date | Champ pour stocker une date spécifique. | Attribut “Anniversaire”, valeur “1996-01-20” |
Datetime | Champ pour stocker date et heure précises (inscription, dernière activité). Format ISO 8601 requis. | Attribut “dernière visite”, valeur “2016-08-03 12:00:00+00:00” |
Fixed choice | Ensemble d’options possibles limitant les valeurs d’un champ. Peut inclure “Autoriser plusieurs choix”. | Attribut “Langue préférée”, valeurs “Anglais”, “Français”, “Espagnol” |
Floating-point number | Données numériques pouvant inclure des décimales, adaptées pour prix ou mesures statistiques. | Attribut “Dépenses totales”, valeur “1000,59” |
Integer | Données numériques incluant uniquement des nombres entiers. | Attribut “Nombre total de commandes”, valeur “9” |
JSON file format | Pour des valeurs longues qui ne peuvent pas être placées dans d’autres formats. | Attribut “Informations supplémentaires sur la commande”, valeur (objet JSON valide): “key”: “value” |
Number | Utilisé surtout pour les attributs d’événement, couvre entiers et nombres à virgule flottante. | Attribut “Points collectés”, valeur “15” |
String | Suite de caractères limitée à 255 éléments. Parfait pour des informations textuelles (nom, email, texte). | Attribut “Type d’abonnement”, valeur “Standard” |
En savoir plus sur les attributs ici.
Certains champs attendent des valeurs spécifiques. Veillez à respecter le format requis.
Attribute | Description | Required Values |
Genre (attribut de contact) | Attribut standard pouvant être personnalisé. Vide par défaut. |
|
Numéro de téléphone (attribut de contact) | Attribut standard pouvant être personnalisé. Vide par défaut. | Format E.164. Exemple : +33612345678 |
Statut (attribut d’opportunité) | Définit le statut d’une opportunité. |
|
Statut (attribut de tâche) | Définit le statut d’une tâche. |
|
Assigné à (attribut de contact) | Définit quel utilisateur gère un contact. | Doit correspondre à un ID, ou un nom d’utilisateur/de groupe d'utilisateurs existant. |
Statut (attribut de ticket) | Définit le statut d’un ticket de support. |
|
Pour en savoir plus sur l'import d'objets spécifiques, consultez la section dédiée de notre centre d’aide : Import & Export de données.
