1. Skeepers
  2. DIFFUSIONS
  3. DIFFUSIONS EMAIL

Préparer votre fichier CSV de ciblage pour une diffusion Email via Skeepers Targeting

Mise à jour

Cet article vous guide pas à pas dans la création de votre fichier CSV de ciblage, utilisé avec Targeting Studio pour vos diffusions Email.

À quoi sert le fichier CSV de ciblage ?

Le fichier CSV de ciblage permet d’associer chaque contact à la campagne qu’il doit recevoir. Cela veut dire que chaque ligne représente un contact.

La colonne targeting_ref permet de définir la campagne qui doit lui être envoyée. 

Une fois le fichier complété, il est déposé sur le SFTP, où il est automatiquement pris en charge et traité par la plateforme (en savoir plus sur les types de dépôts FTP).

Ce fichier n’est pas une base de contacts CRM complète. Il sert uniquement à gérer des ordres de ciblage.

Nommage du fichier CSV

Afin de garantir la compatibilité de vos fichiers dans le temps, nous vous recommandons d’utiliser une convention de nommage versionnée.

Utilisez le format suivant :
targeting_v1_YYYY-MM-DD (par exemple : targeting_v1_2026-04-28-clients_vip.csv)

Cette convention permet d’anticiper les évolutions du format de fichier, sans impacter vos campagnes déjà en place.

Structure générale du fichier

Votre fichier doit respecter les règles suivantes :

  • Format : CSV (UTF-8)
  • Une ligne d’en-tête (obligatoire)
  • Une ligne = un contact
  • Présence obligatoire :
    • des champs standards
    • de la colonne targeting_ref
    • d’au moins un identifiant du contact : consumer_id, email ou phone

Tous les noms de colonnes doivent être en minuscules (lowercase).

Nos outils étant case-insensitive, il est impossible de traiter deux colonnes dont seul le casing diffère (ex : Nom_Custom vs nom_custom).

Utilisez uniquement du lowercase pour toutes vos colonnes (standards et personnalisées).

Champs standards

Les champs standards sont communs à tous les clients. Ils permettent d’identifier le contact et de personnaliser vos messages.

Colonne

 

Statut

 

Description

 

firstname

Obligatoire

Prénom du contact

lastname

Obligatoire

Nom du contact
targeting_ref Obligatoire Valeur de votre choix
consumer_id Optionnel Votre identifiant client interne (n° client, ID CRM…). Permet d’identifier un contact sans passer par son email, et reste le même quel que soit le canal (email et SMS).

email

Optionnel

Adresse email

phone

Optionnel

Numéro de téléphone

gender

Optionnel

Genre (M / F)

civility

Optionnel

Civilité (Mr / Mme / Dr)

lang

Optionnel

Langue préférée (ex : fr, en)

country

Optionnel

Pays

solicitation_date

Optionnel

Permet de définir explicitement la date à laquelle le contact doit être sollicité.

Points d’attention

  • Les noms de colonnes doivent être strictement identiques
  • targeting_ref est le lien entre votre fichier et vos campagnes
  • Même si consumer_id, email et phone sont tous les trois optionnels, chaque ligne doit contenir au moins l’un des trois pour pouvoir être traitée. Le canal de diffusion reste par ailleurs contraignant : une campagne email nécessite un email exploitable, une campagne SMS un phone exploitable.
  • Si solicitation_date est vide, la date utilisée sera celle de l’intégration du fichier
  • Un délai peut être appliqué via les règles de lancement de campagne

Identifier un contact : le champ consumer_id

Historiquement, un contact était identifié par son email (ou son téléphone). Vous pouvez désormais utiliser votre propre identifiant client via la colonne consumer_id.

Pourquoi l’utiliser ?

  • Un seul identifiant pour les deux canaux : la même valeur de consumer_id peut être utilisée pour l’email et pour le SMS, ce qui évite de gérer deux clés d’identification différentes.
  • Vous restez maître de la clé : c’est votre identifiant CRM / e-commerce, indépendant des changements d’adresse email ou de numéro de téléphone de vos clients.
  • Un suivi plus fiable : les sollicitations et les réponses d’un même client sont rattachées au bon contact, même si ses coordonnées évoluent.

