À propos du fichier de données et des sources de données pour Customer Attributes
Exigences liées aux fichiers de données et sources de données multiples pour télécharger Customer Attributes 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 un fichier .csv. Si vous chargez le fichier via FTP ou sFTP, vous devez également charger un fichier .fin.
Customer Attributes est conçu 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
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.
(Requis) Le fichier .fin indique au système quand le chargement 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 chargement.
Remarque : Il n’est pas possible de renommer le fichier .fin après son chargement. Le fichier .fin doit être chargé séparément ; il ne peut pas s’agir d’un fichier précédemment chargé 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 chargement par glisser-déplacer.
.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 :
Le même fichier affiché dans un éditeur de texte :
Instructions
La taille du fichier glissé-déposé doit être inférieure à 100 Mo.
Le fichier .fin n’est pas nécessaire en cas de chargement par glisser-déplacer.
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, la valeur setCustomerID .
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 à 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 identifiant est également utilisé comme clé dans le fichier CRM téléchargé vers Experience Cloud. Un ID d’aliasest un nom convivial pour un entrepôt de données en 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.
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.
Vous pouvez télécharger des centaines de colonnes .csv vers le service Attribut 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
- Pour chaque chargement par FTP, le fichier ne doit pas dépasser 4 Go.
- Pour chaque chargement, 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.
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 vides sont stockées sous la forme null .
Lors du chargement des données d’attributs du client, si vous souhaitez charger 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 charger 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.
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.
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.