> 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/pt-br/data-api/catalog-products-2.md). # Catálogo e produtos Para integrar com o Epsilon Retail Media, você precisará de pelo menos um catálogo de produtos. ## O que é um catálogo? Um catálogo é um agrupamento de produtos e seus atributos, mais comumente usado para agrupar todos os produtos do site de um integrador em um único catálogo. Os catálogos são selecionados pelos anunciantes no processo de criação da campanha, e suas campanhas serão veiculadas apenas dentro do catálogo de produtos selecionado. É uma prática comum que todos os produtos sejam agrupados em um único catálogo para um integrador, tornando a seleção simples para os anunciantes. A criação de vários catálogos pode ser usada para segmentar a disponibilidade de produtos em diferentes varejistas ou países para fins de direcionamento de campanha. {% hint style="info" %} Se você deseja criar vários catálogos, entre em contato com seu Technical Account Manager para discutir as melhores práticas, pois pode haver maneiras mais adequadas de implementar o direcionamento. {% endhint %} {% hint style="warning" %} Se você estiver integrando a um namespace de rede, deverá criar um único catálogo. {% endhint %} ## O que são produtos? Produtos são GTINs individuais no site de um integrador. Produtos sincronizados com o Epsilon Retail Media são sincronizados com valores e atributos identificadores individuais. Os produtos devem representar cada GTIN/SKU em seu catálogo de produtos atual. Os produtos são selecionados pelos anunciantes na criação da campanha, sendo exibidos para seleção apenas os produtos relevantes para os catálogos que o anunciante selecionou. Os produtos não devem ser usados para representar mais do que um único GTIN de produto. Variações do mesmo produto devem ser listadas como produtos diferentes, por exemplo, variações de 200 ml, 600 ml e 2 L do mesmo produto de bebida seriam consideradas como três produtos diferentes no Epsilon Retail Media, alinhando-se às melhores práticas existentes do integrador. ## Explicação sobre filtros de produtos Os filtros de produtos são usados principalmente para a geração de anúncios, além de conterem propriedades como `imageUrl` e nome. Ao solicitar anúncios do Epsilon Retail Media, você enviará um contexto contendo informações relevantes da página, o que garante que anúncios relevantes sejam exibidos em cada página. A estrutura dos filtros fica a critério do integrador, mas o aspecto mais importante a considerar é que esses filtros de produtos serão enviados em seu contexto de geração de anúncios. Os filtros de produtos devem corresponder exatamente ao que está sendo solicitado na geração de anúncios. Um exemplo de contexto contendo `productFilters` está descrito abaixo: ```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 retornará apenas anúncios de produtos que contenham todos os filtros na matriz relevante. {% hint style="info" %} Se quiser utilizar valores de lance mínimo por categoria, certifique-se de que suas categorias sejam fáceis de usar e fáceis de entender para os anunciantes que estão criando campanhas, por exemplo, category:Keyboards é mais fácil de entender do que category:12. {% endhint %} ## Fornecimento de imagens e nomes de produtos Epsilon Retail Media precisa de informações sobre imagens e nomes de produtos para torná-los pesquisáveis ao criar campanhas no portal do Epsilon Retail Media . Esses valores podem ser enviados para o Epsilon Retail Media dentro de tags formatadas como no exemplo a seguir: ```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" ] } ] } ``` Eles são vistos em várias áreas do portal do Epsilon Retail Media , incluindo a seleção de produtos, como no exemplo abaixo:
Screen Shot 2021-05-24 at 12.12.31 pm.png

Imagem de referência

--- # 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/pt-br/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.