> 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/hu/data-api/catalog-products-2.md). # Katalógus és termékek A(z) Epsilon Retail Media rendszerrel való integrációhoz legalább egy termékkatalógusra lesz szüksége. ## Mi az a katalógus? A katalógus termékek és azok tulajdonságainak csoportja, amelyet leggyakrabban arra használnak, hogy egy integrátor webhelyének összes termékét egyetlen katalógusba gyűjtsék össze. A hirdetők a kampánykészítési folyamat során választják ki a katalógusokat, és kampányaik csak a kiválasztott termékkatalóguson belül fognak futni. Elterjedt gyakorlat, hogy az integrátorok az összes terméket egyetlen katalógusba csoportosítják, ami leegyszerűsíti a kiválasztást a hirdetők számára. Több katalógus létrehozása használható a termékelérhetőség szegmentálására a különböző kereskedőknél vagy országokban, kampánycélzási okokból. {% hint style="info" %} Ha több katalógust szeretne létrehozni, vegye fel a kapcsolatot műszaki ügyfélreferensével (Technical Account Manager) a bevált gyakorlatok megvitatása érdekében, mivel létezhetnek jobban támogatott módok is a célzás megvalósítására. {% endhint %} {% hint style="warning" %} Ha hálózati névtérbe (network namespace) integrál, egyetlen katalógust kell létrehoznia. {% endhint %} ## Mik azok a termékek? A termékek az integrátor webhelyén található egyedi GTIN-ek. A(z) Epsilon Retail Media rendszerrel szinkronizált termékek egyedi azonosító értékekkel és tulajdonságokkal szinkronizálódnak. A termékeknek a jelenlegi termékkatalógusban szereplő egyes GTIN/SKU azonosítókat kell képviselniük. A termékeket a hirdetők választják ki a kampány létrehozása során, és csak a hirdető által kiválasztott katalógusoknak megfelelő termékek jelennek meg a kiválasztáshoz. A termékek nem használhatók egynél több termék GTIN képviseletére. Ugyanazon termék változatait külön termékként kell felsorolni, pl. ugyanazon üdítőital 200 ml-es, 600 ml-es és 2 literes változata három különböző terméknek számít a(z) Epsilon Retail Media rendszerben, igazodva az integrátorok meglévő bevált gyakorlataihoz. ## A termékszűrők magyarázata A termékszűrőket elsősorban hirdetésgenerálásra használják, amellett, hogy olyan tulajdonságokat tartalmaznak, mint a(z) `imageUrl` és a név. Amikor hirdetéseket kér le a(z) Epsilon Retail Media rendszerből, elküld egy kontextust, amely tartalmazza a vonatkozó oldalinformációkat, biztosítva, hogy minden oldalon a megfelelő hirdetések jelenjenek meg. A szűrők szerkezete az integrátortól függ, de a legfontosabb figyelembe veendő szempont az, hogy ezek a termékszűrők elküldésre kerülnek a hirdetésgenerálási kontextusban. A termékszűrőknek pontosan meg kell egyezniük a hirdetésgenerálás során kért adatokkal. Egy példa kontextus, amely a következőket tartalmazza: `productFilters` , az alábbiakban látható: ```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 } ``` Ez a kontextus csak olyan termékekhez ad vissza hirdetéseket, amelyek tartalmazzák a megfelelő tömbben található összes szűrőt. {% hint style="info" %} Ha kategóriánkénti minimális ajánlati értékeket (category minimum bid) szeretne használni, győződjön meg arról, hogy a kategóriák felhasználóbarátak és könnyen érthetők a kampányokat létrehozó hirdetők számára, pl. a category:Keyboards könnyebben érthető, mint a category:12. {% endhint %} ## Képek és terméknevek megadása Epsilon Retail Media rendszernek információra van szüksége a termékképekről és -nevekről, hogy azok kereshetők legyenek a kampányok létrehozásakor a(z) Epsilon Retail Media portálon. Ezek az értékek elküldhetők a(z) Epsilon Retail Media részére a következő példához hasonlóan formázott címkékben (tags): ```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" ] } ] } ``` Megtekinthetők a(z) Epsilon Retail Media portál különböző területein, beleértve a termékválasztót is, az alábbi példához hasonlóan:
Screen Shot 2021-05-24 at 12.12.31 pm.png

Referenciakép

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