> 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/generating-ads/banner-ads-static/requesting-banner-ads.md). # Bannerhirdetések lekérése ## Hirdetések lekérése Mivel a termékhirdetések és a bannerek ugyanazon a végponton jönnek létre, ha az elhelyezés kontextusa megegyezik, a termékhirdetéseket a bannerekkel azonos kérésben is lekérheti. A megkapható termékhirdetések számát a(z) `maxNumberOfAds` paraméter meghatározásával lehet konfigurálni. A megkapható banner hirdetések száma a(z) `maxNumberOfAds` tulajdonsággal konfigurálható egyedi slotId értékenként Minden banner hirdetéskéréshez szükséges a(z) `contentStandardId` és a(z) `bannerSlots` , amelyre hirdetéseket kér. Ezenkívül a banner hívásnak tartalmaznia kell a kontextus `customerId`,`sessionId`,`placement`értékét, valamint a(z) `catalogId`. {% hint style="info" %} Észrevehet néhány változást itt! Bevezetünk egy változást abban, ahogyan a banner hirdetéseket kéri a következőtől: Epsilon Retail Media. Ha már integrálta a rendszert, előfordulhat, hogy egy `bannerSlotIds`nevű tulajdonsággal küldi a kérést. Ezt felváltottuk az új `bannerSlots` képességünkkel. Ha át szeretné tekinteni, hogyan kérhet hirdetéseket a(z) `bannerSlotIds` tulajdonsággal, kérjük, navigáljon az oldal aljára. Ez a(z) `bannerSlots` képesség 2022 szeptemberében került bevezetésre. {% endhint %} ### Keresési elhelyezések A keresési elhelyezéseket általában a legegyszerűbb lekérni. Ehhez meg kell adni egy `searchTerm` értéket a kérésben, az alábbi példához hasonlóan: ```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", "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE", "placement": "search", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "searchTerm": "chocolate", "options": { "filterMode": "AndOr" }, "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "bannerSlots": [ { "slotId": "", "maxNumberOfAds": 1 }, { "slotId": "", "maxNumberOfAds": 2 } ], "maxNumberOfAds": 3 } ``` ### Kategória elhelyezések A kategória elhelyezésekhez meg kell adni a következőt: `productFilters` a kérésben. Az alábbiakban egy példa látható arra, hol kell elküldeni a kategóriaszűrőket: ```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", "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE", "placement": "category", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "productFilters": [ ["category:Cupboard/Snacks"] ], "options": { "filterMode": "AndOr" }, "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "bannerSlots": [ { "slotId": "", "maxNumberOfAds": 1 }, { "slotId": "", "maxNumberOfAds": 2 } ], "maxNumberOfAds": 3 } ``` Ahogy a felhasználó további kategóriákat böngész, ennek megfelelően frissítenie kell az API-hívást. ### Keresztértékesítési kategória elhelyezések A keresztértékesítési kategória elhelyezések kérése nagyon hasonlít a kategória elhelyezésekéhez. Meg kell adnia azt a pontos kategóriát, amelyre hirdetéseket kér. Ez általában az az oldal, amelyen éppen tartózkodik. Adja meg a kategóriát a kérés `productFilters` részében. Az alábbi példa megmutatja, hol kell elküldeni a kategóriaszűrőket: ```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", "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE", "placement": "category-cross-sell", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "productFilters": [ ["category:Cupboard/Snacks"] ], "options": { "filterMode": "AndOr" }, "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "bannerSlots": [ { "slotId": "", "maxNumberOfAds": 1 }, { "slotId": "", "maxNumberOfAds": 2 } ], "maxNumberOfAds": 3 } ``` Ahogy a felhasználó további kategóriákat böngész, ennek megfelelően frissítenie kell az API-hívást. {% hint style="info" %} Az organikus és a keresztértékesítési kategória célzás összevonása? Ha az organikus és a keresztértékesítési kategória hirdetéskérést egyetlen elhelyezésben szeretné összevonni, az összevonási és kézbesítési logikát a vásárlók számára kell megvalósítania. Ez az integrátor felelőssége, bár a(z) Epsilon Retail Media szívesen nyújt konzultációt. Általánosságban azt javasoljuk, hogy jelenítse meg az organikus kategória hirdetéseket, és a pozíció-, valamint kategória-keresztértékesítési hirdetéseket az organikus elhelyezések után pozicionálja. {% endhint %} ### Általános egyezésű elhelyezések Az általános elhelyezésekhez, mint például a főoldal vagy a pénztár oldalak, nem szükséges semmilyen `productFilters` megadása a kérésben. Bármilyen szűrő, amelyet a kereskedő meg szeretne adni (akciós, új stb.), megadható a(z) `productFilters` részben annak biztosítására, hogy a(z) Epsilon Retail Media csak a követelményeknek megfelelő hirdetéseket szolgáljon ki, az alábbi példához hasonlóan: ```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", "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE", "placement": "home", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "productFilters": [ [] ], "options": { "filterMode": "AndOr" }, "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "bannerSlots": [ { "slotId": "", "maxNumberOfAds": 1 }, { "slotId": "", "maxNumberOfAds": 2 } ], "maxNumberOfAds": 3 } ``` ### Kérésfejlesztések Javasoljuk, hogy fontolja meg az alábbi fejlesztéseket a felhasználói élmény javítása érdekében. #### Szűrt keresések Ha a vásárló szűri a keresést, kiterjesztheti a kontextust, hogy megadjon `productFilters`értékeket. Az alábbiakban egy példa látható, ahol a vásárló a "Szekrény" kategória és a "Gluténmentes" diétás korlátozás szerint szűr. Ugyanez az elv alkalmazható bármely kategóriára vagy általános egyezésű elhelyezésre is. ```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", "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE", "placement": "search", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "searchTerm": "chocolate", "productFilters": [ ["category:Cupboard"],["dietary:Gluten-free"] ], "options": { "filterMode": "AndOr" }, "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "bannerSlots": [ { "slotId": "", "maxNumberOfAds": 1 }, { "slotId": "", "maxNumberOfAds": 2 } ], "maxNumberOfAds": 3 } ``` #### Szűrés hely alapján Ha szinkronizálja a helyszűrőket a katalógusában, kiterjesztheti a kontextust, hogy megadja a vásárló üzletének helyét a(z) `productFilters`részben, az alábbi példához hasonlóan: ```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", "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE", "placement": "search", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "searchTerm": "chocolate", "productFilters": [ ["category:Cupboard"],["dietary:Gluten-free"],["location:Westenbury"] ], "options": { "filterMode": "AndOr" }, "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "bannerSlots": [ { "slotId": "", "maxNumberOfAds": 1 }, { "slotId": "", "maxNumberOfAds": 2 } ], "maxNumberOfAds": 3 } ``` ### A(z) bannerSlotIds paraméter használata (örökölt) Ha már integrálta a rendszert, előfordulhat, hogy a hirdetéseket a(z) `bannerSlotIds` használatával kéri a(z) `bannerSlots`helyett. Ez egy karakterlánc-tömb, amelyben megadhatja azokat a Bannerhelyeket, amelyekre hirdetéseket kér. Fejlesztettük a képességünket, így több hirdetést is kérhet ugyanarra a Bannerhelyre. Ha érdekli, fel kell fejlesztenie az integrációját a fent vázolt `bannerSlots` módszerre. ```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", "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE", "placement": "search", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "searchTerm": "chocolate", "productFilters": [ ["category:Cupboard"],["dietary:Gluten-free"],["location:Westenbury"] ], "options": { "filterMode": "AndOr" }, "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "bannerSlotIds": [ "","" ], "maxNumberOfAds": 3 } ``` ## A banner hirdetés válasz Minden válasz ugyanazt a JSON-formátumot követi. Ha termékhirdetéseket kér, a(z) `ads` tömb az alábbi példa szerint népesül fel. A bannerek a(z) `banners` tömböt népesítik be, így a tartalom csak a hirdetéssel rendelkező Bannerhelyek esetében tér vissza. ```json { "ads": [ { "id": "display__QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2", "gtin": "7733636", "discount": { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 }, "expiry": "2021-05-12T04:17:50.400902957Z", "position": 1 }, { "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4", "gtin": "7733628", "discount": { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 }, "expiry": "2021-05-12T04:17:50.400908257Z", "position": 2 } ], "banners": [ { "id": "banner_XeemTeq59HapGSp4vccOYfBq_yvc3zMzNjM2", "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "slotId": "", "imageUrl": "https://cdn.flavedo.io/s/-oW-C3cEViSSO2krWkwOBUXOhvUdhHOySx-YQLGZ1lA=", "linkUrl": "https://www.retailer.com/link", "altText": "Your local ice cream", "text": "", "gtins": [ "7733628", "7714107", "7163379", "7733636", "7733657" ], "expiry": "2021-05-17T01:49:17.75503253Z", "tags": {}, "position": 1 }, { "id": "banner_A0KA6mNmFs6sZPb_FvwWe5k6x6c3NzMzNjM3", "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "slotId": "", "imageUrl": "https://cdn.flavedo.io/s/-oW-dfsgrerWkwOBUXOhvUdhHOySx-YQLreGZ1lw=", "linkUrl": "https://www.retailer.com/link", "altText": "Advertisement for pet food.", "text": "", "gtins": [ "16309011", "57312011", "65250011" ], "expiry": "2021-05-17T01:49:17.75503253Z", "tags": {}, "position": 2 } ], "products": [], "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0=" } ``` A(z) `id` mező az Ön hirdetési azonosítója (Ad ID), amelyet a megjelenítési és kattintási jelentésekben használnak. Kérjük, olvassa el a hivatkozást az egyes karakterláncokról szóló további információkért. ### Marketplace sellerId Marketplace eladók regisztrálása esetén egy további `sellerId` értéket láthat hirdetésenként a válaszban. Ez csak akkor jelenik meg, ha a kiszolgált kampány tulajdonosának csapatához van konfigurálva eladó azonosító (seller ID) a felhasználói felületen. Az alábbi példa egy sellerId-val rendelkező és egy anélküli hirdetést mutat be. ```json { "ads": [ { "id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2", "gtin": "7733636", "discount": { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 }, "expiry": "2021-05-12T04:17:50.400902957Z", "position": 1 }, { "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4", "gtin": "7733628", "sellerId": "2834-ascre-2wcr4", "discount": { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 }, "expiry": "2021-05-12T04:17:50.400908257Z", "position": 2 } ], "banners": [ { "id": "banner_XeemTeq59HapGSp4vccOYfBq_yvc3zMzNjM2", "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "slotId": "", "sellerId": "43d-w4-2wcr4", "imageUrl": "https://cdn.flavedo.io/s/-oW-C3cEViSSO2krWkwOBUXOhvUdhHOySx-YQLGZ1lA=", "linkUrl": "https://www.retailer.com/link", "altText": "Your local ice cream", "text": "", "gtins": [ "7733628", "7714107", "7163379", "7733636", "7733657" ], "expiry": "2021-05-17T01:49:17.75503253Z", "tags": {}, "position": 1 }, { "id": "banner_A0KA6mNmFs6sZPb_FvwWe5k6x6c3NzMzNjM3", "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "slotId": "", "imageUrl": "https://cdn.flavedo.io/s/-oW-dfsgrerWkwOBUXOhvUdhHOySx-YQLreGZ1lw=", "linkUrl": "https://www.retailer.com/link", "altText": "Advertisement for pet food.", "text": "", "gtins": [ "16309011", "57312011", "65250011" ], "expiry": "2021-05-17T01:49:17.75503253Z", "tags": {}, "position": 2 } ], "products": [], "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0=" } ``` {% hint style="info" %} Ha bizonytalan az ebben a szakaszban található karakterláncokkal kapcsolatban, kérjük, látogasson el a [Referencia](/retail-media-interface/integration/hu/references/banner-ad-static-reference.md) oldalra. {% endhint %} ### Harmadik féltől származó követőkódok Banner hirdetések esetén a(z) Epsilon Retail Media támogatja a harmadik féltől származó követőkódok átadását a kereskedőnek. Ezeket a kódokat a hirdetők használják teljesítményük megbízható harmadik fél általi igazolására. A következő követőkódok támogatottak: * DoubleVerify * DCM kattintás * DCM megjelenítés * IAS Ha egy kampányhoz van konfigurálva követőkód, az a megfelelő mezőként fog megjelenni az alábbi `tags` objektumban. Kérjük, vegye figyelembe, hogy ha egy kampányhoz nincs kód konfigurálva, a(z) `tags` objektum üres marad. ```json { "ads": [], "banners": [ { "id": "banner_XeemTeq59HapGSp4vccOYfBq_yvc3zMzNjM2", "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9", "slotId": "", "imageUrl": "https://cdn.flavedo.io/s/-oW-C3cEViSSO2krWkwOBUXOhvUdhHOySx-YQLGZ1lA=", "linkUrl": "https://www.retailer.com/link", "altText": "Your local ice cream", "text": "", "gtins": [ "7733628", "7714107", "7163379", "7733636", "7733657" ], "expiry": "2021-05-17T01:49:17.75503253Z", "tags": { "dv": "", "dcmClick": "