Vous êtes ici :
Fil de données ETL du produit
Utilisez le fil de données Product ETL pour mettre à jour les produits de votre catalogue et ajouter de nouveaux produits.
À propos de l'ingestion de données de produits
Vous pouvez mettre à jour des produits existants dans votre catalogue en incluant dans le fichier des enregistrements mis à jour avec des ID de produit existants. Lorsque vous incluez des enregistrements avec de nouveaux ID de produit, Personnalisation ajoute les nouveaux produits à votre catalogue.
Les mises à jour de produits via un fil de données ETL, ou le module Marketing Cloud Personalization du kit de développement Salesforce Interactions SDK, ou l'API Event, ne sont pas effectuées lorsqu'un produit est verrouillé. Un produit est verrouillé lorsque vous modifiez manuellement ses informations et enregistrez les modifications. L'hypothèse est qu'une modification manuelle est intentionnelle et a priorité sur toute source de données entrante. Lorsque vous modifiez une page de produit, la page est verrouillée et reste verrouillée si vous enregistrez les modifications.
Pour déterminer si un produit est verrouillé, sélectionnez dans la navigation principale, sélectionnez le produit, puis recherchez l'icône de verrouillage en regard du nom du produit dans le volet de détail. Si le produit est verrouillé, double-cliquez dessus pour le modifier, sélectionnez Déverrouillé dans la liste déroulante en haut à droite, puis cliquez sur Enregistrer. Le déverrouillage d'un produit permet de mettre à jour manuellement les modifications par des fils de données ETL, le module Marketing Cloud Personalization du kit de développement Salesforce Interactions SDK ou l'API Event.
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.
- Chaque produit doit être affiché une seule fois dans un seul enregistrement d'un fichier. Si votre fichier contient plusieurs enregistrements avec le même ID de produit, Personnalisation charge le dernier enregistrement valide du fichier.
- Emplacement est un type spécial d'attribut de catalogue disponible pour les produits. Pour indiquer l'emplacement d'un produit, des informations telles que le point géographique (latitude et longitude), le code de pays, la ville et l'état peuvent être stockées sous forme d'attributs système. Les champs d'emplacement ne sont pas obligatoires, et seules la latitude et la longitude sont dépendantes. Toute autre combinaison de champs d'emplacement définis est acceptable.
- Tous les enregistrements du fichier, pas seulement les enregistrements dont les valeurs ont changé, ont besoin d'une valeur pour chaque cellule. La personnalisation remplace les valeurs existantes pour tous les enregistrements de produit modifiés, y compris les enregistrements qui contiennent des valeurs vides.
- Les noms de champ qui commencent par
attribute:doivent correspondre aux noms d'attribut personnalisés dans la section Attributs de la page .
Format du nom de fichier
product-YYYY-MM-DD_HH-MM-SS.csv
Schéma
| Nom du champ | Description | Exemple de valeurs | Longueur maximale | Type de données |
|---|---|---|---|---|
id
|
Obligatoire. Les ID de produit du fichier doivent correspondre au format des ID de produit dans l'application Personnalisation et le plan du site. Assurez-vous qu'un seul ID est présent dans le fichier. Lorsque le fichier contient plusieurs ID de produit identiques, Personnalisation charge uniquement le contenu de la dernière ligne dans le catalogue. Ce champ est également l'identificateur parent des UGS. | prod1237723 |
255 |
Chaîne |
attribute:<attribute name>
|
Les attributs personnalisés du produit. Les en-têtes de colonne commencent par attribute: et sont suivis du nom de l'attribut tel qu'il est affiché dans la page Produits. La valeur d'en-tête doit correspondre au nom de l'attribut dans le système et les valeurs doivent être conformes au type de données configuré. |
attribute:fit large attribute:length long |
1023 |
N'importe |
relatedCatalogObject:<catalog object
name>
|
Chaque nom d'objet catalogue associé doit correspondre à un type d'objet catalogue configuré dans la page Objets catalogue et profil. Les en-têtes de colonne commencent par « relatedCatalogObject: » suivi d'un nom d'objet catalogue. Un produit peut avoir plusieurs objets catalogue associés dans des colonnes séparées, ou plusieurs valeurs pour le même objet catalogue associé séparées par le caractère pipe dans la même colonne. Un pipe littéral dans l'une des valeurs est représenté par deux caractères pipe dans le fichier. Ce champ remplace la dimension : . |
relatedCatalogObject:Color Bleu|Jaune relatedCatalogObject:Material Cuir |
255 |
Chaîne |
categories
|
Définissez plusieurs catégories en utilisant la délimitation des tuyaux. | Chaussures | Running Homme | Chaussures | Course à pied Femme | Chaussures | Course à pied |
255 |
Chaîne |
skus
|
L'ensemble des UGS du produit, séparées par un caractère pipe. Un pipe littéral dans l'une des valeurs est représenté par deux caractères pipe dans le fichier. Les UGS sont sensibles à la casse. Ce champ est généralement utilisé lorsque toutes les UGS partagent les mêmes informations sur le produit. | sku104272|sku32342|sku33388 |
255 |
Chaîne |
attribute:name
|
Représente le nom du produit et doit contenir au moins un caractère alphanumérique. | Slick New Kicks |
1023 |
Chaîne |
attribute:url
|
Une URL conforme RFC-3986 qui représente la page d'affichage canonique du produit. | https://example.com/products/prod1.html |
1023 |
Chaîne |
attribute:imageUrl
|
Une URL complète pour une image du produit. | https://example.com/img/img1.png |
1023 |
Chaîne |
attribute:description
|
Représente la description du produit et doit contenir au moins un caractère alphanumérique. | Chaussures résistantes et respirantes, très performantes pour les explorateurs progressifs. |
1023 |
Chaîne |
attribute:promotable
|
Ce champ est défini par défaut sur true. Lorsqu'il est défini sur false, Personalization ne renvoie pas le produit dans le système de recommandation Recettes Einstein. Si aucune valeur n'est définie, ce champ est défini par défaut sur true. |
VRAI |
1023 |
Booléen |
attribute:price
|
Le prix de l'offre actuelle du produit à promouvoir auprès des utilisateurs. Utilisez un point comme séparateur décimal. N'utilisez pas des milliers de séparateurs. | 19.99 |
1023 |
Décimal/flottant |
attribute:listPrice
|
Un prix catalogue ou PDSF pour illustrer les économies réalisées par rapport au prix. Utilisez un point comme séparateur décimal. N'utilisez pas des milliers de séparateurs. | 25.00 |
1023 |
Décimal/flottant |
attribute:priceDescription
|
Texte descriptif du prix. | En vente cette semaine seulement |
1023 |
Chaîne |
attribute:margin
|
La marge bénéficiaire du produit. Le prix de vente moins le coût actuel des marchandises. Utilisez un point comme séparateur décimal. N'utilisez pas des milliers de séparateurs. | 2.45 1000.67 |
1023 |
Chaîne |
attribute:inventoryCount
|
Un décompte de l'inventaire des produits. 0 count est considéré comme une rupture de stock et ne peut pas être promu dans les recommandations de produits. Si ce champ est inclus dans le fichier et que la valeur est omise, le champ est défini par défaut sur in-stock (1). |
30 |
1023 |
Nombre entier |
attribute:published
|
Une chaîne de date et d'heure ISO 8601 pour la date de publication du produit. Les décalages de fuseau horaire ne sont pas pris en charge. | 2022-04-12T10:23:37Z |
1023 |
Date |
attribute:expiration
|
Une chaîne de date et d'heure ISO 8601 pour la date d'expiration du produit. Les décalages de fuseau horaire ne sont pas pris en charge. | 2022-04-12T10:23:37Z |
1023 |
Date |
attribute:currency
|
Un code de devise ISO 4217 contenant trois lettres majuscules pour le produit. | USD AUD EUR |
3 |
Chaîne |
attribute:rating
|
La valeur d'évaluation associée au produit. Aucune échelle spécifique n'est requise, cependant, saisissez uniquement la valeur. 9 est valide, 9/10 n'est pas valide. | 4.5 |
1023 |
Décimal/flottant |
attribute:numRatings
|
Le nombre d'évaluations associées au produit. | 57 |
1023 |
Nombre entier |
location:latitude
|
La valeur latitudinale exacte du produit. Obligatoire si location:longitude est inclus. | 43.641472 |
1023 |
Décimal/flottant |
location:longitude
|
La valeur longitudinale exacte du produit. Obligatoire si location:latitude est inclus. | -70.240881 |
1023 |
Décimal/flottant |
location:city
|
Représente le nom de la ville, de la ville ou du village où se trouve le produit. | Boston |
1023 |
Chaîne |
location:state
|
L'état ou la région où se trouve le produit. Aux États-Unis, utilisez l'abréviation postale à deux lettres. | NY ME |
2 |
Chaîne |
location:countryCode
|
Le code ISO 3166 alpha-2 du pays où se trouve le produit. | US |
2 |
Chaîne |
location:postalCode
|
Représente le code postal où se trouve le produit. | 04101 |
1023 |
Chaîne |
attribute:archived
|
Indique si le produit est visible dans le catalogue. Si true, le produit n'est pas visible. La valeur par défaut est false. Si cette colonne est omise dans le fichier, aucune modification n'est apportée à l'attribut. Si aucune valeur n'est définie, ce champ est défini par défaut sur false. |
FALSE false VRAI true |
1023 |
Booléen |
Exemple de fichier
| id | attribute:name | attribute:archived | attribute:url | attribute:imageUrl | attribute:price | attribute:listPrice | attribute:inventoryCount | attribute:description | attribute:currency | attribute:formattedPrice | relatedCatalogObject:SaleStatus | relatedCatalogObject:Gender | catégories | skus |
prod001 |
Lunettes |
FALSE |
http://www.sample.com/products/product001 |
http://www.sample.com/image/product001.jpg |
100.12 |
100.12 |
1 |
Lunettes faites pour bloquer la lumière aveuglante |
USD |
Maintenant 100,12 $ |
OnSale |
Hommes |
Vêtements|Outerwear |
sku1000|sku1001|sku1002 |
prod002 |
Jacket |
FALSE |
http://www.sample.com/products/product002 |
http://www.sample.com/image/product002.jpg |
54.63 |
59 |
1 |
Une veste en cuir noir |
USD |
OnSale |
Men|Women|Unisex |
Vêtements|Outerwear|Cuir |
||
prod003 |
Chemise |
FALSE |
http://www.sample.com/products/product003 |
http://www.sample.com/image/product003.jpg |
10 |
1 |
Un polo bleu |
AUD |
Maintenant 10 $ |
Unisex |
Vêtements|T-shirt |
sku2000|sku2002|sku2004 |
||
prod004 |
Short |
FALSE |
http://www.sample.com/products/product004 |
http://www.sample.com/image/product004.jpg |
33 |
60 |
1 |
Short kaki beige |
EUR |
Maintenant 33 € |
OnSale |
Hommes |
Vêtements|Pantalons|Shorts |
sku300|sku301|sku302|sku399 |
prod005 |
Pantalon |
FALSE |
http://www.sample.com/products/product005 |
http://www.sample.com/image/product005.jpg |
99.98 |
120 |
0 |
Blue jeans |
USD |
Maintenant 99,98 $ |
ClosingSale |
Hommes |
Vêtements|Pantalon |
sku401|sku403|sku411 |
