> 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/suggested-keywords.md). # Vorgeschlagene Keywords **Vorgeschlagene Keywords** verknüpfen **Suchbegriffe** mit **Produktcodes** in Ihrem Katalog. Wenn Werbetreibende Kampagnen erstellen, erscheinen diese Begriffe während des **Targetings** (Auswahl von Such-Keywords) für die von ihnen hinzugefügten Produkte. Werbetreibende können aus Vorschlägen auswählen, anstatt nur benutzerdefinierte Keywords einzugeben. Dies verbessert die Abstimmung darauf, wie Ihre Website Suchen indexiert und wie Kampagnen SKUs zu Suchanfragen zuordnen sollen.
**Vorgeschlagene Keywords können auf zwei Arten bereitgestellt werden:** 1. **Epsilon KI-generierte Keywords** — Epsilon generiert, klassifiziert und lädt Produkt-Keyword-Paare in Ihrem Auftrag. Sie sind **nicht verpflichtet**, eine separate Keyword-Datei für diese Vorschläge zu führen, wenn dieser Pfad Ihre einzige Quelle ist. Die Generierung nutzt Produkt- und Katalog-Kontext, das Suchverhalten der Käufer und Signale, die an Ihren **Retailer-Geschäftsregeln** ausgerichtet sind (z. B. Brand Conquesting und andere Programm-Einschränkungen). 2. **Vom Retailer verwalteter TSV-Feed** — Sie synchronisieren eine Datei, die jeden `product_code` einem oder mehreren `search_term` -Werten zuordnet, mit optionalem Rang und Typ. Sie verwalten die vorgeschlagenen Keywords pro Produkt. Retailer können wählen, ob sie **Epsilon nur generierte Keywords**, **nur Ihre Datei** oder **beides** verwenden möchten (z. B. KI-Vorschläge, die über eine bestehende Liste **überlagert** werden, oder ein koordiniertes **Ersetzen** während des Rollouts, damit bestehende Freigaben bewusst gehandhabt werden). Wenn Epsilon **KI-vorgeschlagene Keywords** für Ihr Programm bereitstellt und Sie **keinen** Retailer-TSV-Feed benötigen, beginnen Sie mit [**Schritt 3: Aktivieren Sie KI-vorgeschlagene Schlüsselwörter (Beta)**](#step-3-activate-ai-suggested-keywords-beta)**. Verwenden Sie**[**Schritt 2: Erstellen Sie die TSV-Datei**](#step-2-optional-build-the-tsv-file-retailer-supplied-path) nur, wenn Sie Keywords über eine Datei pflegen oder ergänzen. ### Warum vorgeschlagene Keywords verwenden? * Werbetreibende zu kaufrelevanten, produktgenauen Suchbegriffen führen * Begriffe aufzeigen, an die Werbetreibende ohne Anleitung möglicherweise nicht denken würden * Wettbewerb um wertvolle Keywords erhöhen und gleichzeitig innerhalb der Programmregeln bleiben * Manuellen Dateiaufwand reduzieren, wenn die KI-Generierung aktiviert ist **Dieser Leitfaden deckt ab** * Voraussetzungen und End-to-End-Ablauf * API-Authentifizierung für Lese-/Validierungs-Flows * Schritt-für-Schritt-KI-Aktivierung (Beta) und optionale TSV-Implementierung * Sandbox-Tests, Go-Live-Checkliste, Fehlerbehebung ### Auslieferungsregeln Wenn Werbetreibende einer Kampagne **vorgeschlagene** Keywords hinzufügen, sind **nur Produkte, die mit diesem Keyword verknüpft sind**, für die Auslieferung bei passenden Kunden-Suchbegriffen berechtigt. Die Benutzeroberfläche zeigt, welche Produkte welchen vorgeschlagenen Keywords zugeordnet sind:
**Benutzerdefinierte** Suchbegriffe, die vom Werbetreibenden ausgewählt wurden, gelten in der Regel für alle Kampagnenprodukte gemäß den Platzierungsregeln; **vorgeschlagene** Auswahlen schränken die Berechtigung mithilfe der Zuordnung von \*\*Retailer / Epsilonein. ## Voraussetzungen Verwenden Sie diese Checkliste, bevor Sie beginnen. * [ ] **Retailer** geonboardet (oder in Bearbeitung) mit Epsilon Retail Media, einschließlich Katalog-Synchronisierung. * [ ] **Sandbox-Zugriff** auf die Kampagnen-Benutzeroberfläche und APIs, wo Sie Keywords validieren werden (sofern für Ihr Programm verfügbar). * [ ] **Für TSV-Bereitstellung:** GCS-Bucket (oder -Pfad) **bereitgestellt von Epsilon**, und Zugangsdaten, die Ihr Team zum Hochladen von Objekten verwenden kann (Methode bestätigt mit Epsilon— oft Service-Account-Schlüssel oder federierter Zugriff). Hinweis: Wenn Sie nur die Reichweite planen, wird dies im Rahmen des Aktivierungsprozesses gehandhabt, wenn Sie Keywords bereitstellen. * [ ] **Technischer Ansprechpartner**, der Dateien hochladen, API-Prüfungen durchführen und sich mit Epsilon bezüglich Ingestions-Plänen und Umstellungen koordinieren kann. * [ ] **Release-Information:** Die Produktberechtigung pro Keyword für Vorschläge erfordert die Plattform (siehe Auslieferungsregeln oben). *** ## Übersicht über den Integrations-Ablauf 1. Sie bestätigen mit Epsilon wie Keywords bereitgestellt werden:Epsilon generiert\*\*, **TSV-Datei** oder **beides**. 2. Wenn Sie eine Datei bereitstellen, laden Sie diese in den GCS-Bucket hoch, der bereitgestellt wurde von Epsilon. 3. Epsilon aktiviert die Funktion und liest (bei Dateien) Ihre Datei ein. Für **KI**-Keywords Epsilon stimmt die Regeln, optionale Überlagerung vs. Ersetzen und die Staging-Validierung ab. 4. Daten landen als **vorgeschlagene Keywords** in der Plattform. 5. Sie **verifizieren** dies in Ihrer Sandbox direkt in der Benutzeroberfläche vor dem Start für Ihre Werbetreibenden. 6. Sie **gehen in der Produktion live** und informieren die Teams der Werbetreibenden, dass vorgeschlagene Keywords verfügbar sind. *** ## Schritt-für-Schritt-Implementierungsleitfaden ### Schritt 1: Bestätigen Sie Ihr Bereitstellungsmodell mit Epsilon Zweck\ Vermeiden Sie den Aufbau einer Dateipipeline, wenn **nur KI** Ihren Anforderungen entspricht, oder vermeiden Sie doppelte Arbeit, wenn Epsilon Listen für Sie überlagern/ersetzen wird. **Was Sie tun müssen** * Entscheiden Sie: **nur KI**, **nur TSV** oder **beides**. * Bestätigen Sie **Überlagern** vs. **Ersetzen** für alle vorhandenen Daten vorgeschlagener Keywords. * Bestätigen Sie, welche **Platzierungen** existieren (`ORGANIC` nur vs. auch `CROSS_SELL` / `SUBSTITUTE`). *** ### Schritt 2: Aktivieren Sie KI-vorgeschlagene Keywords **Zweck**\ Erhalten Sie Epsilon-generierte, regelgefilterte Keywords in die Plattform, **ohne** eine TSV zu pflegen. **Was Sie tun müssen** 1. Einbinden von Epsilon\*\* — Stellen Sie Ihre spezifischen **Geschäftsregeln** (z. B. Brand Conquesting) bereit und legen Sie fest, wie neue Daten sich zu bestehenden Listen verhalten sollen, wenn Sie bereits vorgeschlagene Keywords synchronisieren (**Überlagern** vs. **Ersetzen**). 2. In der Sandbox testen\*\* — Arbeiten Sie mit Epsilon zusammen, um Keywords in **Staging/Sandbox** zu laden oder zu überprüfen. Führen Sie einen Probelauf für **Targeting** in der Kampagnen-UI durch: Wählen Sie Produkte aus und bestätigen Sie, dass die vorgeschlagenen Phrasen korrekt aussehen. 3. Produktion\*\* — Nach der Freigabe, Epsilon ermöglicht die Produktion. **Sie** teilen den Werbetreibenden-Teams mit, dass vorgeschlagene Keywords live sind (die Benutzeroberfläche zeigt sie an, sobald sie aktiviert sind). **Wie KI-Keyword-Vorschläge funktionieren** 1. **Das Produkt verstehen** – Die Modellierung nutzt die Produktabsicht, den Kontext des Einzelhändlers und die Sprache. 2. **Keywords generieren** – Aus diesem Verständnis heraus werden Keyword-Kandidaten erstellt. 3. **Klassifizieren** – Keywords werden anhand von Werbe- und Suchdaten ausgewählt, sodass Programmregeln (z. B. Brand Conquesting oder einzelhändlerspezifische Richtlinien wie das Targeting auf die Inhaltsstoffe eines Produkts) eingehalten werden. 4. **Für die Benutzeroberfläche laden** – Produkt-Keyword-Paare werden im selben System gespeichert, das vom Ablauf für **vorgeschlagene Keywords** bei der Kampagneneinrichtung verwendet wird. **Governance** * Das Genehmigungsverhalten (**automatische vs. manuelle Überprüfung durch den Einzelhändler**) hängt von der mit Epsilon. * Wenn Sie über **wenig Werbeanfragen-Historie** verfügen, werden Sie möglicherweise gebeten, eine **kurze Stichprobe organischer On-Site-Suchanfragen** (z. B. etwa **sieben Tage**) zu teilen, damit die Generierung der echten Sprache der Shopper entspricht. * Bei **sehr großen Katalogen** kann die Generierung auf Produkte mit **solcher Werbeaktivität in der letzten Zeit** (z. B. etwa in den **letzten 90 Tagen**) statt auf jede SKU beschränkt werden – stimmen Sie dies ab mit Epsilon. * **KI-generierte vorgeschlagene Keywords (Beta)** konzentrieren sich derzeit auf **organische** Suchanwendungsfälle; die Unterstützung für zusätzliche Platzierungstypen wird möglicherweise erweitert. **Validierung** * Vorgeschlagene Keywords erscheinen im Sandbox-**Targeting** für relevante Produkte. * Das Genehmigungsverhalten (automatische vs. manuelle Überprüfung) entspricht der Programmkonfiguration. **Häufige Fehler** | Fehler | Lösung | | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | Keywords wirken nicht markengerecht oder entsprechen nicht den Richtlinien | Verfeinern Sie die Geschäftsregeln mit Epsilon und führen Sie die Überprüfung in der Sandbox erneut aus | | Wenige oder keine Vorschläge für große Kataloge | Prüfen Sie, ob die Generierung auf SKUs mit aktueller Werbeaktivität beschränkt ist | *** ### (Optional für Schritt 2): Erstellen Sie Ihre TSV-Datei (vom Einzelhändler bereitgestellter Pfad) **Zweck**\ Stellen Sie verbindliche Zeilen für **product\_code → search\_term** (und optional Rang/Typ) bereit. **Was Sie tun müssen** * Generieren Sie eine tabulatorgetrennte Datei mit Produkt- und Keyword-Verknüpfungen. * Verwenden Sie die **UTF-8**-Codierung und **LF**-Zeilenenden. * Fügen Sie eine Kopfzeile ein, die den Feldnamen entspricht, die Ihre Feed-Spezifikation verwendet; mindestens: `product_code`, `search_term`, `search_term_type`. Siehe [Datenmodelle & Felddefinitionen](#data-models--field-definitions). * Halten Sie aus Gründen der Benutzerfreundlichkeit etwa **\~20 vorgeschlagene Keywords pro Produkt** ein. * Wiederholen Sie `product_code` auf mehreren Zeilen für mehrere Begriffe; verwenden Sie `**search_term_type`\*\*, wenn Sie mehrere Platzierungsarten haben. * Validieren Sie die Datei und übermitteln Sie sie an den GCS-Bucket, den Epsilon bereitstellt. **Hinweis:** Wenn Sie einen Einzelhändler-Feed synchronisieren, Epsilon Retail Media einen **GCS-Bucket** für Uploads bereit. Der Plattform-Betrieb muss die Konfiguration abschließen – planen Sie Bearbeitungszeit für die Aktivierung ein. **Beispieldatei (Auszug)** ``` product_code search_term search_term_rank search_term_type abc123 cereal 1 ORGANIC abc123 cereals 2 ORGANIC 12345 milk 1 CROSS_SELL ``` Validierung * In einem Texteditor öffnen: Felder durch **Tabulator** getrennt, keine einzelnen CR-Zeilenenden. * Stichprobenartig prüfen, ob mehrere `product_code` -Werte in Ihrem **Katalog**-Feed vorhanden sind. **Häufige Fehler** | Fehler | Lösung | | ---------------------------- | --------------------------------------------------------------------------- | | CSV-Kommas statt Tabulatoren | Erneut als TSV exportieren | | Falsche Produkt-IDs | Mit den beim Katalogsynchronisierung verwendeten `gtin` / `item` abgleichen | | Zu viele Zeilen pro SKU | Auf die am stärksten wertschöpfenden Begriffe kürzen | *** ### Schritt 3: Vorschläge in der Benutzeroberfläche überprüfen **Zweck**\ Aufdecken von Zuordnungsfehlern in letzter Minute vor der Produktion. **Was Sie tun müssen** * Erstellen oder bearbeiten Sie in der **Sandbox** eine Kampagne, wählen Sie Platzierungen aus, die vorgeschlagene Keywords unterstützen, fügen Sie Produkte hinzu und öffnen Sie **Targeting** / Keyword-Auswahl. * Bestätigen Sie die vorgeschlagenen Phrasen pro Produkt und dass das Verhalten von **benutzerdefiniert** vs. **vorgeschlagen** Ihren Erwartungen entspricht (siehe \*\*Auslieferungsregeln in der **Übersicht**). * Bestätigen Sie, dass die Auswahl von **vorgeschlagen** die berechtigten Produkte auf diejenigen beschränkt, die in Ihrem Feed oder Ihrer KI-Pipeline verknüpft sind. **Validierung** * In Ihrer Sandbox-Benutzeroberfläche: Vorgeschlagene Keywords erscheinen für Produkte, die in Ihrer Datei oder KI-Pipeline mit Keywords verknüpft sind. * Vorschläge entsprechen den Erwartungen an Platzierung und Katalog. **Häufige Fehler** | Fehler | Lösung | | --------------------------------------- | -------------------------------------------------------------------------------- | | Vorschläge nur für einen Katalog | Füllen Sie andere Kataloge auf oder passen Sie den Katalogumfang der Kampagne an | | Falscher Platzierungstyp wird angezeigt | TAM überprüft Platzierung ↔ `search_term_type` -Konfiguration | *** ## Datenmodelle & Felddefinitionen ### TSV (Einzelhändler-Datei) | Feld | Typ | Erforderlich | Beschreibung | Akzeptierte Werte | | ------------------ | ------- | ------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | `product_code` | string | Ja | Händler-Produktkennung; identisch mit dem Katalog `gtin` / `item` falls zutreffend | Nicht leer; muss im synchronisierten Katalog vorhanden sein | | `search_term` | string | Ja | Für die SKU vorgeschlagenes Keyword oder vorgeschlagene Phrase | UTF-8-Text; Steuerzeichen vermeiden | | `search_term_rank` | integer | No | Relative Relevanz; **1** ist am höchsten | Positive ganze Zahlen; kleiner = höhere Priorität | | `search_term_type` | string | No | Ordnet Zeilen **Platzierungs**-Arten zu | `ORGANIC`, `CROSS_SELL`, `SUBSTITUTE`; Standardwert wird behandelt als `ORGANIC` wenn weggelassen | | (Zeilenumbrüche) | — | — | Dateiformat | LF\*\*; Dateikodierung \*\*UTF-8 | ### Platzierungstypen und `search_term_type` `search_term_type` stimmt mit den Platzierungstypen überein: **ORGANIC**, **CROSS\_SELL** und **SUBSTITUTE**. Die meisten Händlerprogramme verwenden eine einzelne **organische Suche**-Platzierung für Standard-Suchergebnis-Anzeigen. **CROSS\_SELL** und **SUBSTITUTE** sind **separate Platzierungen** auf der Suchseite (oder verwandtem Inventar) mit unterschiedlicher Ausspielungsabsicht – sie sind nicht einfach zusätzliche Spalten in derselben organischen Auktion. Ihr Technical Account Manager bestätigt, welche Platzierungen für Ihren Namespace existieren. **Wie sich Platzierungstypen unterscheiden** * **Organisch** — Anzeigen, die auf die Suchabsicht des Käufers für das Produkt abgestimmt sind (z. B. ein Cola-Produkt bei "Cola"). * **Cross-Selling** — Komplementäre Absicht (z. B. Pizza bei "Cola"). * **Ersatz** — Ähnliche Produktabsicht (z. B. eine andere Cola-Variante bei "Cola"). Sie können **einen Feed pro Platzierungstyp** synchronisieren oder **Typen in einer einzigen Datei kombinieren** (wiederholen Sie `product_code` mit verschiedenen `search_term_type`). Ihr Technical Account Manager konfiguriert Platzierungen so, dass der korrekte Vorschlagstyp pro Fläche erscheint. Vorgeschlagene Keywords können **pro Platzierung angezeigt oder ausgeblendet werden**. Kombinierte Typen für ein Produkt: | product\_code | search\_term | search\_term\_rank | search\_term\_type | | ------------- | ------------ | ------------------ | ------------------ | | 12345 | cookies | 1 | ORGANIC | | 12345 | cookie | 2 | ORGANIC | | 12345 | milk | 1 | CROSS\_SELL | **Hinweis:** Die meisten Programme verwenden nur **organische** Suchplatzierungen. `CROSS_SELL` und `SUBSTITUTE` entsprechen **zusätzlichen Platzierungen**, nicht "zusätzlichen Spalten" im selben organischen Slot – bestätigen Sie mit Ihrem Technical Account Manager, mit welchen Platzierungen Sie arbeiten. ### Mehrere Kataloge Implementieren Sie vorgeschlagene Keywords nach Möglichkeit über **alle** Kataloge in Ihrem Namespace hinweg (unabhängig davon, ob aus Ihrem Feed, per KI-Generierung oder beidem). Dies reduziert Markenverwirrung, wenn ein Katalog Vorschläge hat und andere nicht. Wenn bei Kampagnen mit mehreren Katalogen nur ein Katalog Daten enthält, verhalten sich Kampagnen, die von vorgeschlagenen Auswahlen abhängen, nur auf diesem Katalog vollständig. \## *** ## Testen, Sandbox und Go-Live **Sandbox- / Testumgebung** * Überprüfen Sie UI-Vorschläge im Kampagnenschritt **Targeting**. **Beispiel-Testfälle** | Test | Schritte | Erwartetes Ergebnis | | --------------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | | UI-Vorschläge sichtbar | Produkte in Sandbox-Kampagne hinzufügen; **Targeting** öffnen | Vorgeschlagene Keywords erscheinen pro Produkt | | Ausspielungsregel | Wählen Sie ein vorgeschlagenes Keyword aus, das mit einer Teilmenge von Produkten verknüpft ist | Nur verknüpfte Produkte sind für diesen Begriff berechtigt | | Abdeckung mehrerer Kataloge | UI-Prüfung über Kataloge im Namespace hinweg wiederholen | Vorschläge auf allen Katalogen mit Daten vorhanden (oder Umfang dokumentiert) | Go-Live-Checkliste * [ ] TSV ohne Fehler eingelesen (bei Verwendung des Dateipfads) oder KI-Pipeline freigegeben (bei Verwendung der Beta) * [ ] Vorgeschlagene Keywords in der Sandbox-UI für repräsentative Produkte sichtbar * [ ] Namespaces mit mehreren Katalogen weisen eine Abdeckung für alle Kataloge auf (oder der Umfang ist dokumentiert) * [ ] Werbetreibenden-Kommunikation vor oder bei der Produktionsfreischaltung versendet * [ ] Partner-API liefert erwartete Zeilen in der Produktion zurück (Stichprobe) *** ## Fehlerbehebung & FAQ **Problem:** Vorschläge erscheinen nie in der UI.\ **Mögliche Ursache:** Ingestion nicht aktiviert, falscher Katalog oder Platzierung nicht konfiguriert.\ Lösung:\*\* Bestätigen Sie mit Epsilon dass die GCS-Aufnahme oder KI-Pipeline aktiv ist; überprüfen Sie das Platzierungs-Mapping für `search_term_type`. **Können wir eine TSV für mehrere Platzierungstypen verwenden?**\ Ja. Wiederholen Sie `product_code` auf mehreren Zeilen mit unterschiedlichen `search_term_type` -Werten. Ihr Technical Account Manager konfiguriert, welche Typen pro Platzierung angezeigt werden. **Was passiert, wenn wir mehrere Kataloge in einem Namespace haben?**\ Implementieren Sie vorgeschlagene Keywords nach Möglichkeit über alle Kataloge hinweg. Kampagnen, die von vorgeschlagenen Auswahlen abhängen, funktionieren nur auf Katalogen mit Daten vollständig. **Wenn Sie den Support kontaktieren, geben Sie Folgendes an:** * Namespace und Katalog-ID * Beispiel- `product_code` und erwartete `search_term`
--- # 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/suggested-keywords.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.