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

Exigences en matière de fichiers de données et sources de données multiples pour transférer les attributs du client vers Experience Cloud.

Il vous faut accéder à la gestion de la relation client (CRM) ou à d’autres données similaires de votre société. Les données que vous chargez vers Experience Cloud doivent être regroupées dans un fichier .csv. Si vous chargez le fichier via FTP ou sFTP, vous devez également charger 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 section_6F64FA02ACCC4215B0862CB6A1821FBF

Type de fichier
Description
.csv

Fichier de valeurs séparées par des virgules (tels ceux créés dans Excel). Ce fichier contient les données d’attributs du client.

Exigences en matière de dénomination : 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é.

Après avoir téléchargé le fichier .fin via le système FTP des attributs du client, le système extrait rapidement les données (en moins d’une 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 section_169FBF5B7BBA47CE825B7A330CF3FE98

Exemple de fichier CSV

Le fichier CSV doit respecter le format suivant :

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

Le même fichier affiché dans un éditeur de texte :

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

Instructions

Élément
Description
Glisser-déposer

La taille du fichier glissé-déposé doit être inférieure à 100 Mo.

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 choisissez le nombre d’attributs à transférer.

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 applications 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 transférer le fichier suivant. Vous pouvez vous en assurer en vérifiant le moment où le fichier précédent a été déplacé vers le dossier traité ou en échec dans votre compte FTP d’Customer Attributes.

Diviser un fichier volumineux en fichiers de plus petite taille puis les envoyer en succession rapide peut ralentir le traitement, sauf si vous pouvez vous assurer du traitement de chaque fichier avant l’envoi du 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. Ainsi, les Customer Attributes sont associés au visiteur pendant toute la durée de vie du profil de ce visiteur dans Analytics. Ce profil inclut le comportement survenu avant la première connexion du client.

Si vous utilisez la méthode de renvoi de Data Warehouse, 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).

Notez que la méthode de renvoi du Data Warehouse ne sera plus disponible à compter d’octobre 2022.

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 section_76DEB6001C614F4DB8BCC3E5D05088CB

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 peuvent être configurées comme suit :

Dans VisitorAPI.js ou l’outil Experience Cloud ID de Dynamic Tag Management :

Définissez deux ID 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’ID d’alias uniques correspondant aux ID de client ci-dessus. L’utilisation de cette méthode permet l’envoi du même ID de référence à plusieurs sources d’attributs du client.

recommendation-more-help
872fc4ed-f5f7-4b59-a6f8-4ddabe5aac1f