> 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/cs/feature-integrations/suggested-keywords.md). # Navrhovaná klíčová slova **Doporučená klíčová slova** propojují **hledané výrazy** s **kódy produktů** ve vašem katalogu. Když inzerenti vytvářejí kampaně, tyto výrazy se zobrazují během **Cílení** (výběr vyhledávacích klíčových slov) pro produkty, které přidají. Inzerenti si mohou vybrat z návrhů namísto zadávání pouze vlastních klíčových slov, což zlepšuje shodu s tím, jak váš web indexuje vyhledávání a jak chcete, aby kampaně mapovaly SKU na vyhledávací dotazy.
**Doporučená klíčová slova lze dodat dvěma způsoby:** 1. **Epsilon klíčová slova vygenerovaná pomocí AI** — Epsilon generuje, klasifikuje a nahrává dvojice produkt–klíčové slovo vaším jménem. **Nemusíte** udržovat samostatný soubor klíčových slov pro tyto návrhy, pokud je tato cesta vaším jediným zdrojem. Generování využívá kontext produktů a katalogu, nákupní chování uživatelů při vyhledávání a signály v souladu s vašimi **obchodními pravidly prodejce** (například brand conquesting a další omezení programu). 2. **Feed TSV spravovaný prodejcem** — Synchronizujete soubor, který mapuje každý `product_code` na jednu nebo více `search_term` hodnot s volitelným pořadím a typem. Doporučená klíčová slova pro jednotlivé produkty spravujete sami. Prodejci si mohou vybrat, zda použijí **Epsilon pouze vygenerovaná klíčová slova**, **pouze váš soubor**, nebo **obojí** (například návrhy AI **překryté** přes stávající seznam nebo koordinované **nahrazení** během zavádění, aby byly stávající schválení vyřízeny záměrně). Pokud Epsilon dodává **klíčová slova doporučená pomocí AI** pro váš program a **nevyžadujete** feed TSV prodejce, začněte s [**Krok 3: Aktivujte AI doporučená klíčová slova (beta)**](#step-3-activate-ai-suggested-keywords-beta)**. Použijte**[**Krok 2: Vytvořte soubor TSV**](#step-2-optional-build-the-tsv-file-retailer-supplied-path) pouze v případě, že udržujete nebo doplňujete klíčová slova prostřednictvím souboru. ### Proč používat doporučená klíčová slova? * Nasměrujte inzerenty k vyhledávacím výrazům s vysokým záměrem a přesností pro daný produkt * Zobrazte výrazy, které by inzerenty bez nápovědy nemusely napadnout * Zvyšte konkurenci u hodnotných klíčových slov a zároveň zůstaňte v rámci pravidel programu * Snižte manuální práci se soubory, když je povoleno generování pomocí AI **Tento průvodce pokrývá** * Předpoklady a kompletní průběh procesem * Autentizaci API pro toky čtení/validace * Aktivaci AI krok za krokem (beta) a volitelnou implementaci TSV * Testování v sandboxu, kontrolní seznam pro spuštění, řešení problémů ### Pravidla vydávání Když inzerenti přidají do kampaně **doporučená** klíčová slova, pro zobrazení na odpovídající vyhledávací výrazy zákazníků jsou způsobilé **pouze produkty propojené s tímto klíčovým slovem**. V uživatelském rozhraní je vidět, které produkty se mapují na která doporučená klíčová slova:
**Vlastní** vyhledávací výrazy zvolené inzerentem se obvykle vztahují na produkty v kampani podle pravidel umístění; **doporučené** výběry omezují způsobilost pomocí mapování \*\*prodejce / Epsilon. ## Předpoklady Tento kontrolní seznam použijte před začátkem. * [ ] **Prodejce** byl zapojen (nebo proces probíhá) pomocí Epsilon Retail Media, včetně synchronizace katalogu. * [ ] **Přístup do sandboxu** k uživatelskému rozhraní kampaně a API, kde budete ověřovat klíčová slova (pokud je pro váš program k dispozici). * [ ] **Pro doručení TSV:** GCS bucket (nebo cesta) **zřízený čím:** Epsilon\*\*, a přihlašovací údaje, které může váš tým použít k nahrávání objektů (metoda potvrzena s Epsilon— často klíč servisního účtu nebo federovaný přístup). Poznámka: pokud provádíte pouze určení rozsahu, řeší se to v rámci procesu aktivace, pokud dodáváte klíčová slova. * [ ] **Technický kontakt**, který může nahrávat soubory, spouštět kontroly API a koordinovat s Epsilon harmonogramy ingestování a přechody. * [ ] **Povědomí o vydání:** způsobilost produktů pro návrhy podle klíčových slov vyžaduje platformu (viz Pravidla výdeje výše). *** ## Přehled integračního toku 1. Potvrdíte s Epsilon jak budou klíčová slova dodávána:Epsilon vygenerováno\*\*, **soubor TSV** nebo **obojí**. 2. Pokud poskytujete soubor, nahrajte jej do bucketu GCS zřízeného společností Epsilon. 3. Epsilon povolí tuto funkci a (v případě souborů) ingestuje váš soubor. Pro **AI** klíčová slova Epsilon se shodnete na pravidlech, volitelném překrytí (overlay) vs nahrazení (replace) a na staging validaci. 4. Data se v platformě uloží jako **navrhovaná klíčová slova**. 5. Před spuštěním pro vaše inzerenty vše **ověříte** ve svém sandboxu přímo v uživatelském rozhraní. 6. Aktivujete **ostré spuštění** v produkci a sdělíte týmům inzerentů, že navrhovaná klíčová slova jsou k dispozici. *** ## Průvodce implementací krok za krokem ### Krok 1: Potvrďte svůj model dodávání s Epsilon Účel\ Vyhněte se vytváření datové trubky pro soubory, pokud vaše potřeby splňuje pouze **pouze AI**, nebo se vyhněte duplicitní práci, pokud za vás Epsilon překryje/nahradí seznamy. **Co musíte udělat** * Rozhodněte se: **Pouze AI**, **pouze TSV** nebo **obojí**. * Potvrďte **překrytí (overlay)** vs **nahrazení (replace)** pro jakákoli stávající data navrhovaných klíčových slov. * Potvrďte, které **umístění** existují (`ORGANIC` pouze vs také `CROSS_SELL` / `SUBSTITUTE`). *** ### Krok 2: Aktivujte AI navrhovaná klíčová slova **Účel**\ Získejte do platformy klíčová slova vygenerovaná společností Epsilona filtrovaná podle pravidel **bez** nutnosti udržovat TSV. **Co musíte udělat** 1. Zapojte Epsilon\*\* — Poskytněte svá konkrétní **obchodní pravidla** (například conquesting značek) a uveďte, jak by nová data měla souviset se stávajícími seznamy, pokud již navrhovaná klíčová slova synchronizujete (**překrytí** vs **nahrazení**). 2. Testujte v sandboxu\*\* — Spolupracujte s Epsilon k načtení nebo kontrole klíčových slov v **stagingu/sandboxu**. Vyzkoušejte **Cílení** na nečisto v uživatelském rozhraní kampaně: vyberte produkty a potvrďte, že navržené fráze vypadají správně. 3. Produkce\*\* — Po schválení, Epsilon povolí produkci. **Vy** sdělíte týmům inzerenta, že navržená klíčová slova jsou aktivní (v uživatelském rozhraní se zobrazí po jejím povolení). **Jak fungují AI návrhy klíčových slov** 1. **Pochopení produktu** – Modelování využívá nákupní záměr produktu, kontext prodejce a jazyk. 2. **Generování klíčových slov** – Na základě tohoto pochopení jsou vytvořena kandidátní klíčová slova. 3. **Klasifikace** – Klíčová slova jsou vybírána pomocí údajů o reklamách a vyhledávání, aby byla dodržena pravidla programu (například získávání zákazníků konkurence nebo specifické zásady prodejce, jako je cílení na složky produktu). 4. **Načtení pro UI** – Páry produkt–klíčové slovo jsou uloženy ve stejném systému, který využívá tok **navržených klíčových slov** při nastavování kampaně. **Správa a řízení** * Chování při schvalování (**automatická vs. manuální kontrola prodejcem**) závisí na **konfiguraci programu** dohodnuté s Epsilon. * Pokud máte **malou historii dotazů na reklamy**, můžete být požádáni o sdílení **krátkého vzorku organických vyhledávacích dotazů na webu** (například za **sedm dní**), aby generování odpovídalo reálnému jazyku nakupujících. * **Velmi rozsáhlé katalogy** mohou omezením zúžit generování na produkty s **nedávnou reklamní aktivitou** (například za **posledních 90 dní**) namísto každé SKU — potvrďte s Epsilon. * **AI generovaná navržená klíčová slova (beta)** se v současnosti zaměřují na případy použití v **organickém** vyhledávání; podpora dalších typů umístění se může rozšířit. **Ověření** * Navržená klíčová slova se zobrazují v sandboxovém **Cílení** pro produkty v rozsahu. * Chování při schvalování (automatická vs. manuální kontrola) odpovídá konfiguraci programu. **Běžné chyby** | Chyba | Oprava | | --------------------------------------------------- | ----------------------------------------------------------------------- | | Klíčová slova se neshodují se značkou nebo zásadami | Upravte obchodní pravidla s Epsilon a znovu spusťte kontrolu v sandboxu | | Mnoho nebo žádné návrhy pro velké katalogy | Potvrďte, zda je generování omezeno na nedávno inzerované SKU | *** ### (Volitelné pro krok 2): Vytvořte soubor TSV (cesta dodaná prodejcem) **Účel**\ Dodejte závazné řádky **product\_code → search\_term** (a volitelně pořadí/typ). **Co musíte udělat** * Vygenerujte soubor oddělený tabulátory s propojením produktů a klíčových slov. * Použijte kódování **UTF-8** a zakončení řádků **LF**. * Zahrňte řádek záhlaví, který odpovídá názvům polí používaným ve vaší specifikaci zdroje; minimálně: `product_code`, `search_term`, `search_term_type`. Viz [Datové modely a definice polí](#data-models--field-definitions). * Udržujte přibližně **\~20 navržených klíčových slov na produkt** z důvodu přehlednosti. * Opakujte `product_code` na více řádcích pro více výrazů; použijte `**search_term_type`\*\*, pokud máte více druhů umístění. * Ověřte soubor a poté jej doručte do úložiště GCS Epsilon zajišťuje. **Poznámka:** Když synchronizujete zdroj prodejce, Epsilon Retail Media zajišťuje **úložiště GCS** pro ukládání souborů. Správa platformy musí dokončit konfiguraci — počítejte s časem potřebným pro aktivaci. **Příklad souboru (ukázka)** ``` product_code search_term search_term_rank search_term_type abc123 cereal 1 ORGANIC abc123 cereals 2 ORGANIC 12345 milk 1 CROSS_SELL ``` Ověření * Otevřete v textovém editoru: pole oddělená **tabulátorem**, žádná nepatřičná zakončení řádků pouze s CR. * Proveďte matátkovou kontrolu několika `product_code` hodnoty existují ve vašem **katalogovém** zdroji. **Běžné chyby** | Chyba | Oprava | | ---------------------------- | ------------------------------------------------------------- | | Čárky CSV namísto tabulátorů | Znovu exportujte jako TSV | | Špatná ID produktů | Sylaďte s `gtin` / `item` použitým při synchronizaci katalogu | | Příliš mnoho řádků na SKU | Odpusťte na výrazy s nejvyšší hodnotou | *** ### Krok 3: Ověřte návrhy v UI **Účel**\ Zachyťte problémy s mapováním na poslední chvíli před produkcí. **Co musíte udělat** * V **sandboxu** vytvořte nebo upravte kampaň, vyberte umístění, která podporují navržená klíčová slova, přidejte produkty, otevřete **Cílení** / výběr klíčových slov. * Potvrďte navržené fráze pro jednotlivé produkty a to, že chování **vlastních** vs **navržených** odpovídá vašemu očekávání (viz \*\*Pravidla výdeje v **Přehledu**). * Potvrďte, že **navržené** výběry omezují způsobilé produkty pouze na ty, které jsou propojeny ve vašem zdroji nebo AI kanálu. **Ověření** * Ve vašem UI v sandboxu: navržená klíčová slova se zobrazují pro produkty propojené s klíčovými slovy ve vašem souboru nebo AI kanálu. * Návrhy odpovídají očekáváním pro umístění a katalog. **Běžné chyby** | Chyba | Oprava | | -------------------------------- | ------------------------------------------------------------- | | Návrhy pouze u jednoho katalogu | Doplňte ostatní katalogy nebo upravte rozsah katalogu kampaně | | Zobrazuje se špatný typ umístění | TAM skontroluje umístění ↔ `search_term_type` konfiguraci | *** ## Datové modely a definice polí ### TSV (soubor prodejce) | Pole | Typ | Vyžadováno | Popis | Akceptované hodnoty | | ------------------ | ---------- | ---------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | `product_code` | řetězec | Ano | Identifikátor produktu obchodníka; stejný jako v katalogu `gtin` / `item` případně | Neprázdné; musí existovat v synchronizovaném katalogu | | `search_term` | řetězec | Ano | Klíčové slovo nebo fráze navržená pro SKU | Text v UTF-8; vyhněte se řídicím znakům | | `search_term_rank` | celé číslo | No | Relativní relevance; **1** je nejvyšší | Kladná celá čísla; nižší = vyšší priorita | | `search_term_type` | řetězec | No | Mapuje řádky na druhy \*\*placement | `ORGANIC`, `CROSS_SELL`, `SUBSTITUTE`; výchozí hodnota se zpracuje jako `ORGANIC` pokud je vynecháno | | (konce řádků) | — | — | Formát souboru | LF\*\*; kódování souboru \*\*UTF-8 | ### Typy umístění a `search_term_type` `search_term_type` odpovídá typům umístění: **ORGANIC**, **CROSS\_SELL** a **SUBSTITUTE**. Většina programů obchodníků používá jedno umístění **organic search** pro standardní reklamy ve výsledcích vyhledávání. **CROSS\_SELL** a **SUBSTITUTE** jsou **samostatná umístění** na stránce vyhledávání (nebo souvisejícím inventáři) s odlišným záměrem zobrazování — nejde o jen další sloupce v téže organické aukci. Váš Technical Account Manager vám potvrdí, která umístění pro váš jmenný prostor existují. **Jak se typy umístění liší** * **Organic** — Reklamy odpovídající nákupnímu záměru uživatele pro daný produkt (například produkt typu cola na dotaz „cola“). * **Cross-sell** — Komplementární záměr (například pizza na dotaz „cola“). * **Substitute** — Záměr s podobným produktem (například jiná varianta coly na dotaz „cola“). Můžete synchronizovat **jeden feed na typ umístění** nebo **skombinovat typy do jednoho souboru** (opakujte `product_code` s různými `search_term_type`). Váš Technical Account Manager nakonfiguruje umístění tak, aby se na každém povrchu zobrazil správný typ návrhu. Navržená klíčová slova lze **zobrazit nebo skrýt pro jednotlivá umístění**. Kombinované typy pro jeden produkt: | product\_code | search\_term | search\_term\_rank | search\_term\_type | | ------------- | ------------ | ------------------ | ------------------ | | 12345 | cookies | 1 | ORGANIC | | 12345 | cookie | 2 | ORGANIC | | 12345 | milk | 1 | CROSS\_SELL | **Poznámka:** Většina programů používá pouze **organická** vyhledávací umístění. `CROSS_SELL` a `SUBSTITUTE` odpovídají **dalším umístěním**, nikoli „extra sloupcům“ ve stejné organické pozici — potvrdíte si se svým Technical Account Managerem, se kterými umístěními pracujete. ### Více katalogů Pokud je to možné, implementujte navržená klíčová slova napříč **všemi** katalogy ve svém jmenném prostoru (ať už z vašeho feedu, generování pomocí AI nebo z obojího). Snížíte tím zmatek ohledně značky, když jeden katalog návrhy má a jiné ne. U kampaní s více katalogy platí, že pokud má data pouze jeden katalog, kampaně závislé na navržených výběrech fungují naplno pouze na tomto katalogu. \## *** ## Testování, Sandbox a Go-Live **Sandbox / testovací prostředí** * Ověřte návrhy v uživatelském rozhraní v kroku **Cílení** kampaně. **Příklady testovacích případů** | Test | Kroky | Očekávaný výsledek | | ---------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------ | | Návrhy v UI jsou viditelné | Přidejte produkty v sandboxové kampani; otevřete **Cílení** | U každého produktu se zobrazí navržená klíčová slova | | Pravidlo zobrazování | Vyberte navržené klíčové slovo propojené s podmnožinou produktů | Pro daný výraz jsou způsobilé pouze propojené produkty | | Pokrytí napříč více katalogy | Opakujte kontrolu v UI napříč katalogy ve jmenném prostoru | Návrhy jsou přítomny ve všech katalozích s daty (nebo je rozsah zdokumentován) | Kontrolní seznam pro spuštění (Go-live) * [ ] TSV naimportováno bez chyb (pokud používáte cestu k souboru) nebo AI pipeline schválena (pokud používáte betu) * [ ] Navržená klíčová slova jsou viditelná v rozhraní sandboxu pro reprezentativní produkty * [ ] Jmenné prostory s více katalogy mají pokrytí na všech katalozích (nebo je rozsah zdokumentován) * [ ] Komunikace inzerentovi odeslána před spuštěním produkce nebo při něm * [ ] Partner API v produkci vrací očekávané řádky (namátková kontrola) *** ## Řešení problémů & FAQ **Problém:** Návrhy se v UI nikdy nezobrazí.\ **Pravděpodobná příčina:** Ingesce není povolena, nesprávný katalog nebo pozice není nakonfigurována.\ Řešení:\*\* Ověřte u Epsilon že je ingesce GCS nebo AI pipeline aktivní; ověřte mapování pozic pro `search_term_type`. **Můžeme použít jeden TSV pro více typů pozic?**\ Ano. Opakujte `product_code` na více řádcích s různými `search_term_type` hodnotami. Váš Technical Account Manager nakonfiguruje, které typy se zobrazují pro jednotlivé pozice. **Co když máme více katalogů v jednom jmenném prostoru?**\ Implementujte navržená klíčová slova napříč všemi katalogy, pokud je to možné. Kampaně, které závisí na navržených výběrech, fungují naplno pouze v katalozích s daty. **Při kontaktování podpory uveďte:** * Namespace a ID katalogu * Vzorek `product_code` a očekávané `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/cs/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.