Ordre de priorité pour identifier le contact

Le champ consumer_id est facultatif. Lors du traitement du fichier, l’identification du contact suit cette cascade :

  1. consumer_id s’il est renseigné
  2. sinon email
  3. sinon phone

Si aucun des trois n’est renseigné, la ligne ne peut pas être traitée.

Bonnes pratiques

  • Utilisez une valeur stable dans le temps : le même client doit toujours porter le même consumer_id, d’un fichier à l’autre.
  • Utilisez une valeur unique par client : deux clients différents ne doivent jamais partager le même consumer_id.
  • Si vous adoptez consumer_id, renseignez-le sur toutes les lignes de vos fichiers, afin d’éviter de mélanger deux logiques d’identification.

Exemple de fichier CSV avec consumer_id

consumer_id firstname lastname email phone targeting_ref
CLI-100234 Marie Durand marie@email.com +33600000001 VIP_CLIENT
CLI-100987 Jean Martin   +33600000002 NOUVEAU_CLIENT

Dans cet exemple :

  • Marie et Jean sont identifiés par leur consumer_id, indépendamment du canal utilisé
  • Jean peut être ciblé même sans adresse email, via son numéro de téléphone

Exemple de fichier CSV minimal (sans consumer_id)

firstname

 

lastname

 

email

 

targeting_ref

 

Marie

Durand

marie@email.com

VIP_CLIENT

Jean

Martin

jean@email.com

NOUVEAU_CLIENT

Dans cet exemple :

  • Marie recevra la campagne associée à VIP_CLIENT
  • Jean recevra celle associée à NOUVEAU_CLIENT
  • l’identification repose sur l’email, en l’absence de consumer_id

Ajouter des attributs personnalisés

Vous pouvez enrichir votre fichier avec des colonnes personnalisées pour :

  • Ajouter des informations métier
  • Créer des segments
  • Personnaliser vos messages

Le nom de la colonne doit correspondre exactement au nom de l’attribut existant dans votre compte Feedback Management.

Gestion des doublons

La gestion des doublons est automatiquement prise en charge lors du traitement du fichier.

Le dédoublonnage s’appuie sur l’identifiant retenu pour la ligne (voir l’ordre de priorité ci-dessus) combiné au targeting_ref :

  • Si consumer_id est renseigné → doublon détecté sur le couple consumer_id + targeting_ref
  • Sinon → doublon détecté sur le couple email + targeting_ref
  • Sinon → doublon détecté sur le couple phone + targeting_ref

Un seul contact est conservé, les doublons sont automatiquement supprimés.

À retenir

  • Avant d’uploader votre fichier, vérifiez que :

  • le fichier est au format CSV

  • les noms de colonnes sont corrects et en lowercase

  • la colonne targeting_ref est présente

  • chaque ligne contient une valeur de targeting_ref

  • chaque ligne contient au moins un identifiant : consumer_id, email ou phone
  • les valeurs de consumer_id sont stables et identiques d’un fichier à l’autre

  • vos attributs personnalisés existent dans votre compte

Erreurs à éviter

  • Renommer les champs standards
  • Oublier la colonne targeting_ref
  • Laisser une ligne sans aucun identifiant (consumer_id, email et phone tous vides)
  • Changer la valeur de consumer_id d’un fichier à l’autre pour un même client (crée des doublons)
  • Utiliser un même consumer_id pour plusieurs clients différents
  • Mélanger plusieurs logiques de ciblage sans cohérence
  • Utiliser des caractères spéciaux ou des espaces dans les noms de colonnes

Télécharger le modèle de fichier CSV

Pour vous aider, nous mettons à disposition un modèle CSV prêt à l’emploi, incluant :

  • les champs standards (dont consumer_id)

  • la colonne targeting_ref

  • des exemples d’attributs personnalisés

Télécharger le modèle CSV de ciblage standard

Si vous avez des questions, n'hésitez pas à contacter notre équipe Customer Care.

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0

Articles associés

Menu icon Dans cette page