Noms de colonnes et descriptions des données client dans les fichiers TSV
CitrusAd prend uniquement en charge le format TSV pour les données client. Le tableau ci-dessous liste les noms des colonnes et leurs descriptions pour les fichiers TSV. Pour les données client, la seule colonne obligatoire est customer_id
.
Nom de la colonne | Obligatoire/facultatif | Type de données | Description |
---|---|---|---|
customer_id | Obligatoire | Texte | Ceci est l'identifiant du client dans le système du détaillant. |
year_of_birth | Facultatif | Numéro | N'est plus utilisé. Ceci est l'année de naissance du client. Il doit s'agir d'un nombre. |
gender | Facultatif | Texte | N'est plus utilisé. Il s'agit du genre du client. Si renseigné, il doit s'agir de l'une des valeurs suivantes : {“UNDEFINED”, “FEMALE”, “MALE”, “OTHER”}. La valeur n'est pas sensible à la casse. |
postcode | Facultatif | Texte | N'est plus utilisé. Ceci est le code postal de l'adresse de contact du client. |
suburb | Facultatif | Texte | N'est plus utilisé. Ceci est le faubourg de l'adresse de contact du client. |
status | Obligatoire si vous synchronisez les mises à jour delta | Texte | Lorsque vous synchronisez des modifications delta via un fichier, ce processus est utilisé pour indiquer l'action à effectuer sur l'identifiant client. Les valeurs acceptées sont les suivantes : INSERT , UPDATE etDELETE |
target_data | Facultatif | Carte Json | Si renseigné, il doit s'agir d'une carte json, par exemple {"customer_type" : "entreprise", "customer_country" : "Australie"} |
customer_targeting:KEY | Facultatif | Texte | Si ce type de colonne est utilisé, les détaillants doivent fournir une valeur pour KEY. Par exemple, le nom de la colonne peut être « customer_targeting:customer_type » avec comme valeur de cellule « entreprise », « pme » ou « vente au détail ». Plusieurs colonnes peuvent présenter cette syntaxe dans un fichier TSV. |
Vous trouverez dans le tableau ci-dessous un exemple de fichier TSV comportant une ligne d'en-tête et trois lignes de données pour une synchronisation complète du fichier. Veuillez noter que les données brutes se présentent sous la forme d'un fichier texte, mais qu'elles sont représentées dans un tableau pour être lues plus facilement.
customer_id | year_of_birth | gender | postcode | suburb | customer_targeting:customer_type |
---|---|---|---|---|---|
0937832 | 1990 | MALE | 3000 | Melbourne | Vente au détail |
0347293 | 1993 | FEMALE | 4000 | Brisbane | Vente au détail |
0293423 | OTHER | 4064 | Milton | Entreprise |
Options de synchronisation
Mise à jour complète
Le mode mise à jour complète permet aux détaillants de synchroniser l'ensemble de leur fichier d'informations sur les clients. Il s'agit de la méthode généralement intégrée par un détaillant, car elle est plus simple à configurer.
Mise à jour Delta
Les mises à jour delta sont possibles en ajustant votre fichier pour synchroniser uniquement les mises à jour ou les modifications apportées aux clients. C'est la meilleure solution pour les gros détaillants qui disposent d'une large audience.
Votre fichier doit avoir le format status
colonne, car elle indique l'action à effectuer sur l'utilisateur. Les valeurs acceptées sont les suivantes : INSERT
, UPDATE
etDELETE
.
Voici un exemple de fichier :
customer_id | status | year_of_birth | gender | postcode | suburb | customer_targeting:customer_type |
---|---|---|---|---|---|---|
1 | INSERT | 1990 | MALE | 3000 | Melbourne | Vente au détail |
2 | UPDATE | 1993 | FEMALE | 4000 | Brisbane | Vente au détail |
3 | DELETE | OTHER | 4064 | Milton | Entreprise |
Vous ne pouvez pas synchroniser les modifications delta dans un flux de mise à jour complète.
Dans le cas du flux ci-dessus, l'identifiant du client 1 est nouveau, le client 2 est en cours de mise à jour et le client 3 a été supprimé par le détaillant.