Importer des contacts
Comment importer des contacts via un fichier CSV dans Ticketmatic ?
Si vous disposez déjà d’une liste de contacts issue d’un autre système, vous pouvez facilement l’importer dans Ticketmatic grâce à un fichier CSV.
💡 Informations clés :
- Taille maximale du fichier : 15 Mo (plusieurs milliers de contacts par import).
- Clé unique : L'adresse e-mail sert d'identifiant unique. Chaque e-mail ne doit apparaître qu’une seule fois dans votre fichier.
Préparez votre fichier CSV
Utilisez un tableur (Microsoft Excel, Google Sheets, etc.) pour nettoyer et structurer vos données avant l'importation : corrigez les erreurs, supprimez les doublons et structurez les colonnes.
Règles de formatage général
- Ligne d'en-tête : Doit contenir le nom de vos colonnes. Les noms doivent être uniques et ne contenir que des lettres, chiffres ou underscores (_).
- Séparateurs acceptés : Virgule (,) ou point-virgule (;).
- Correspondance des champs : Vous pourrez associer vos colonnes aux champs ticketmatic lors de l'importation. Vos intitulés de colonnes sont donc libres.
- Format des dates : Veillez à utiliser un format de date uniforme dans tout le fichier (ex. JJ/MM/AAAA ou AAAA-MM-JJ). Vous indiquerez ce format lors de l'importation.
Ticketmatic prend en charge tous les champs de contact essentiels, notamment adresse e-mail, prénom, nom, date de naissance, numéro de téléphone, adresse postale, etc., ainsi que les données liées aux opt-ins comme l’inscription à une newsletter ou l’autorisation de partager des données personnelles.
Règles spécifiques par type de champ
Adresses postales
- Champ obligatoire : La saisie d'une adresse n’est pas obligatoire, mais si vous incluez une adresse, le champ Pays est requis.
- Format du Pays : Indiquez le nom complet du pays ou son code ISO 3166 à deux lettres (ex. FR, BE, CA).
Titres de civilité & Champs personnalisés
Certains champs spécifiques nécessitent des identifiants (ID) internes ticketmatic :
Type de champ | Format attendu dans le CSV |
|---|---|
Titre client | ID Ticketmatic de la civilité. (Voir astuce ci-dessous) |
Champ personnalisé : Sélection unique | ID Ticketmatic de la valeur choisie. |
Champ personnalisé : Sélection multiple | Liste des ID entre crochets : [id1,id2,...] |
Champ personnalisé : Case à cocher (Booléen) | true ou 1 = Vrai false, 0 ou autre = Faux |
(En cas de doute sur l'obtention des ID, contactez le support).
Lors de l'importation de champs personnalisés de type Sélection unique, vous devez spécifier l'ID ticketmatic de la valeur du champ personnalisé.
Lors de l'importation de champs personnalisés de type Sélection multiple, vous devez spécifier les ID Ticketmatic et les formater comme suit : [id1,id2,...]
Lors de l'importation de champs personnalisés de type Booléen (case à cocher), vous pouvez spécifier les valeurs suivantes :
- Valeur true of 1: Vrai
- Valeur false of 0: Faux
- Toute autre valeur: faux
💡 Astuce technique (Titres client) : Pour obtenir la liste des ID de titres clients, exécutez la commande suivante dans Paramètres > Console :
Opt-ins (Consentements)
Pour importer et gérer le statut des inscriptions (ex. newsletter), le fichier CSV doit contenir les valeurs suivantes :
- S'inscrire : Indiqueztrue ou 1.
- Se désinscrire : Indiquez false ou 0.
- Statut Inconnu : Laissez la cellule vide.
Quand et comment les opt-ins sont-ils ajoutés ?
Pour un contact existant :
- Si vous choisissez Ajouter uniquement les données manquantes, les données d'opt-in sont ajoutées si le statut actuel de l'opt-in est « inconnu ».
- Si vous choisissez Écraser les données existantes, toutes les données d'opt-in existantes sont remplacées.
Tableau d'exemple 💡 Dans l'exemple ci-dessous, John Doe sera inscrit à la newsletter et Jane Doe sera désinscrite. Si le champ est vide, le statut sera « inconnu ».
Exemple de structure CSV :
Prénom | Nom | Adresse e-mail | Opt-in Newsletter |
|---|---|---|---|
John | Doe | 1 (Inscrit) | |
Jane | Doe | 0 (Désinscrit) | |
Marc | Dupont | (Vide = Inconnu) |
Comprendre le comportement lors de l'importation
Lors de l'import, ticketmatic vérifie si l'adresse e-mail existe déjà.
Vous devez choisir une action parmi les 3 options suivantes :
Action choisie | Nouveaux contacts | Contacts existants |
|---|---|---|
Ignorer l’importation | Le contact est créé. | Le contact existant reste inchangé. |
Ajouter uniquement les données manquantes | Le contact est créé. | Seuls les champs vides (adresse, téléphone, opt-in "inconnu") sont complétés. |
Écraser les données existantes | Le contact est créé. | Toutes les données sont remplacées. |
Lancez l'importation dans ticketmatic
Une fois votre fichier CSV prêt et vérifié :
- Connectez-vous à ticketmatic.
- Allez dans Public > Outils > Importer le CSV.
- Téléchargez votre fichier.
- À l'Étape 2, configurez le format de date utilisé dans votre fichier et associez vos colonnes aux champs ticketmatic.
- Choisissez la règle de gestion des doublons (Ignorer, Ajouter les données manquantes ou Écraser).
- Validez l'importation.
⚠️ Les contacts de votre liste sont identifiés sur la base de leur adresse e-mail. Chaque adresse e-mail doit être unique et ne peut apparaître qu’une seule fois. Veillez donc à vérifier l’absence de doublons avant de lancer l’importation.