> 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/data-api/catalog-products-2.md). # Katalog & Produkte Um die Integration mit Epsilon Retail Mediadurchzuführen, benötigen Sie mindestens einen Produktkatalog. ## Was ist ein Katalog? Ein Katalog ist eine Gruppierung von Produkten und deren Attributen, die am häufigsten verwendet wird, um alle Produkte der Website eines Integrators in einem einzigen Katalog zusammenzufassen. Kataloge werden von Werbetreibenden im Kampagnenerstellungsprozess ausgewählt, und ihre Kampagnen werden nur innerhalb des von ihnen ausgewählten Produktkatalogs geschaltet. Gängige Praxis ist es, alle Produkte für einen Integrator in einem einzigen Katalog zusammenzufassen, um Werbetreibenden die Auswahl zu erleichtern. Die Erstellung mehrerer Kataloge kann genutzt werden, um die Produktverfügbarkeit in verschiedenen Einzelhändlern oder Ländern für Kampagnen-Targeting-Zwecke zu segmentieren. {% hint style="info" %} Wenn Sie mehrere Kataloge erstellen möchten, wenden Sie sich an Ihren Technical Account Manager, um Best Practices zu besprechen, da es möglicherweise besser unterstützte Möglichkeiten zur Implementierung von Targeting gibt. {% endhint %} {% hint style="warning" %} Wenn Sie eine Integration in einen Netzwerk-Namespace durchführen, sollten Sie einen einzelnen Katalog erstellen. {% endhint %} ## Was sind Produkte? Produkte sind einzelne GTINs auf der Website eines Integrators. Produkte, die mit Epsilon Retail Media synchronisiert werden, werden mit individuellen Identifikationswerten und Attributen synchronisiert. Produkte sollten jede GTIN/SKU in Ihrem aktuellen Produktkatalog darstellen. Produkte werden von Werbetreibenden bei der Kampagnenerstellung ausgewählt, wobei nur die Produkte angezeigt werden, die für die vom Werbetreibenden ausgewählten Kataloge relevant sind. Produkte sollten nicht verwendet werden, um mehr als eine einzelne Produkt-GTIN darzustellen. Variationen desselben Produkts sollten als unterschiedliche Produkte aufgeführt werden, z. B. würden 200-ml-, 600-ml- und 2-L-Variationen desselben Getränkeprodukts als drei verschiedene Produkte in Epsilon Retail Mediaangesehen werden, was den bestehenden Best Practices für Integratoren entspricht. ## Produktfilter erklärt Produktfilter werden in erster Linie für die Anzeigengenerierung verwendet, zusätzlich zum Enthalten von Eigenschaften wie `imageUrl` und Name. Wenn Sie Anzeigen von Epsilon Retail Mediaanfordern, senden Sie einen Kontext mit relevanten Seiteninformationen, der sicherstellt, dass für jede Seite relevante Anzeigen ausgeliefert werden. Die Struktur der Filter obliegt dem Integrator, aber das Wichtigste ist, dass diese Produktfilter in Ihrem Anzeigengenerierungskontext gesendet werden. Produktfilter sollten exakt mit dem übereinstimmen, was bei der Anzeigengenerierung angefordert wird. Ein Beispielkontext, der `productFilters` enthält, ist unten dargestellt: ```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 } ``` Dieser Kontext gibt nur Anzeigen für Produkte zurück, die alle Filter im relevanten Array enthalten. {% hint style="info" %} Wenn Sie Mindestgebotswerte für Kategorien nutzen möchten, stellen Sie sicher, dass Ihre Kategorien benutzerfreundlich und für Werbetreibende bei der Kampagnenerstellung leicht verständlich sind, z. B. ist category:Keyboards leichter zu verstehen als category:12. {% endhint %} ## Bereitstellung von Bildern und Produktnamen Epsilon Retail Media benötigt Informationen über Produktbilder und -namen, um diese bei der Erstellung von Kampagnen im Epsilon Retail Media -Portal durchsuchbar zu machen. Diese Werte können an Epsilon Retail Media in Tags gesendet werden, die wie das folgende Beispiel formatiert sind: ```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" ] } ] } ``` Sie sind in verschiedenen Bereichen des Epsilon Retail Media -Portals zu sehen, einschließlich der Produktauswahl, wie im folgenden Beispiel:
Screen Shot 2021-05-24 at 12.12.31 pm.png

Referenzbild

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