> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/fr/data-api/catalog-products-2.md). # Catalogue et produits Pour s'intégrer à Epsilon Retail Media, vous aurez besoin d'au moins un catalogue de produits. ## Qu'est-ce qu'un catalogue ? Un catalogue est un regroupement de produits et de leurs attributs, le plus souvent utilisé pour regrouper tous les produits du site d'un intégrateur en un seul catalogue. Les catalogues sont sélectionnés par les annonceurs lors du processus de création de campagne, et leurs campagnes ne s'exécuteront que dans le catalogue de produits sélectionné. Il est d'usage que tous les produits soient regroupés dans un seul catalogue pour un intégrateur, ce qui simplifie la sélection pour les annonceurs. La création de plusieurs catalogues peut être utilisée pour segmenter la disponibilité des produits chez différents détaillants ou dans différents pays à des fins de ciblage de campagne. {% hint style="info" %} Si vous souhaitez créer plusieurs catalogues, contactez votre Technical Account Manager pour discuter des meilleures pratiques, car il peut exister de meilleurs moyens pour mettre en œuvre le ciblage. {% endhint %} {% hint style="warning" %} Si vous vous intégrez dans un espace de noms de réseau, vous devez créer un seul catalogue. {% endhint %} ## Que sont les produits ? Les produits sont des GTIN individuels sur le site d'un intégrateur. Les produits synchronisés avec Epsilon Retail Media sont synchronisés avec des valeurs d'identification et des attributs individuels. Les produits doivent représenter chaque GTIN/SKU de votre catalogue de produits actuel. Les produits sont sélectionnés par les annonceurs lors de la création de la campagne, seuls les produits pertinents pour les catalogues sélectionnés par l'annonceur étant affichés pour la sélection. Les produits ne doivent pas être utilisés pour représenter plus d'un seul GTIN de produit. Les variations d'un même produit doivent être répertoriées comme des produits différents, par exemple les déclinaisons de 200 ml, 600 ml et 2 L d'une même boisson seraient considérées comme trois produits différents dans Epsilon Retail Media, conformément aux meilleures pratiques d'intégration existantes. ## Explication des filtres de produits Les filtres de produits sont principalement utilisés pour la génération d'annonces, en plus de contenir des propriétés telles que `imageUrl` et le nom. Lors de la demande d'annonces auprès de Epsilon Retail Media, vous enverrez un contexte contenant les informations de page pertinentes, ce qui garantit que des annonces pertinentes sont diffusées sur chaque page. La structure des filtres dépend de l'intégrateur, mais le point le plus important à prendre en compte est que ces filtres de produits seront envoyés dans votre contexte de génération d'annonces. Les filtres de produits doivent correspondre exactement à ce qui est demandé lors de la génération d'annonces. Un exemple de contexte contenant `productFilters` est décrit ci-dessous : ```http POST $BASE_URL/v1/ads/generate HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "customerId": "wertg5432a", "sessionId": "ec9-4e07-881d-3e9", "placement": "search", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "searchTerm": "chocolate", "productFilters": [ ["category:Cupboard"],["dietary:Gluten-free"] ], "options": { "filterMode": "AndOr" }, "maxNumberOfAds": 3 } ``` Ce contexte ne renverra que des annonces pour des produits contenant tous les filtres de l'tableau pertinent. {% hint style="info" %} Si vous souhaitez utiliser des valeurs d'enchère minimale par catégorie, assurez-vous que vos catégories sont conviviales et faciles à comprendre pour les annonceurs qui créent des campagnes, par exemple category:Keyboards est plus facile à comprendre que category:12. {% endhint %} ## Fournir des images et des noms de produits Epsilon Retail Media a besoin d'informations sur les images et les noms de produits pour les rendre recherchables lors de la création de campagnes dans le Epsilon Retail Media portail. Ces valeurs peuvent être envoyées à Epsilon Retail Media dans des balises formatées comme dans l'exemple suivant : ```http POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "catalogProducts": [ { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 50, "price": "19.99", "tags": [ ""imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0" ] } ] } ``` Elles sont visibles dans différentes sections du Epsilon Retail Media portail, y compris la sélection de produits, comme dans l'exemple ci-dessous :
Screen Shot 2021-05-24 at 12.12.31 pm.png

Image de référence

--- # 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.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.