Show Menu
SUJETS×

A propos du fichier de données et des sources de données pour les attributs du client

Exigences relatives aux fichiers de données et sources de données multiples pour le transfert des attributs du client vers Experience Cloud.
Vous allez devoir accéder à la gestion de la relation client ou à d’autres données du même type de votre société. Les données que vous transférez vers Experience Cloud doivent être regroupées dans un fichier  .csv . Si vous transférez le fichier par FTP ou sFTP, vous devez également transférer un fichier  .fin .
La fonction Attributs du client est conçue pour gérer quelques fichiers par jour. Pour atténuer le problème lié au retardement du traitement dû à un grand nombre de petits fichiers, les fichiers envoyés dans les 30 minutes suivant un lot précédent depuis une même organisation sont acheminés vers une file d’attente de priorité inférieure.

Types de fichiers autorisés et exigences en termes d’attribution de noms

Type de fichier Description
.csv
Fichier de valeurs séparées par des virgules (tels ceux créés dans Excel). Il s’agit du fichier qui contient les données d’attribut du client.
Exigences en matière de nommage : assurez-vous que les extensions de nom de fichier ne contiennent pas d’espaces vides.
.fin
(Requis) Le fichier .fin indique au système quand le transfert des données est terminé. Le nom du fichier .fin doit correspondre au nom du fichier  .csv .
Adobe recommande de créer un fichier texte vide avec une extension  .fin . Un fichier vide permet de gagner de l’espace et d’accélérer le transfert.
Remarque : Il n’est pas possible de renommer le fichier  .fin après son transfert. Le fichier  .fin doit être transféré séparément ; il ne peut pas s’agir d’un fichier précédemment transféré et renommé.
After you upload the .fin file in the Customer Attributes FTP, the system retrieves data quickly (within one minute). Cette configuration diffère des autres systèmes FTP d’Adobe, qui captent les données moins fréquemment (environ une fois par heure).
Le fichier  .fin n’est pas nécessaire en cas de transfert par glisser-déplacer.
.gz ou .zip
.gz (gzip) ou .zip – pour les fichiers compressés. Un fichier .zip ne peut pas contenir plus d’un fichier dans l’archive.
Exigences en termes d’attribution de nom : le nom du fichier .zip ou .gz doit correspondre au nom du fichier .csv . Si, par exemple, votre fichier .csv se nomme crm_petit.csv , le fichier .zip doit se nommer crm_petit.csv.zip .
Le fichier .fin doit correspondre au fichier .csv.

Conditions requises pour les fichiers de données d’attributs

Exemple de fichier CSV
Le fichier CSV doit respecter le format suivant :
Le même fichier affiché dans un éditeur de texte :
Instructions
Élément Description
Glisser-déposer
Le fichier glissé-déposé doit être inférieur à 100 mégaoctets.
Le fichier  .fin n’est pas nécessaire en cas de transfert par glisser-déplacer.
Colonne d’ID de client
La première colonne doit être un ID de client unique. L’ID utilisé doit correspondre à l’ID transmis au service Experience Cloud ID.
Pour Analytics, l’ID est stocké dans une prop ou une eVar.
Pour Target, il s’agit de la valeur setCustomerID. (Voir Analytics et Adobe Target - Synchronisation de l’ID de client )
Cet ID de client est l’identifiant unique utilisé par la gestion de la relation client pour chaque personne de votre base de données. Les autres colonnes contiennent les attributs issus de la gestion de la relation client. Vous choisirez le nombre d’attributs à charger.
Il est préférable d’utiliser des noms lisibles et faciles à retenir pour les titres de colonne, mais cela n’est pas obligatoire. Lorsque vous validez le schéma après le chargement, vous pouvez mapper des noms conviviaux aux lignes et colonnes chargées.
À propos des ID de client
En règle générale, une entreprise utilise un ID de client provenant d’un système de gestion de la relation client. L’ID est défini par l’appel setCustomerIDs lorsqu’une personne se connecte. Cet ID sert également de clé dans le fichier de gestion de la relation client qui est transféré vers Experience Cloud. Un ID d’alias est un nom convivial pour un magasin de données dans Audience Manager, où les données d’alias sont stockées. Le système envoie des alias à ce magasin de données (via setCustomerIDs). Le fichier de gestion de la relation client (CRM) est appliqué aux données de ce magasin de données.
Pour plus d’informations sur setCustomerIDs , voir ID de client et états d’authentification .
En-têtes et colonnes suivants
Les en-têtes suivants doivent représenter le nom de chaque attribut.
Ces colonnes doivent contenir les attributs du client issus de la gestion de la relation client.
Limites d’attribut
Vous pouvez transférer des centaines de colonnes  .csv vers le service d’attributs du client dans Experience Cloud. Toutefois, lors de la configuration des abonnements et de la sélection des attributs, les restrictions suivantes s’appliquent, selon les solutions que vous détenez :
  • Analytics Standard  : 3 au total
  • Analytics Premium  : 200 par suite de rapports
  • Adobe Target Standard : 5
  • Adobe Target Premium : 200
