> 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/sk/data-api/catalog-products-2.md). # Katalóg a produkty Na integráciu s Epsilon Retail Media, budete potrebovať aspoň jeden katalóg produktov. ## Čo je katalóg? Katalóg je zoskupenie produktov a ich atribútov, ktoré sa najčastejšie používa na zoskupenie všetkých produktov zo stránky integrátora do jedného katalógu. Katalógy si vyberajú inzerenti v procese tvorby kampane a ich kampane sa spustia len v rámci nimi zvoleného katalógu produktov. Bežnou praxou je zoskupiť všetky produkty integrátora do jedného katalógu, čo inzerentom zjednodušuje výber. Vytvorenie viacerých katalógov sa môže použiť na segmentáciu dostupnosti produktov u rôznych predajcov alebo v rôznych krajinách na účely cielenia kampaní. {% hint style="info" %} Ak chcete vytvoriť viacero katalógov, kontaktujte svojho Technical Account Managera a preberte s ním najlepšie postupy, pretože môžu existovať lepšie podporované spôsoby implementácie cielenia. {% endhint %} {% hint style="warning" %} Ak sa integrujete do sieťového namespace, mali by ste vytvoriť jediný katalóg. {% endhint %} ## Čo sú produkty? Produkty sú jednotlivé kódy GTIN na stránke integrátora. Produkty synchronizované s Epsilon Retail Media sa synchronizujú s jednotlivými identifikačnými hodnotami a atribútmi. Produkty by mali reprezentovať každý kód GTIN/SKU vo vašom aktuálnom katalógu produktov. Produkty si vyberajú inzerenti pri tvorbe kampane, pričom na výber sa zobrazujú len produkty relevantné pre katalógy, ktoré inzerent vybral. Produkty by sa nemali používať na reprezentáciu viac ako jedného produktu GTIN. Varianty toho istého produktu by mali byť uvedené ako rôzne produkty, napr. 200 ml, 600 ml a 2 l varianty toho istého nápoja by sa v službe Epsilon Retail Mediapovažovali za tri rôzne produkty, čo je v súlade s osvedčenými postupmi integrátora. ## Vysvetlenie produktových filtrov Produktové filtre sa okrem vlastností, ako sú `imageUrl` a názov, používajú predovšetkým na generovanie reklám. Pri vyžadovaní reklám zo služby Epsilon Retail Mediaodosielate kontext obsahujúci relevantné informácie o stránke, čo zabezpečuje zobrazovanie relevantných reklám na každej stránke. Štruktúra filtrov je na integrátorovi, ale najdôležitejšie je zvážiť, že tieto produktové filtre sa budú odosielať v kontexte generovania reklamy. Produktové filtre by sa mali presne zhodovať s tým, čo sa vyžaduje pri generovaní reklamy. Príklad kontextu obsahujúceho `productFilters` je uvedený nižšie: ```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áti iba reklamy na produkty, ktoré obsahujú všetky filtre v príslušnom poli. {% hint style="info" %} Ak chcete využívať minimálne hodnoty ponúk pre kategórie, uistite sa, že vaše kategórie sú používateľsky prívetivé a ľahko pochopiteľné pre inzerentov vytvárajúcich kampane, napr. category:Keyboards je ľahšie pochopiteľné ako category:12. {% endhint %} ## Poskytovanie obrázkov a názvov produktov Epsilon Retail Media potrebuje informácie o obrázkoch a názvoch produktov, aby sa dali vyhľadávať pri vytváraní kampaní v portáli Epsilon Retail Media . Tieto hodnoty je možné odoslať do Epsilon Retail Media vo vnútri tagov formátovaných ako v nasledujúcom príklade: ```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" ] } ] } ``` Sú viditeľné v rôznych oblastiach portálu Epsilon Retail Media vrátane výberu produktov, ako v príklade nižšie:
Screen Shot 2021-05-24 at 12.12.31 pm.png

Referenčný obrázok

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