> 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/references/banner-ad-static-reference.md).
# Banneranzeigen-Referenz (statisch)
Im Folgenden werden die Eigenschaften beschrieben, die in einer Standardanfrage möglich sind, wie beschrieben in [Banner-Anzeigen anfordern](/retail-media-interface/integration/de/generating-ads/banner-ads-static/requesting-banner-ads.md) für Ihre Anfrage und die Antwort, wenn Sie eine Anzeige erhalten.
{% hint style="info" %}
Banner-Anzeigen werden über denselben `/generate` Endpunkt wie Produktanzeigen angefordert. Eine einzelne Anfrage kann verwendet werden, um beide Anzeigentypen abzurufen.
{% endhint %}
## Angeforderte Elemente
| String | Beschreibung | Erforderlich/Optional |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `bannerSlots` | Ein Array von Banner-Platzierungen, für die Sie Banner-Anzeigen erhalten möchten. Indem Sie eine maxNumberOfAds für die Banner-Platzierungen angeben, können Sie mehr als ein Banner für die Platzierung abrufen. Ein solcher Anwendungsfall wären Karussell-Platzierungen. | Erforderlich |
| `bannerSlotIds` | Ein Array von Banner-Platzierungen, für die Sie Banner-Anzeigen erhalten möchten | Erforderlich, ersetzt durch bannerSlots |
| `catalogId` | Ihre Produktkatalog-Kennung für Ihre Website. | Erforderlich |
| `contentStandardId` | Die Inhaltsstandard-Kennung für Ihre Website. | Erforderlich |
| `customerId` | Die eindeutige Kennung für den Kunden, dem Anzeigen ausgeliert werden. | Optional |
| `filterMode` | Optionale Möglichkeit zur Definition der Struktur Ihrer Anfrage. Siehe [Anzeigengenerierungsfilterung](/retail-media-interface/integration/de/data-api/api-overview/ad-generation-filtering-1.md) für weitere Informationen. | Optional, bevorzugt |
| `maxNumberOfAds` | Die maximale Anzahl von Produktanzeigen, die Sie zurückerhalten möchten, bis zu 15. | Erforderlich, ermöglicht die Bereitstellung von Produktanzeigen in derselben Anfrage. Wenn keine Produktanzeigen gewünscht werden, setzen Sie auf `0` |
| `options` | Optionale Möglichkeit zur Definition der Struktur Ihrer Anfrage. Siehe Anzeigengenerierungsfilterung für weitere Informationen.
Dies ist auch das Objekt, in dem Sie Werbetreibenden-Informationen anfordern können, um lokale Werbegesetze zu erfüllen, wie z. B. Europas Gesetz über digitale Dienste .
| Optional, bevorzugt |
| `placement` | Die eindeutige Platzierung, für die Sie Anzeigen anfordern. | Erforderlich |
| `productFilters` | Alle für Ihre Anfrage relevanten Produktfilter. Wie etwa eine Kategorie, ein Standort oder eine Größe. | Erforderlich |
| `sessionId` | Die eindeutige Kennung der Sitzung des Kunden. Wird für die Zuordnung in Standard-Integrationen verwendet. Überprüfen Sie die Integrations-Workflow-Optionen für weitere Informationen. | Erforderlich bei Standard-Integrationen |
| `dtmCookieId` | Cookies, die von der Website erstellt und gespeichert werden und zur Verfolgung des Nutzerverhaltens auf derselben Domain verwendet werden. | Optional |
| `audience` | Gibt spezifische Zielgruppensegmente an, denen der Käufer angehört. Nur relevant bei Verwendung von [Zielgruppen-Targeting-Option 3](/retail-media-interface/integration/de/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Optional |
## Zurückgegebene Elemente
| String | Beschreibung | Beispielwert |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `banners.altText` | Alternativtext für das Hero-Image für den seltenen Fall, dass es nicht angezeigt wird. | `Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.` |
| `banners.contentStandardId` | Die Inhaltsstandard-Kennung für Ihre Website. | \`4ffb80ba-b9a9-4567-8069-79b2eca93473 |
| `banners.expiry` | Ablauf der Anzeige. Dies ist der späteste Zeitpunkt, an dem ein Klick gemeldet werden kann an Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` |
| `banners.id` | Die eindeutige ID der Anzeige.
Dies ist eindeutig für jede Anfrage an Epsilon Retail Media und kann nicht zwischengespeichert werden.
| `banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=` |
| `banners.imageUrl` | Der Bild-Link des Banners. | `[]\() |
| `banners.gtins` | Ein Array von bis zu 20 Produktcodes, die aus den beworbenen Produkten der Kampagne ausgewählt wurden. | `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` |
| `banners.linkUrl` | Die URL, die vom Banner weitergeleitet wird, wenn der Kunde auf das Banner klickt. | ` |
| `banners.slotId` | Die ID der spezifischen Platzierung für das von Ihnen angeforderte Banner. | `Category_Top` |
| `banners.tags` | Dieses Feld gibt alle Drittanbieter-Tags zurück, die vom Werbetreibenden in seiner Kampagne eingegeben wurden. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` |
| `banners.text` | Wird in maßgeschneiderten Integrationen als zusätzliches Textfeld verwendet. | |
| `banners.position` | Die Position der Anzeige in der Epsilon Retail Media Antwort. Sie sollten diese Position berücksichtigen, falls Feste Platzierung-Kampagnen genutzt werden. | 1 |
| `banners.sellerId` | Die eindeutige ID des Verkäufers. Wird nur ausgefüllt, wenn eine sellerId für ein Team festgelegt ist. sellerIds werden typischerweise beim Onboarding von Marketplace-Verkäufern verwendet. | `73nns-32sxr-32ss` Benutzerdefiniert pro Integration |
| `banners.metadata` | Objekt mit den Informationen zum Werbetreibenden, die erforderlich sind, um Werbetreibenden dabei zu helfen, lokale Werbegesetze wie das Gesetz über digitale Dienste in Europa einzuhalten.
advertiser wird aus dem Firmennamen im Lieferantenteam übernommen.
onBehalfOf wird vom Finanzierer der Anzeige im Lieferantenteam übernommen.
| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` |
| `metadata.warnings` | Objekt, das Warninformationen zur Anzeigenanfrage enthält. Warnt derzeit nur, wenn die maximale Anzahl von Segmenten überschritten wird. | `"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}` |
---
# 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/de/references/banner-ad-static-reference.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.