Epsilon Retail Media prend en charge deux types de formats pour la synchronisation des données produit par fichier :

Cette section décrit les structures de chaque format de fichier pour les données de produits que nous traitons dans Epsilon Retail Media.

Taille maximale des fichiers

Epsilon Retail Media prend en charge des fichiers de catalogue qui contiennent au maximum dix millions de produits par détaillant. Cette fonctionnalité permet d'utiliser la plupart des catalogues de la taille de la marketplace.

📘
Avez-vous plus de 10 millions de produits ?
Si votre catalogue dépasse ce volume, Epsilon Retail Media peut évaluer si la taille de votre catalogue peut être prise en charge. Veuillez noter que cela peut également nécessiter des ajustements commerciaux.

Fichiers TSV/CSV

Le tableau ci-dessous liste les noms de colonnes et leur description pour les produits dans un fichier TSV/CSV. Dans ce tableau, nous spécifions également les colonnes obligatoires dans un fichier. Lorsqu'une colonne est obligatoire, ses valeurs doivent être fournies dans chaque ligne.

⚠
️ TSV sans guillemets
Les fichiers TSV ne peuvent pas contenir de guillemets. Lors d'une synchronisation via TSV, assurez-vous de synchroniser les fichiers sans guillemets.

Noms de colonnes et descriptions des données produit dans les fichiers TSV/CSV

Nom de la colonne	Obligatoire/facultatif	Type de données	Description	Exemple
`product_code`	Obligatoire	Texte 50 caractères maximum	Code permettant d'identifier le produit dans votre système. Ce champ est identique aux champs gtin et item dans le cadre de la synchronisation des fichiers API et XML.	F153212AN1
`name`	Obligatoire	Texte 150 caractères maximum	Le nom du produit.	T-shirt autocollant SS - Enfants
`image_url`	Obligatoire	URL 2 048 caractères maximum	Un hyperlien vers l'image d'un produit. L'URL doit être valide.	https://www.retailer.com/product/1234.jpg
`inventory`	Obligatoire	Nombre entier non signé de 32 bits recommandé	Le stock du produit. Si la valeur est de 0, aucune annonce de produit ne sera diffusée pour ce produit.	1
`description`	Obligatoire	Texte 5 000 caractères maximum	La description du produit.	Avec son logo trèfle brodé et ses 3 bandes blanches, le short de sport est une nouveauté Adidas Originals.
`KEY (as a value)`	Obligatoire pour les emplacements de catégories et d'affichages larges	Texte 1 000 caractères maximum par colonne	Si ce type de colonne est utilisé, les détaillants doivent fournir une valeur pour Plusieurs colonnes peuvent présenter cette syntaxe dans un fichier TSV.	Le nom de la colonne peut être « brand » et la valeur de la cellule dans cette colonne peut être « green-fairy ». Cela se traduira par un filtre « brand:green-fairy » sur le produit.
`subClassName`	Obsolète. Requis pour les emplacements de ventes croisées et incitatives	Texte 750 caractères maximum	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 à base de beurre peut cibler le pain, mais il ne ciblera pas les pansements.	Fromage
`xSellSubClassName`	Obsolète. Requis pour les emplacements de ventes croisées et incitatives	Texte 750 caractères maximum	Les noms des sous-classes/catégories dans lesquelles le produit pertinent peut cibler des produits.	Pains, pâtes à tartiner, crackers
`price`	Facultatif	Nombre 2 fixes décimaux recommandés	Le prix d'un produit.	30,00
`brand`	Obligatoire	Texte 70 caractères maximum	La marque du produit.	Tommy Hilfiger
`type`	Obligatoire	Texte 750 caractères maximum	Le type de produit.	Vêtements
`retailer_taxonomy`	Requis pour une meilleure attribution. Ne doit pas contenir d'espaces compris entre `>` caractères	Texte 750 caractères maximum	Votre taxonomie personnelle du produit pour les détaillants.	Hommes > Vêtements homme > Pulls
`google_taxonomy`	Requis pour une meilleure attribution si `retailer_taxonomy` ne peut pas être fourni	Texte 750 caractères maximum	The standard Google taxonomy of the product. More information can be found here: https://www.google.com/basepages/producttype/taxonomy.en-US.txt	Vêtements et accessoires > Vêtements > Hauts
`global_identifier`	Obligatoire	Texte 50 caractères maximum	L'identifiant global du produit.	08719108994761
`global_identifier_type`	Obligatoire	Texte	Le type d'identifiant global.	GTIN
`custom_payload`	Non requis, sauf indication contraire.	Tableau d'octets codés en Base64	Ce champ contient une charge utile personnalisée qui doit être transmise à la génération d'annonces. Le champ doit contenir un objet JSON valide sérialisé dans un tableau d'octets et encodé en Base64. L'objet JSON doit être conforme à un schéma.	Voir la section sur les charges utiles personnalisées.
`hfss`	Facultatif	Booléen	Used to indicate if a product is HFSS or not. This is further leveraged in Epsilon Retail Media's UI. View our HFSS Documentation for more information.	true
`seller_id`	Facultatif	Texte 50 caractères maximum	ID unique du vendeur. Cet identifiant est uniquement requis pour l'onboarding de vendeurs Marketplace. Il n'a pas besoin d'être renseigné pour la vente de produits en dehors de Marketplace. There are additional requirements to integrate seller_ids, please refer to Marketplace sellerId for more information.	aes-de4-ss

