> 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/feature-integrations/category-cross-sell/integration-requirements.md). # Integrationsanforderungen ## Überblick auf hoher Ebene Im Rahmen dieser Integration müssen Sie Folgendes tun 1. Implementieren Sie eine zusätzliche Werbeanfrage für die Cross-Selling-Kategorieplatzierung. 1. Dies umfasst die Arbeit zur Positionierung und Darstellung von Anzeigen auf Ihrer Website sowie das Melden von Klicks und Impressionen 2. Bestellungen müssen bereitgestellt werden für Epsilon Retail Media als Teil Ihrer Standardintegration 2. Wenn Sie Kategorie-IDs synchronisieren mit Epsilon Retail Media, müssen Sie die [filterMapping](/retail-media-interface/integration/de/citrus-filter-mapping-api/filtermapping.md) API verwenden, um lesbare Werte für die UI-Kategorieauswahl bereitzustellen 1. Dies gilt nur, wenn Sie mit Kategorie-IDs statt mit Namen integriert sind. (Z. B. wenn Sie Anzeigen anfordern, lauten Ihre Filter `category:123j-dsef-er` statt `category:Milk` 3. (Empfohlen) – Synchronisieren Sie Kategorie-Cross-Selling-Zuordnungen, um Genehmigungen zu automatisieren und den Aufwand für das Kampagnenmanagement zu reduzieren. ## Werbeanfrage und Website-Integration ### Werbeanfrage Da Kategorie-Cross-Selling eine eigenständige Platzierung erfordert, müssen Sie eine zusätzliche Werbeanfrage pro Anzeigentyp integrieren, für den Sie Kategorie-Cross-Selling integrieren. Das Format Ihrer Anfrage sollte der unten aufgeführten Kategorie-Cross-Selling-Werbeanfrage entsprechen * [Produktanzeige – Anfordern von Kategorie-Cross-Selling-Anzeigen](/retail-media-interface/integration/de/generating-ads/product-ads/requesting-product-ads-1.md#cross-sell-category-placements) * [Banner-Anzeige – Anfordern von Kategorie-Cross-Selling-Anzeigen](/retail-media-interface/integration/de/generating-ads/banner-ads-static/requesting-banner-ads.md#cross-sell-category-placements) * Banner X - Anfordern von Kategorie-Cross-Selling-Anzeigen ### Melden von Impressionen und Klicks Sobald Sie Ihre Werbeanfrage integriert haben, müssen Sie auch sicherstellen, dass Sie Klicks und Impressionen für jede angezeigte Anzeige korrekt melden. Stellen Sie sicher, dass Sie lesen [Berichterstellung für Impressionen und Klicks](/retail-media-interface/integration/de/data-api/api-overview/reporting-impressions-clicks.md). ### Melden von Bestellungen Im Allgemeinen melden die meisten Integrationen alle Bestellinformationen an Epsilon Retail Media gemäß einer Standardintegration. Sie müssen sicherstellen, dass Sie alle Bestellungen korrekt melden an Epsilon Retail Media gemäß [Bestelldaten](/retail-media-interface/integration/de/data-api/order-data-1.md). ## Filterzuordnungen Der Filterzuordnungsendpunkt kann verwendet werden, um Ihre Kategorie-IDs lesbaren Werten zuordnen. Dies ist erforderlich, wenn Sie Kategorie-IDs synchronisieren, da die Benutzeroberfläche Ihren Benutzern die Werte anzeigt. {% hint style="info" %} Wenn Sie lesbare Kategorien in Ihrem Produktkatalog synchronisieren mit Epsilon Retail Media, ist dieser Schritt nicht erforderlich. {% endhint %} Benutzer werden nicht verstehen, was `category:12345-abcde` ist. Die filterMapping-API kann verwendet werden, um den Wert dem relevanten Kategorienamen auf Ihrer Website zuzuordnen, z. B. `category:Pantry`. Es gibt keine dateibasierte Methode zum Synchronisieren dieser Informationen, dies muss über die [filterMapping](/retail-media-interface/integration/de/citrus-filter-mapping-api/filtermapping.md) API erfolgen. {% hint style="warning" %} Wenn Sie zusätzliche Kategorien auf Ihrer Website erstellen, müssen Sie sicherstellen, dass die filterMapping-API verwendet wird, um Kategorien zu aktualisieren. {% endhint %} ## Kategorie-Cross-Selling-Zuordnungen (empfohlen) Bei der Integration dieser Art von Platzierung wird dringend empfohlen, eine Zuordnung bereitzustellen, welche Kategorien sich gegenseitig als Ziel festlegen dürfen. Dies kann Ihre Abläufe nach der ersten Integrationsarbeit optimieren. Die Werbekunden-Erfahrung wird so optimiert, dass nur Kategorien ausgewählt werden können, die bereits erlaubt sind. Darüber hinaus ist es auch möglich, eine automatische Genehmigung für Cross-Selling-Kategoriekampagnen zu konfigurieren, wenn Cross-Selling-Zuordnungen bereitgestellt werden. ### Integrationsmethoden * Sie können die [crossSellCategory](/retail-media-interface/integration/de/crosssellcategory-api/crosssellcategory.md) API verwenden, um Zuordnungen nach Bedarf zu erstellen und zu verwalten. * Alternativ können Sie eine TSV-Datei in einem GCS-Bucket bereitstellen, der gehostet wird von Epsilon Retail Media mit dem unten aufgeführten Format. #### API-Integration Alle erforderlichen Informationen finden Sie in der [crossSellCategory](/retail-media-interface/integration/de/crosssellcategory-api/crosssellcategory.md) API-Referenz. #### Datei-Integration Bei der Integration per Datei, Epsilon Retail Media benötigt eine Datei pro Katalog, welche Kategorien sich gegenseitig als Ziel festlegen dürfen. Jede Zeile in der Datei stellt eine einzelne Zuordnung einer Kategorie und der Kategorie dar, die sie als Ziel festlegen kann. Jede Zuordnung ist direktional (wenn Sie Schokolade -> Milch synchronisieren, können Schokoladenprodukte in der Kategorie Milch erscheinen. Wenn Milchprodukte in Schokolade erscheinen können sollen, ist eine zusätzliche Zeile erforderlich). Wir benötigen einen Datenfeed im TSV-Format, der den folgenden Spezifikationen entspricht: | Spaltenname | Erforderlich | Datentyp | Beschreibung | Beispiel | | ------------------- | ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | | `category` | Erforderlich | Text | Dies ist eine eindeutige Kategorie-ID, die die Kategorie des beworbenen Produkts identifiziert. | `category:cookies` | | `cross_category_id` | Erforderlich | Text | Dies ist eine eindeutige Kategorie-ID, die eine berechtigte Kategorie identifiziert, in die Produkte von category\_id mittels Cross-Selling verkauft werden können. | `category:milk` | Zusätzliche Dateispezifikationen finden Sie unten: * TSV-Dateien werden nur unterstützt * TSV sollte in LF, nicht CRLF sein * TSV sollte UTF-8-kodiert sein, jegliche Typen führen zum Fehlschlagen des Feeds * Erforderliche Namenskonvention: `^cross_sell_category.*.tsv$` Ein Beispielausschnitt sieht wie folgt aus: | category | cross\_category\_id | | ---------------- | ------------------- | | category:cookies | category:milk | | category:cookies | category:chocolate | | category:milk | category:cookies | Dieser obige Ausschnitt ermöglicht es der Kategorie **cookies**, Cross-Selling in die Kategorien **milk** und **chocolate** zu betreiben. Die Kategorie **milk** kann Cross-Selling in die Kategorie **cookies** betreiben. Die Kategorie **chocolate** kann als Ziel festgelegt werden, kann jedoch keine anderen Kategorien als Ziel festlegen. {% hint style="danger" %} ️ Jede Zeile ist eine eindeutige Zuordnungskombination Sie müssen eindeutige Zeilen für jede eindeutige Cross-Selling-Kategoriezuordnung synchronisieren. Beim Versuch, mehrere cross\_category\_id in einer einzigen Zeile zu synchronisieren, schlägt die Dateiaufnahme fehl. {% endhint %} {% hint style="warning" %} Spaltenreihenfolge Bitte stellen Sie sicher, dass Ihre Datei die `category` Spalte als erste Spalte hat. Wenn Sie synchronisieren `cross_category_id` als erste Spalte, schlägt der Import fehl. {% endhint %} ## Prozess zur Funktionaktivierung Sobald Sie bereit sind, Ihren Feed für vorgeschlagene Suchbegriffe zu synchronisieren, Epsilon Retail Media wird Ihnen einen GCS-Bucket zum Ablegen Ihrer Dateien konfigurieren. Diese Funktion wird nur auf GCS-Buckets unterstützt. Externe Buckets wie AWS/Azure/andere werden nicht unterstützt. Ihr Technical Account Manager wird Sie durch die Aktivierung dieser Funktion führen. Da Epsilon Retail Medias Plattform-Operations-Team eine Konfiguration vornehmen muss, beachten Sie bitte, dass eine zusätzliche Bearbeitungszeit für die Aktivierung anfällt. --- # 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/feature-integrations/category-cross-sell/integration-requirements.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.