> 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/de/generating-ads/banner-ads-static/requesting-banner-ads.md). # Banner-Anzeigen anfordern ## Anzeigen anfordern Da Produktanzeigen und Banner auf demselben Endpunkt generiert werden, können Sie Produktanzeigen in derselben Anfrage wie Banner anfordern, wenn der Kontext Ihrer Platzierung derselbe ist. Die Anzahl der Produktanzeigen, die Sie erhalten können, wird durch Definieren des `maxNumberOfAds` -Parameters konfiguriert. Die Anzahl der Banner-Anzeigen, die Sie erhalten können, kann mit der `maxNumberOfAds` -Eigenschaft pro eindeutiger slotId konfiguriert werden. Alle Banner-Anzeigenanfragen erfordern die `contentStandardId` und die `bannerSlots` , für die Sie Anzeigen anfordern. Darüber hinaus sollte Ihr Banner-Aufruf den Kontext `customerId`,`sessionId`,`placement`, und `catalogId`. {% hint style="info" %} Sie werden hier möglicherweise einige Änderungen bemerken! Wir führen eine Änderung an der Art und Weise ein, wie Sie Banner-Anzeigen anfordern von Epsilon Retail Media. Wenn Sie bereits integriert sind, fordern Sie möglicherweise mit einer Eigenschaft namens `bannerSlotIds`an. Wir haben dies durch unsere neue `bannerSlots` -Funktion ersetzt. Wenn Sie überprüfen möchten, wie Sie Anzeigen mit der `bannerSlotIds` -Eigenschaft anfordern, navigieren Sie bitte an das Ende dieser Seite. Diese `bannerSlots` -Funktion wurde im September 2022 eingeführt. {% endhint %} ### Such-Platzierungen Such-Platzierungen sind in der Regel am einfachsten anzufordern. Sie erfordern, dass ein `searchTerm` in der Anfrage angegeben wird, wie im folgenden Beispiel: ```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 } ``` ### Kategorie-Platzierungen Kategorie-Platzierungen erfordern, dass `productFilters` in der Anfrage angegeben wird. Nachfolgend finden Sie ein Beispiel dafür, wo Sie die Kategoriefilter senden würden: ```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 } ``` Wenn zusätzliche Kategorien durchsucht werden, sollten Sie Ihren API-Aufruf entsprechend aktualisieren. ### Cross-Selling-Kategorie-Platzierungen Cross-Selling-Kategorie-Platzierungen haben eine sehr ähnliche Anfrage wie Kategorie-Platzierungen. Sie müssen die genaue Kategorie angeben, für die Sie Anzeigen anfordern. Dies ist in der Regel die Seite, auf der Sie sich befinden. Geben Sie die Kategorie im `productFilters` der Anfrage an. Das folgende Beispiel zeigt, wo Sie die Kategoriefilter senden würden: ```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 } ``` Wenn zusätzliche Kategorien durchsucht werden, müssen Sie Ihren API-Aufruf entsprechend aktualisieren. {% hint style="info" %} Zusammenführung von organischem und Cross-Selling-Kategorie-Targeting? Wenn Sie eine organische und eine Cross-Selling-Kategorie-Anzeigenanfrage in einer einzigen Platzierung zusammenführen möchten, müssen Sie eine Zusammenführungs- und Auslieferungslogik für Ihre Kunden implementieren. Dies liegt in der Verantwortung des Integrators, obwohl Epsilon Retail Media gerne konsultiert werden können. Im Allgemeinen empfehlen wir Ihnen, organische Kategorie-Anzeigen anzuzeigen und Positions- und Kategorie-Cross-Selling-Anzeigen nach den organischen Platzierungen zu positionieren. {% endhint %} ### Broad-Match-Platzierungen Breite Platzierungen wie Start- oder Checkout-Seiten erfordern keine Angabe von `productFilters` in der Anfrage. Alle Filter, die der Händler angeben möchte (im Angebot, neu usw.), können im `productFilters` angegeben werden, um sicherzustellen, dass Epsilon Retail Media nur Anzeigen innerhalb der Anforderungen ausliefern, wie im folgenden Beispiel: ```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 } ``` ### Anfrage-Erweiterungen Wir raten Ihnen, die folgenden Erweiterungen in Betracht zu ziehen, um Ihre Benutzererfahrung zu verbessern. #### Gefilterte Suchen Wenn Ihr Kunde seine Suche filtert, können Sie Ihren Kontext erweitern, um `productFilters`bereitzustellen. Nachfolgend finden Sie ein Beispiel, bei dem der Kunde nach der Kategorie "Schrank" und der Einschränkung der Ernährungsweise "Glutenfrei" filtert. Dasselbe Prinzip kann auf jede Kategorie oder Broad-Match-Platzierung angewendet werden. ```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 } ``` #### Filtern nach Standort Wenn Sie Standortfilter in Ihrem Katalog synchronisieren, können Sie Ihren Kontext erweitern, um den Filialstandort des Kunden im `productFilters`bereitzustellen, wie im folgenden Beispiel: ```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 } ``` ### Verwendung des Parameters bannerSlotIds (Legacy) Wenn Sie bereits integriert sind, fordern Sie möglicherweise Anzeigen mit `bannerSlotIds` anstelle von `bannerSlots`an. Dies ist ein Array von Zeichenfolgen, in dem Sie die Banner-Platzierungen angeben, für die Sie Anzeigen benötigen. Wir haben unsere Funktion verbessert, sodass Sie mehr als eine Anzeige für dieselbe Banner-Platzierung anfordern können. Wenn Sie interessiert sind, müssen Sie Ihre Integration auf die oben beschriebene `bannerSlots` -Methode erweitern. ```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 } ``` ## Die Banner-Anzeigen-Antwort Alle Antworten folgen demselben JSON-Format. Wenn Sie Produktanzeigen anfordern, wird das `ads` -Array wie im folgenden Beispiel befüllt. Banner befüllen das `banners` -Array, sodass Inhalte nur für Banner-Platzierungen mit Anzeigen zurückgegeben werden. ```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=" } ``` Das Feld `id` ist Ihre Anzeigen-ID, die in Impression- und Klick-Berichten verwendet wird. Weitere Informationen zu den einzelnen Zeichenfolgen finden Sie in der Referenz. ### Marketplace sellerId Beim Onboarding von Marketplace-Verkäufern wird möglicherweise eine zusätzliche `sellerId` pro Anzeige in der Antwort angezeigt. Dies erscheint nur, wenn das Team, dem die geschaltete Kampagne gehört, eine seller ID in der Benutzeroberfläche konfiguriert hat. Das folgende Beispiel zeigt eine Anzeige mit einer sellerId und eine ohne. ```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" %} Wenn Sie sich bezüglich der Zeichenfolgen in diesem Abschnitt unsicher sind, besuchen Sie bitte die Seite [Referenz](/retail-media-interface/integration/de/references/banner-ad-static-reference.md) . {% endhint %} ### Tracking-Tags von Drittanbietern Für Banner-Anzeigen unterstützt Epsilon Retail Media die Weitergabe von Tracking-Tags von Drittanbietern an den Händler. Diese Tags werden von Werbetreibenden verwendet, um ihre Leistung durch einen vertrauenswürdigen Drittanbieter zu überprüfen. Die folgenden Tracking-Tags werden unterstützt: * DoubleVerify * DCM Click * DCM Impression * IAS Wenn für eine Kampagne ein Tracking-Tag konfiguriert ist, wird es als entsprechendes Feld im folgenden `tags` -Objekt dargestellt. Bitte beachten Sie: Wenn für eine Kampagne kein Tag konfiguriert ist, bleibt das `tags` -Objekt leer. ```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": "