Limites de ligne
Il n’existe aucune limite connue quant au nombre de lignes.
Limites de colonne
Pour des raisons pratiques, limitez le nombre de colonnes à environ 200.
Limites de caractères
Lors de la création d’un abonnement Analytics, la longueur des champs des fichiers chargés est tronquée à 255.
Instructions et limites de taille FTP
  • Pour chaque transfert par FTP, le fichier ne doit pas dépasser 4 Go.
  • Pour chaque transfert, la limite de la taille minimale de fichier est de 10 Mo.
  • Vous pouvez télécharger un fichier toutes les demi-heures.
  • Déposez de préférence vos fichiers .csv et .fin dans le dossier racine du site FTP.
Important : l’espace total autorisé pour le compte FTP est de 40 Go. Il est de votre responsabilité de supprimer les fichiers traités.
Exigences relatives aux fichiers
Chaque source d’attribut doit contenir le même nombre de champs séparés par des virgules.
Les champs contenant un saut de ligne, un guillemet double ou des virgules doivent être placés entre guillemets.
Les guillemets doubles d’un champ doivent être précédés d’une séquence d’échappement à l’aide d’une barre oblique inverse (\).
Les colonnes vierges sont stockées comme valeur nulle .
Fichiers multiples
Lors du transfert des données d’attributs du client, si vous souhaitez transférer plusieurs fichiers en succession rapide, en particulier si les fichiers sont volumineux, vérifiez que le fichier précédent a été traité avant de télécharger le fichier suivant. Vous pouvez contrôler ce problème en vérifiant si le fichier précédent a été déplacé vers le dossier traité ou échoué dans votre compte FTP Attributs du client.
Le fait de diviser un fichier volumineux en fichiers plus petits et de les envoyer rapidement peut ralentir le traitement, sauf si vous pouvez vérifier que chaque fichier est complètement traité avant d’envoyer le suivant.
Encodage des caractères
Pour le Japon, l’UTF-8 est obligatoire.
Données historiques
Les attributs du client sont liés au profil du visiteur sous-jacent dans Analytics. De ce fait, les attributs du client sont associés au visiteur pendant toute la durée de vie de ce profil visiteur dans Analytics. Cela inclut le phénomène qui s’est produit avant la première connexion du client.
Si vous utilisez la méthode de renvoi de l’entrepôt de données, les données sont liées à un post_visid_high/low qui repose sur l’Analytics ID (AID). Si vous utilisez le service Experience Cloud ID, les données sont liées à un post_visid_high/low basé sur Experience Cloud ID (MID).
Flux de données
Les attributs du client ne sont pas disponibles dans les flux de données.

Utilisation de plusieurs sources de données

Lorsque vous créez, modifiez ou supprimez une source d’attributs du client, la synchronisation des ID avec la nouvelle source de données peut prendre jusqu’à une heure.
L’ID d’alias de chaque source d’attributs du client doit être unique. Si plusieurs sources de données utilisent le même ID, elles doivent être configurées comme suit :
Dans VisitorAPI.js ou l’outil Experience Cloud ID de Dynamic Tag Management :
Définissez deux ID de client qui correspondent aux sources de données adéquates :
Visitor.setCustomerIDs({ 
     "ds_id1”:"123456", 
     "ds_id2":"123456" 
});

(Pour plus d’informations, voir ID de client et états de l’authentification.)
Dans Experience Cloud  > Personnes  > Attributs du client  :
Créez deux sources d’attributs du client à l’aide d’identifiants d’alias uniques correspondant aux identifiants de client ci-dessus. Cette méthode permet d’envoyer le même ID de référence à plusieurs sources d’attributs clientes.