Voici un exemple de fichier représenté sous forme de tableau :

`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 d'absinthe Green Fairy 500 ml	https://www.retailer.com/product/1234.jpg	`20`	Ce coffret cadeau Green Fairy absinthe et cuillère est le cadeau parfait pour tout amateur d'absinthe ou de cocktails. Déposez un morceau de sucre sur la cuillère, versez l'absinthe par-dessus et dégustez ce spiritueux de manière traditionnelle !	Cadeaux, Alcool, Coffrets cadeaux	500 ml	République tchèque	Cadeaux, Alcool, Coffrets cadeaux	`5.00`	Green Fairy	Alcool	Cadeaux > Alcool > Coffrets cadeaux	Aliments, boissons et tabac > Boissons > Boissons alcoolisées > Liqueur et spiritueux > Absinthe	8594001443079	7328s-dmie3-9jdae	Coffrets cadeaux	Liqueur

📘
Les fichiers TSV ne peuvent pas contenir de guillemets.

Mise à jour des images des produits

Epsilon met en cache les URL des images afin de garantir des performances cohérentes et de réduire le nombre de requêtes adressées à votre serveur d’images.
Si vous mettez à jour une image sans modifier son URL, vous devez explicitement déclencher une actualisation 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.

Si votre serveur d'images le permet, vous pouvez également forcer un rafraîchissement en ajoutant une chaîne de requête (par exemple, une version ou un horodatage) à l'URL existante. Cela obligera Epsilon à recharger l'image.

📘
Les images sont uniquement utilisées dans l'interface utilisateur
Les images des produits ne sont pas diffusées dans les réponses aux annonces. Toute mise à jour de l'image n'affecte que l'apparence du produit dans l'interface utilisateur d'Epsilon pendant le rafraîchissement du cache.

Fichiers XML : la dépréciation est prévue

❗️
Non disponible pour les nouveaux clients
Ce qui suit est fourni pour les clients historiques qui utilisent encore le format XML. Pour l'intégration de nouveaux catalogues, nous prenons en charge les formats TSV et CSV décrits ci-dessus, ce qui offre une plus grande flexibilité en matière de fichier ainsi que la possibilité de synchroniser le fichier plusieurs fois par jour.

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 leur description. La balise « item » est utilisée pour décrire un produit dans un document XML. Toutes les autres balises associées aux autres champs doivent être insérées à l'intérieur de cette balise.

Balises XML	Obligatoire/facultatif	Description
`item`	Obligatoire	Ces balises servent à décrire les produits. Toutes les autres balises XML d'un même produit doivent être insérées dans cette balise. Un document XML de produits doit contenir une liste de balises item. Ce champ est identique aux champs gtin et product_code dans le cadre de la synchronisation des fichiers API et TSV.
`id`	Obligatoire	Code permettant d'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 le cadre de la synchronisation des fichiers API et XML.
`title`	Obligatoire	Le nom du produit.
`image_link`	Obligatoire 50 caractères maximum	Un hyperlien vers l'image d'un produit. L'URL doit être valide.
`brand`	Obligatoire 70 caractères maximum	La marque du produit.
`availability`	Obligatoire Entier non signé de 32 bits recommandé	Cette balise définit le stock d'un produit. La valeur doit être un nombre.
`description`	Obligatoire 5 000 caractères maximum	Cette balise sert à décrire un produit.
`price`	Facultatif 2 fixes décimaux recommandés	Cette balise sert à définir le prix d'un produit. Si renseignée, la valeur doit être un nombre.
`type`	Facultatif 750 caractères maximum	Le type de produit.
`retailer_taxonomy`	Requis pour une meilleure attribution. Également requis pour les intégrations de catégories. 750 caractères maximum	Votre taxonomie personnelle du produit pour les détaillants. par exemple Hommes > Vêtements homme > Pulls
`google_taxonomy`	Required for enhanced attribution if `retailer_taxonomy` cannot be provided Max 750 characters	The standard Google taxonomy of the product. More information can be found here: https://www.google.com/basepages/producttype/taxonomy.en-US.txt
`global_identifier`	Obligatoire 50 caractères maximum	L'identifiant global du produit. par exemple `08719108994761`
`global_identifier_type`	Obligatoire	Le type d'identifiant global. par exemple `GTIN`
`custom_payload`	Non requis, sauf indication contraire.	Ce champ contient une charge utile personnalisée qui doit être transmise à la génération d'annonces. Le champ doit contenir un objet JSON valide sérialisé dans un tableau d'octets et encodé en Base64. L'objet JSON doit être conforme à un schéma.
`hfss`	Facultatif	Used to indicate if a product is HFSS or not. This is further leveraged in Epsilon Retail Media's UI. View our HFSS Documentation for more information.
`seller_id`	Facultatif 50 caractères maximum	ID unique du vendeur. Cet identifiant est uniquement requis pour l'onboarding de vendeurs Marketplace. Il n'a pas besoin d'être renseigné pour la vente de produits en dehors de Marketplace. There are additional requirements to integrate seller_ids, please refer to Marketplace sellerId for more information.

Voici un exemple de document XML valide comportant ces balises :

<rss>
  <item>
      <id>80591011</id>
      <title>Melissa &amp; Doug Dinosaur Stamp Set, 4yrs+</title>
      <description>Imagine a rugged landscape littered with volcanoes, and full of dinosaurs roaming around</description>
      <image_link>https://www.retailer.com/productImages/image1.jpg</image_link>
      <price>&pound;9.99</price>
      <brand>Melissa &amp; Doug</price>
      <product_type>Food Cupboard</product_type>
      <availability>10</availability>
    	<hfss>true</hfss>
    </item>
    <item>
      <id>87086011</id>
      <title>Waitrose Splits Strawberry Ice Lollies</title>
      <description>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.</description>
			<image_link>https://www.retailer.com/productImages/image2.jpg</image_link>
      <price>&pound;1.25</price>
      <brand>Waitrose</brand>
      <product_type>Frozen Ice Cream Ice Cream Lollies</product_type>
      <availability>20</availability>
      <brand>Waitrose</brand>
      <hfss>false</hfss>
      <seller_id>432un3-sd32s-ssaar</seller_id>
    </item>
</rss>

Charges utiles personnalisées

En quoi consistent les charges utiles personnalisées ?

Custom payloads are fields that are threaded through ‘as-is’ from catalog ingestion to ad serving. No transformations will be applied to the field. However, JSON Schema (https://json-schema.org/) based validation is performed on the field. The payload specification is provided via the link below (JSON Schema notation):

Dans la réponse de l'annonce de produit, la charge utile personnalisée exacte est renvoyée à l'intégrateur dans un champ nommé customPayload. Voici un exemple de charge utile valide :

{
  "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&lt;BR&gt;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&lt;BR&gt;SAVE up to: $1",
      "promoType": "P",
      "offerFlag": true
    }
  ]
}

🚧
Fichier uniquement
Veuillez noter que les charges utiles personnalisées ne sont prises en charge que lors de la synchronisation des produits via un fichier.

Charges utiles personnalisées dans la génération d'annonces

Lorsque vous renvoyez des annonces de produits, la charge utile personnalisée est transmise dans le cadre de l'annonce générée. Les charges utiles publicitaires renvoyées contiendront un champ supplémentaire customPayload qui contiendra un objet JSON respectant les mêmes spécifications que les informations fournies dans le flux.

Voici un exemple de réponse :

{
    "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&lt;BR&gt;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&lt;BR&gt;SAVE up to: $1",
                  "promoType": "P",
                  "offerFlag": true
                }
              ]
            } ,
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2019-12-10T01:46:07.516943179Z"
        }
    ],
    "banners": [],
    "products": []
}

🚧
Étant donné que les charges utiles personnalisées représentent une charge de travail supplémentaire pour notre service de génération d'annonces, veuillez noter que les intégrations de charges utiles personnalisées ne sont pas couvertes par le SLA d'Epsilon Retail Media, sauf indication contraire.