> 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/cs/data-api/catalog-products-2.md). # Katalog a produkty Pro integraci s Epsilon Retail Mediabudete potřebovat alespoň jeden katalog produktů. ## Co je to katalog? Katalog je seskupení produktů a jejich atributů, které se nejčastěji používá k seskupení všech produktů na webu integrátora do jednoho jediného katalogu. Katalogy vybírají inzerenti v procesu vytváření kampaně a jejich kampaně poběží pouze v rámci jimi vybraného katalogu produktů. Běžnou praxí je seskupit všechny produkty do jednoho katalogu pro jednoho integrátora, což inzerentům zjednodušuje výběr. Vytvoření více katalogů lze použít k segmentaci dostupnosti produktů u různých maloobchodníků nebo v různých zemích pro účely cílení kampaní. {% hint style="info" %} Pokud chcete vytvořit více katalogů, kontaktujte svého Technical Account Managera a projednejte s ním osvědčené postupy, protože mohou existovat lépe podporované způsoby implementace cílení. {% endhint %} {% hint style="warning" %} Pokud integrujete do jmenného prostoru sítě (network namespace), měli byste vytvořit jediný katalog. {% endhint %} ## Co jsou to produkty? Produkty jsou jednotlivá GTIN na webu integrátora. Produkty synchronizované s Epsilon Retail Media jsou synchronizovány s jednotlivými identifikačními hodnotami a atributy. Produkty by měly reprezentovat každé GTIN/SKU ve vašem stávajícím katalogu produktů. Produkty vybírají inzerenti při vytváření kampaně, přičemž k výběru se zobrazují pouze produkty relevantní pro katalogy, které inzerent vybral. Produkty by neměly být používány k reprezentaci více než jednoho produktového GTIN. Varianty téhož produktu by měly být uvedeny jako různé produkty, např. varianty 200 ml, 600 ml a 2 l téhož nápoje by byly v považovány za tři různé produkty Epsilon Retail Mediav souladu со stávajícími osvědčenými postupy integrátora. ## Vysvětlení filtrů produktů Filtry produktů se primárně používají pro generování reklam a navíc obsahují vlastnosti, jako je `imageUrl` a název. Při vyžádání reklam z Epsilon Retail Mediaodesíláte kontext obsahující relevantní informace o stránce, což zajišťuje, že se na každé stránce zobrazí relevantní reklamy. Struktura filtrů je na integrátorovi, ale nejdůležitější věcí, kterou je třeba zvážit, je, že tyto filtry produktů budou odeslány ve vašem kontextu generování reklam. Filtry produktů by se měly přesně shodovat s tím, co je vyžadováno při generování reklam. Příklad kontextu obsahujícího `productFilters` je uveden níže: ```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 } ``` Tento kontext vrátí pouze reklamy na produkty, které obsahují všechny filtry v příslušném poli. {% hint style="info" %} Pokud chcete využít minimální hodnoty nabídek pro kategorie, ujistěte se, že jsou vaše kategorie uživatelsky přívětivé a snadno srozumitelné pro inzerenty vytvářející kampaně, např. category:Keyboards je srozumitelnější než category:12. {% endhint %} ## Poskytování obrázků a názvů produktů Epsilon Retail Media potřebuje informace o obrázcích a názvech produktů, aby je bylo možné vyhledávat při vytváření kampaní v portálu Epsilon Retail Media . Tyto hodnoty lze odeslat do Epsilon Retail Media uvnitř tagů naformátovaných podle následujícího příkladu: ```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" ] } ] } ``` Jsou viditelné v různých oblastech portálu Epsilon Retail Media , včetně výběru produktů, jak ukazuje příklad níže:
Screen Shot 2021-05-24 at 12.12.31 pm.png

Referenční obrázek

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