> 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/product-ad-reference-1.md). # Produktanzeigen-Referenz Im Folgenden werden die Eigenschaften beschrieben, die in einer Standardanfrage möglich sind, sowie die Antwort, wenn Sie eine Anzeige erhalten. ## Angeforderte Elemente | String | Beschreibung | Erforderlich/Optional | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | | `catalogId` | Ihre Produktkatalog-Kennung für Ihre Website. | Erforderlich | | `customerId` | Die eindeutige Kennung für den Kunden, dem Anzeigen bereitgestellt werden. | Optional | | `filterMode` | Optionale Möglichkeit zur Definition der Struktur Ihrer Anfrage. Weitere Informationen finden Sie unter Filtern bei der Anzeigengenerierung. | Optional, bevorzugt | | `maxNumberOfAds` | Die maximale Anzahl an Anzeigen, die Sie zurückerhalten möchten, bis zu 10. | Erforderlich | | `options` |

Optionale Möglichkeit zur Definition der Struktur Ihrer Anfrage. Weitere Informationen finden Sie unter Filtern bei der Anzeigengenerierung.

Dies ist auch das Objekt, in dem Sie Werbetreibenden-Informationen anfordern können, um lokale Werbegesetze wie die in Europa zu erfüllen 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 Standardintegrationen verwendet. Weitere Informationen finden Sie unter Optionen für den Integrations-Workflow. | Erforderlich bei Standardintegrationen | | `memoryToken` |

Wird für die Seitennummerierung verwendet. Verwenden Sie ein Token aus einer vorherigen Anzeigenanfrage, um sicherzustellen, dass Epsilon Retail Media Ihren Kunden nur neue Anzeigen bereitgestellt werden.

Falls angegeben, Epsilon Retail Media schließt zuvor bereitgestellte Anzeigen in der Anzeigenantwort aus. Siehe Paginierung um mehr zu erfahren.

| Optional | | `dtmCookieId` | Cookies, die von der Website erstellt und gespeichert werden und zur Verfolgung des Nutzerverhaltens auf derselben Domain dienen. | 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 | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.customPayload` |

Diese benutzerdefinierte Nutzlast, die aus der Katalogdatei in die Anzeigengenerierung übernommen werden sollte.

Das Feld sollte ein gültiges JSON-Objekt enthalten, das in ein Byte-Array serialisiert und Base64-codiert ist. Das JSON-Objekt sollte einem Schema entsprechen.

| Benutzerdefiniert je Integration | | `ads.sellerId` | Die eindeutige ID des Verkäufers. Wird nur ausgefüllt, wenn eine sellerId für ein Team festgelegt ist. sellerIds werden normalerweise bei der Registrierung von Marktplatz-Verkäufern verwendet. | `73nns-32sxr-32ss` Benutzerdefiniert je Integration | | `ads.id` |

Die eindeutige ID der Anzeige.
Dies ist eindeutig für jede Anfrage an Epsilon Retail Media und kann nicht im Cache gespeichert werden.

| `display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4` | | `ads.gtin` | Der Produktcode der Anzeige. Dies ist der Produktcode, der in Ihrem Produktkatalog synchronisiert wurde. | `25813383` | | `ads.discount` | Veraltet, kann ignoriert werden. | `{
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
}` | | `ads.position` | Die Position der Anzeige in der Epsilon Retail Media Antwort. Sie sollten diese Position berücksichtigen, falls Kampagnen mit Feste Platzierung genutzt werden. | 1 | | `ads.memoryToken` |

Wird für die Seitennummerierung und Verknüpfung von Anzeigenanfragen verwendet.

Wenn in Ihrer nächsten Anzeigenanfrage für denselben Kontext angegeben, Epsilon Retail Media schließt zuvor bereitgestellte Anzeigen in der Anzeigenantwort aus. Siehe Paginierung um mehr zu erfahren.

| | | `ads.metadata` |

Objekt, das die Werbetreibenden-Informationen enthält, die erforderlich sind, um Werbetreibenden die Einhaltung lokaler Werbegesetze zu ermöglichen, wie z. B. Gesetz über digitale Dienstein Europa.

advertiser wird aus dem Firmennamen im Lieferantenteam übernommen.

onBehalfOf wird vom Finanzier der Anzeige im Lieferantenteam übernommen.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `banners` | Besteht aus Banner-Objekten. Siehe die [Banner-Anzeige (statisch) Referenz](/retail-media-interface/integration/de/references/banner-ad-static-reference.md) um mehr zu erfahren. | `"banners": [],` | | `metadata.warnings` | Objekt, das Warninformationen zur Anzeigenanfrage enthält. Warnt derzeit nur, wenn die maximale Anzahl an 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/product-ad-reference-1.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.