> 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/es/data-api/catalog-products-2.md). # Catálogo y productos Para integrarse con Epsilon Retail Media, necesitará al menos un catálogo de productos. ## ¿Qué es un catálogo? Un catálogo es un grupo de productos y sus atributos, utilizado habitualmente para agrupar todos los productos del sitio de un integrador en un solo catálogo. Los anunciantes seleccionan los catálogos en el proceso de creación de la campaña, y sus campañas solo se ejecutarán dentro del catálogo de productos seleccionado. Es una práctica habitual agrupar todos los productos en un solo catálogo para un integrador, lo que facilita la selección a los anunciantes. La creación de varios catálogos se puede utilizar para segmentar la disponibilidad de productos en diferentes minoristas o países con fines de segmentación de campañas. {% hint style="info" %} Si desea crear varios catálogos, póngase en contacto con su Technical Account Manager para debatir las mejores prácticas, ya que puede haber formas mejor admitidas de implementar la segmentación. {% endhint %} {% hint style="warning" %} Si se está integrando en un espacio de nombres de red, debe crear un solo catálogo. {% endhint %} ## ¿Qué son los productos? Los productos son GTIN individuales en el sitio de un integrador. Los productos sincronizados con Epsilon Retail Media se sincronizan con valores de identificación y atributos individuales. Los productos deben representar cada GTIN/SKU en su catálogo de productos actual. Los anunciantes seleccionan los productos en la creación de la campaña, y solo se muestran para la selección los productos relevantes para los catálogos que el anunciante seleccionó. Los productos no deben utilizarse para representar más de un único GTIN de producto. Las variaciones del mismo producto deben aparecer como productos diferentes, p. ej., las variaciones de 200 ml, 600 ml y 2 l de la misma bebida se considerarían tres productos diferentes en Epsilon Retail Media, alineándose con las mejores prácticas existentes del integrador. ## Explicación de los filtros de productos Los filtros de productos se utilizan principalmente para la generación de anuncios, además de contener propiedades como `imageUrl` y el nombre. Al solicitar anuncios a Epsilon Retail Media, enviará un contexto que contiene información relevante de la página que garantiza que se sirvan anuncios relevantes a cada página. La estructura de los filtros depende del integrador, pero lo más importante a tener en cuenta es que estos filtros de productos se enviarán en su contexto de generación de anuncios. Los filtros de productos deben coincidir exactamente con lo que se solicita en la generación de anuncios. A continuación se describe un ejemplo de contexto que contiene `productFilters` : ```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 } ``` Este contexto solo devolverá anuncios de productos que contengan todos los filtros del array correspondiente. {% hint style="info" %} Si desea utilizar valores de puja mínima de categoría, asegúrese de que sus categorías sean fáciles de usar y de entender para los anunciantes que crean campañas, p. ej., category:Keyboards es más fácil de entender que category:12. {% endhint %} ## Proporcione imágenes y nombres de productos Epsilon Retail Media necesita información sobre las imágenes y los nombres de los productos para que se puedan buscar al crear campañas en el portal de Epsilon Retail Media . Estos valores se pueden enviar a Epsilon Retail Media dentro de etiquetas con un formato como el del siguiente ejemplo: ```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" ] } ] } ``` Se ven en varias áreas del portal de Epsilon Retail Media , incluida la selección de productos, como el siguiente ejemplo:
Screen Shot 2021-05-24 at 12.12.31 pm.png

Imagen de referencia

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