Vous êtes ici :
Fil de données ETL Transaction
Utilisez le fil de données Transaction ETL pour charger en masse des transactions afin d'associer des achats d'articles à des profils utilisateur individuels.
À propos de l'ingestion de données de transaction
Ce fil de données ETL importe des transactions dans Personnalisation et les associe à des profils utilisateur en les attribuant à un profil utilisateur existant ou en créant un profil utilisateur lorsqu'il ne correspond pas.
Chaque transaction consiste en une liste d'enregistrements consécutifs pour des éléments de ligne individuels qui ont tous le même transactionId. Tous les enregistrements d'une transaction doivent avoir les mêmes valeurs userId et purchaseDate. Chaque enregistrement d'une transaction doit avoir un productId, un prix et une quantité.
Triez le fichier par ID de transaction. Vous pouvez trier le fichier vous-même avant de le charger, ou activer le tri dans la page Configuration de l'engrenage en sélectionnant l'option Tri ETL de la transaction avant le regroupement. Si le fichier n'est pas trié, Personalization ne le charge pas. Par conséquent, vous devez trier et soumettre de nouveau le fichier pour le traiter.
Lors de la mise à jour d'une transaction avec de nouvelles informations, le contenu complet de la transaction doit être présent dans le fichier, même s'il ne change pas. La personnalisation remplace tous les enregistrements précédemment stockés pour la transaction si un fichier contient un transactionId pour une transaction déjà enregistrée. Les mises à jour des commandes existantes ne mettent pas à jour les statistiques dérivées de la commande d'origine, telles que la Valeur sur la durée de vie ou les statistiques d'achat quotidiennes.
Conditions requises
- Les fichiers ETL doivent avoir un format de fichier CSV conforme au schéma du fil de données. Les fichiers qui ne respectent pas les conventions de nommage des fichiers ou le schéma approprié entraînent des erreurs et ne sont pas traités.
- Les noms de champ qui commencent par
attribute:doivent correspondre aux noms d'attribut personnalisés sous l'onglet Attributs utilisateur de la page Paramètres > Attributs.
Format du nom de fichier
transaction-YYYY-MM-DD_HH-MM-SS.csv
Schéma
| Nom du champ | Description | Exemple de valeurs | Longueur maximale | Type de données |
|---|---|---|---|---|
|
Obligatoire. Seules les identités uniques peuvent être incluses et mises à jour via un fil ETL. Si vous n'utilisez pas le système d'identités multiples de Personalization, un ID d'utilisateur doit être inclus. Cet ID doit être suivi dans le système pour que les événements puissent être liés au profil utilisateur spécifique. Si vous utilisez le système d'identités multiples de Personalization, userId n'est pas référencé dans les fichiers ETL. Au moins un attribut d'identité est requis. Plusieurs attributs d'identité peuvent être inclus pour un seul utilisateur en incluant plusieurs colonnes dans le fichier. Cinq attributs d'identité sont limités pour l'ETL Transaction. Le format d'en-tête correct pour les attributs d'identité est |
user168515262 jdoe@test.com attribute:emailAddress attribute:sfmcContactKey attribute:customerId attribute:sfcrmContactId attribute:sfcrmLeadId |
120 |
Chaîne |
transactionId
|
Obligatoire. Représente un identifiant unique pour un achat individuel. Tous les éléments de ligne d'une transaction doivent avoir le même ID de transaction. |
860340254 |
255 |
Chaîne |
purchaseDate
|
Obligatoire. Une chaîne de date et d'heure ISO 8601 indiquant la date de la transaction. Le premier enregistrement d'une transaction définit la date de la commande globale. Toutes les dates sont stockées en heure UTC. Les décalages de fuseau horaire ne sont pas pris en charge. |
2022-04-12 2022-04-12T11:24:59Z |
1023 |
Chaîne |
productId
|
Obligatoire. Représente le produit de votre catalogue qui a été acheté dans la transaction. Si l'ID ne correspond pas à un produit existant dans votre catalogue, Personalization crée un élément avec productId dans le catalogue. |
prod001 |
255 |
Chaîne |
price
|
Obligatoire. Le prix unitaire facturé à l'utilisateur. Ce champ est multiplié par la quantité pour déterminer la valeur totale de cet élément de ligne. Par exemple, si le prix est de 1,10 € et que la quantité est de 3, la valeur totale de l'élément de ligne est de 3,30 €. Utilisez un point comme séparateur décimal. N'utilisez pas des milliers de séparateurs. |
150 63.25 10 |
1023 |
Décimal |
quantity
|
Obligatoire. Représente la quantité nette achetée. Ce champ est multiplié par le prix pour déterminer le coût total de cet élément de ligne dans la transaction. Tous les éléments de ligne sont ensuite ajoutés pour déterminer la valeur totale de la commande. |
1 50 100 |
1023 |
Nombre entier |
attribute:currency
|
Un code de devise ISO 4217 contenant trois lettres majuscules pour la transaction. La devise doit être cohérente entre tous les enregistrements d'une transaction. Si aucune devise n'est fournie, la devise par défaut est celle de ce jeu de données. |
USD CAD EUR |
3 |
Chaîne |
attribute:shipStatus
|
Représente le statut de la commande. Les valeurs possibles sont : Expédié, livré, traitement |
expédié delivered traitement |
1023 |
Chaîne |
attribute:quantityReturned
|
Représente le nombre d'articles renvoyés. |
0 25 100 |
1023 |
Chaîne |
Exemple de structure de fichier : Ne pas utiliser le système des identités multiples
| transactionId | userId | purchaseDate | productId | price | quantity | attribute:currency | attribute:emailAddress | attribute:shipStatus | attribute:quantityReturned |
139502841 |
user103925 |
2022-04-12 |
prod001 |
100.12 |
2 |
USD |
test@test.com |
traitement |
0 |
139502841 |
user103925 |
2022-04-12 |
prod001923 |
15.09 |
1 |
USD |
test@test.com |
traitement |
0 |
139502841 |
user103925 |
2022-04-12 |
prod005 |
44 |
1 |
USD |
test@test.com |
traitement |
0 |
492481058 |
user049245 |
2022-04-12T10:23:37Z |
prod999 |
1.00 |
50 |
EUR |
user04925@test.com |
expédié |
10 |
860340254 |
user01499 |
2022-01-30 |
prod002244 |
15.15 |
3 |
AUD |
delivered |
||
860340255 |
user2201 |
2022-03-15 |
prod1101 |
22.99 |
2 |
CAD |
delivered |
Exemple de structure de fichier : Utilisation du système des identités multiples
| transactionId | attribute:emailAddress | attribute:sfcrmLeadId | purchaseDate | productId | price | quantity | attribute:currency | attribute:shipStatus | attribute:quantityReturned |
139502841 |
test@test.com |
2022-04-12 |
prod001 |
100.12 |
2 |
USD |
traitement |
0 |
|
139502841 |
test@test.com |
2022-04-12 |
prod001923 |
15.09 |
1 |
USD |
traitement |
0 |
|
139502841 |
test@test.com |
2022-04-12 |
prod005 |
44 |
1 |
USD |
traitement |
0 |
|
492481058 |
user04925@test.com |
02941850249856 |
2022-04-12T10:23:37Z |
prod999 |
1.00 |
50 |
EUR |
expédié |
10 |
860340254 |
561716831115090 |
2022-01-30 |
prod002244 |
15.15 |
3 |
AUD |
delivered |
||
860340255 |
981361079810570 |
2022-03-15 |
prod1101 |
22.99 |
2 |
CAD |
delivered |
