|
| `inventory` | Requis | Nombre
Entier non signé 32 bits recommandé
| L'inventaire du produit. Si la valeur est 0, les annonces de produits ne seront pas diffusées pour ce produit. | 1 |
| `description` | Requis | Texte
5000 caractères max.
| La description du produit. | Avec des Trèfles brodés et 3 bandes soulignées en blanc contrastant, le short Sport Sweat est une nouvelle proposition d'Adidas Originals. |
| `KEY (as a value)` | Requis pour les emplacements de catégorie et display large | Texte
1000 caractères max. par colonne
| Si ce type de colonne est utilisé, les distributeurs doivent fournir une valeur pour \.
Vous pouvez avoir plusieurs colonnes avec cette syntaxe dans un fichier TSV.
| Le nom de la colonne peut être « brand » et la valeur de la cellule dans la colonne peut être « green-fairy ». Cela entraînera un filtre « brand:green-fairy » sur le produit. |
| `subClassName` | Obsolète.
Requis pour les emplacements de produits en vente croisée/montée en gamme
| Texte
750 caractères max.
| Le nom de la sous-classe/catégorie dans laquelle se trouve le produit concerné.
Les sous-classes permettent un meilleur ciblage des produits. Par exemple, un produit de type beurre peut cibler le pain, mais ne ciblera pas les pansements.
| Fromage |
| `xSellSubClassName` | Obsolète.
Requis pour les emplacements de produits en vente croisée/montée en gamme
| Texte
750 caractères max.
| Les noms des sous-classes/catégories dans lesquelles le produit concerné est en mesure de cibler des produits. | Pains, Pâtes à tartiner, Crackers |
| `price` | Optionnel | Nombre
2 décimales recommandées
| Le prix d'un produit. | 30.00 |
| `brand` | Requis | Texte
70 caractères max.
| La marque du produit. | Tommy Hilfiger |
| `type` | Requis | Texte
750 caractères max.
| Le type de produit. | Vêtements |
| `retailer_taxonomy` | Requis pour l'attribution améliorée. Ne doit pas contenir d'espaces entre les `>` caractères | Texte
750 caractères max.
| La taxonomie individuelle de votre distributeur pour le produit. | Hommes>Vêtements pour hommes>Pulls |
| `google_taxonomy` | Requis pour l'attribution améliorée si `retailer_taxonomy` ne peut pas être fourni | Texte
750 caractères max.
| La taxonomie Google standard du produit. Plus d'informations peuvent être trouvées ici : | Vêtements et accessoires > Vêtements > Hauts |
| `global_identifier` | Requis | Texte
50 caractères max.
| L'identifiant global du produit. | 08719108994761 |
| `global_identifier_type` | Requis | Texte | Le type d'identifiant global. | GTIN |
| `custom_payload` | Non requis sauf indication contraire. | Tableau d'octets codé en Base64 | Ce champ contient une charge utile personnalisée qui doit être transmise jusqu'à la génération de l'annonce. Le champ doit contenir un objet JSON valide sérialisé dans un tableau d'octets et codé en Base64. L'objet JSON doit se conformer à un schéma. | Consultez la section sur les charges utiles personnalisées. |
| `hfss` | Optionnel | Booléen | Utilisé pour indiquer si un produit est HFSS ou non. Ceci est également exploité dans Epsilon Retail Medial'interface utilisateur de . Consultez notre [Documentation HFSS](/retail-media-interface/integration/fr/feature-integrations/placement-level-product-type-blocking-hfss-support.md) pour plus d'informations. | true |
| `seller_id` | Optionnel | Texte
50 caractères max.
| L'identifiant unique du vendeur. Requis uniquement si vous intégrez des vendeurs de la marketplace. Peut être laissé vide pour les produits ne provenant pas de la marketplace.
Il existe des exigences supplémentaires pour intégrer seller\_ids, veuillez vous référer à sellerId du Marketplace pour plus d'informations.
| aes-de4-ss |
Un exemple de fichier représenté sous forme de tableau est visible ci-dessous :
| `product_code` | `name` | `image_url` | `inventory` | `description` | `filter:Category` | `filter:Size` | `filter:Country` | `groups` | `price` | `brand` | `type` | `retailer_taxonomy` | `google_taxonomy` | `global_identifier` | seller\_id | subClassName | xSellSubClassName |
| -------------- | ----------------------------------------- | ------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------- | ------------------ | ---------------------------------- | ------- | ----------- | ------ | -------------------------------- | ------------------------------------------------------------------------------------------- | ------------------- | ----------------- | ---------------- | ----------------- |
| 80591101 | Coffret cadeau Absinthe Green Fairy 500mL | | `20` | Ce coffret cadeau Absinthe & Cuillère Green Fairy est le cadeau parfait pour tout amateur d'absinthe ou de cocktails. Placez un morceau de sucre sur la cuillère et versez l'absinthe par-dessus pour déguster ce spiritueux de manière authentique ! | Cadeaux, Alcools, Coffrets cadeaux | 500ml | République tchèque | Cadeaux, Alcools, Coffrets cadeaux | `5.00` | Green Fairy | Alcool | Cadeaux>Alcools>Coffrets cadeaux | Nourriture, boissons et tabac>Boissons>Boissons alcoolisées>Spiritueux et liqueurs>Absinthe | 8594001443079 | 7328s-dmie3-9jdae | Coffrets cadeaux | Alcools |
{% hint style="info" %}
Les fichiers TSV ne peuvent pas être au format entre guillemets.
{% endhint %}
## Mise à jour des images de produits
Epsilon met en cache les URL d'images pour garantir des performances constantes et réduire les requêtes vers votre serveur d'images. Si vous mettez à jour une image sans changer son URL, vous devez explicitement déclencher un rafraîchissement dans Epsilon. Pour ce faire :
* Supprimez l'image\_url existante du produit.
* Renvoyez la même image\_url une fois la mise à jour terminée.
Alternativement, si votre serveur d'images le prend en charge, vous pouvez forcer un rafraîchissement en ajoutant une chaîne de requête (par exemple, une version ou un horodatage) à l'URL existante. Cela amènera Epsilon à recharger l'image..
{% hint style="info" %}
Les images sont uniquement utilisées dans l'interface utilisateur
Les images de produits ne sont pas fournies dans les réponses publicitaires. Toute mise à jour d'image n'affecte que la manière dont le produit apparaît dans l'interface utilisateur de Epsilon pendant que le rafraîchissement du cache s'effectue.
{% endhint %}
## Fichiers XML - obsolescence planifiée
{% hint style="danger" %}
️ Obsolète pour les nouveaux clients
Ce qui suit est fourni pour les clients existants utilisant encore le format XML. Pour l'intégration de nouveaux catalogues, nous prenons en charge les formats TSV et CSV documentés ci-dessus, ce qui offre une plus grande flexibilité de fichier ainsi que la possibilité de synchroniser le fichier plusieurs fois par jour.
{% endhint %}
Epsilon Retail Media a défini une liste de balises utilisées pour décrire un document XML pour les produits. Le tableau ci-dessous présente les balises et leurs descriptions. La balise « item » est utilisée pour décrire un produit dans un document XML. Toutes les autres balises pour les autres champs doivent être écrites à l'intérieur de cette balise.
| Balises XML | Requis/optionnel | Description |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `item` | Requis | Cette balise est utilisée pour décrire un produit. Toutes les autres balises XML d'un produit doivent se trouver à l'intérieur de cette balise. Un document XML pour les produits doit contenir une liste de balises item. Ce champ est identique aux champs gtin et product\_code dans la synchronisation de fichiers API et TSV. |
| `id` | Requis | Un code pour identifier le produit dans votre système. Équivalent de `product_code` dans les fichiers TSV. Ce champ est identique aux champs gtin et item dans la synchronisation de fichiers API et XML. |
| `title` | Requis | Le nom du produit. |
| `image_link` | Requis
50 caractères max.
| Un lien hypertexte vers l'image d'un produit. Doit être une URL valide. |
| `brand` | Requis
70 caractères max.
| La marque du produit. |
| `availability` | Requis
Entier non signé 32 bits recommandé
| Cette balise sert à décrire l'inventaire d'un produit. La valeur doit être un nombre. |
| `description` | Requis
5000 caractères max.
| Cette balise sert à décrire la description d'un produit. |
| `price` | Optionnel
2 décimales recommandées
| Cette balise sert à décrire le prix d'un produit. Si la valeur à l'intérieur de la balise est fournie, elle doit être un nombre. |
| `type` | Optionnel
750 caractères max.
| Le type de produit. |
| `retailer_taxonomy` | Requis pour l'attribution avancée. Également requis pour les intégrations de catégories.
750 caractères max.
| Votre taxonomie de détaillant individuelle pour le produit. ex. Hommes>Vêtements pour hommes>Pulls |
| `google_taxonomy` | Requis pour l'attribution améliorée si retailer\_taxonomy ne peut pas être fourni
750 caractères max.
| La taxonomie Google standard du produit. Plus d'informations peuvent être trouvées ici : |
| `global_identifier` | Requis
50 caractères max.
| L'identifiant global du produit. ex. `08719108994761` |
| `global_identifier_type` | Requis | Le type d'identifiant global. ex. `GTIN` |
| `custom_payload` | Non requis sauf indication contraire. | Ce champ contient une charge utile personnalisée qui doit être transmise jusqu'à la génération de l'annonce. Le champ doit contenir un objet JSON valide sérialisé dans un tableau d'octets et codé en Base64. L'objet JSON doit se conformer à un schéma. |
| `hfss` | Optionnel | Utilisé pour indiquer si un produit est HFSS ou non. Ceci est également exploité dans Epsilon Retail Medial'interface utilisateur de . Consultez notre [Documentation HFSS](/retail-media-interface/integration/fr/feature-integrations/placement-level-product-type-blocking-hfss-support.md) pour plus d'informations. |
| `seller_id` | Optionnel
50 caractères max.
| L'identifiant unique du vendeur. Requis uniquement si vous intégrez des vendeurs de la marketplace. Peut être laissé vide pour les produits ne provenant pas de la marketplace.
Il existe des exigences supplémentaires pour intégrer seller\_ids, veuillez vous référer à sellerId du Marketplace pour plus d'informations.
|
Un exemple de document XML valide avec les balises est esquissé ci-dessous :
```xml
-
80591011
Melissa & Doug Dinosaur Stamp Set, 4yrs+
Imagine a rugged landscape littered with volcanoes, and full of dinosaurs roaming around
https://www.retailer.com/productImages/image1.jpg
£9.99
Melissa & Doug
Food Cupboard
10
true
-
87086011
Waitrose Splits Strawberry Ice Lollies
Strawberry splits; Suitable for vegetarians. Strawberry splits vanilla flavoured ice cream with a fruity strawberry ice coating. Our fundamental belief is that few things in life are more important than the food you buy. Good quality is essential.
https://www.retailer.com/productImages/image2.jpg
£1.25
Waitrose
Frozen Ice Cream Ice Cream Lollies
20
Waitrose
false
432un3-sd32s-ssaar
```
## Charges utiles personnalisées
### Que sont les charges utiles personnalisées ?
Les charges utiles personnalisées sont des champs transmis « tels quels » de l'ingestion du catalogue à la diffusion de l'annonce. Aucune transformation ne sera appliquée au champ. Cependant, une validation basée sur le schéma JSON () est effectuée sur le champ. La spécification de la charge utile est fournie via le lien ci-dessous (notation de schéma JSON) :
Dans la réponse de l'annonce produit, la charge utile personnalisée exacte est renvoyée à l'intégrateur dans un champ nommé `customPayload`. Un exemple de charge utile valide est fourni ci-dessous :
```json
{
"id": "102013703",
"upc": "4400000463",
"name": "Bee Farms Honey - 14.4 Oz",
"nutrientName": [
"Kosher"
],
"description": "Honey",
"brand": "Bee Farms",
"imageUrl": "https://www.retailer.com/products/1/image.png",
"productUrl": "https://www.retailer.com/products/1/page.html",
"aisleId": "1_22_2_3",
"departmentName": "Breakfast ",
"aisleName": "Breakfast spreads",
"shelfName": "Honeu",
"salesRank": 481,
"details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.",
"averageWeight": 0,
"displayType": 0,
"stores": [
{
"storeId": "2543",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
},
{
"storeId": "2544",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
}
]
}
```
{% hint style="warning" %}
Fichier uniquement
Veuillez noter que les charges utiles personnalisées ne sont prises en charge que lors de la synchronisation de produits via un fichier.
{% endhint %}
### Payloads personnalisés dans la génération d'annonces
Lors du retour d'annonces de produits, le payload personnalisé est transmis en tant que composant de l'annonce générée. Les payloads d'annonces retournés contiendront un champ supplémentaire `customPayload` qui contiendra un objet JSON respectant la même spécification que les informations fournies dans le flux.
Un exemple de réponse peut être :
```json
{
"ads": [
{
"id": "display_SEY2W7-VZzspoirbw4ANs-r-w6YyODk5MDQ5UA==",
"gtin": "4400000463",
"customPayload": {
"id": "102013703",
"upc": "4400000463",
"name": "Bee Farms Honey - 14.4 Oz",
"nutrientName": [
"Kosher"
],
"description": "Honey",
"brand": "Bee Farms",
"imageUrl": "https://www.retailer.com/products/1/image.png",
"productUrl": "https://www.retailer.com/products/1/page.html",
"aisleId": "1_22_2_3",
"departmentName": "Breakfast ",
"aisleName": "Breakfast spreads",
"shelfName": "Honeu",
"salesRank": 481,
"details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.",
"averageWeight": 0,
"displayType": 0,
"stores": [
{
"storeId": "2543",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
},
{
"storeId": "2544",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
}
]
} ,
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2019-12-10T01:46:07.516943179Z"
}
],
"banners": [],
"products": []
}
```
{% hint style="warning" %}
Comme les payloads personnalisés représentent une charge de travail supplémentaire pour notre service de génération d'annonces, veuillez noter que les intégrations de payloads personnalisés ne sont pas soumises au Epsilon Retail Media SLA, sauf indication contraire.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/integration/fr/data-api/catalog-products-2/syncing-catalog-products-via-file.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.