> 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/sk/feature-integrations/suggested-keywords.md). # Odporúčané kľúčové slová **Odporúčané kľúčové slová** prepájajú **vyhľadávacie výrazy** s **kódmi produktov** vo vašom katalógu. Keď inzerenti vytvárajú kampane, tieto výrazy sa zobrazujú počas **Cielenia** (výber vyhľadávacích kľúčových slov) pre produkty, ktoré pridajú. Inzerenti si môžu vybrať z návrhov namiesto zadávania len vlastných kľúčových slov, čo zlepšuje zhodu s tým, ako vaša stránka indexuje vyhľadávanie a ako chcete, aby kampane mapovali SKU na vyhľadávacie dopyty.
**Odporúčané kľúčové slová je možné dodať dvoma spôsobmi:** 1. **Epsilon Kľúčové slová vygenerované AI** — Epsilon generuje, klasifikuje a nahráva páry produkt–kľúčové slovo vo vašom mene. Ak je táto cesta vaším jediným zdrojom, **nevyžaduje sa**, aby ste pre tieto návrhy udržiavali samostatný súbor kľúčových slov. Generovanie využíva kontext produktu a katalógu, nákupné správanie zákazníkov pri vyhľadávaní a signály prispôsobené vašim **obchodným pravidlám predajcu** (napríklad brand conquesting a iné obmedzenia programu). 2. **Kanál TSV spravovaný predajcom** — Synchronizujete súbor, ktorý mapuje každý `product_code` na jednu alebo viacero `search_term` hodnôt, s voliteľným poradím a typom. Odporúčané kľúčové slová spravujete pre každý produkt zvlášť. Predajcovia sa môžu rozhodnúť použiť **Epsilon len vygenerované kľúčové slová**, **len váš súbor**, alebo **oboje** (napríklad AI návrhy **prekryté** na existujúcom zozname, alebo koordinovanú **náhradu** počas zavedenia, aby sa existujúce schválenia spracovali zámerne). Ak Epsilon dodáva **AI odporúčané kľúčové slová** pre váš program a **nepotrebujete** kanál TSV predajcu, začnite s [**Krok 3: Aktivujte AI odporúčané kľúčové slová (beta)**](#step-3-activate-ai-suggested-keywords-beta)**. Použite**[**Krok 2: Vytvorte súbor TSV**](#step-2-optional-build-the-tsv-file-retailer-supplied-path) len vtedy, keď udržiavate alebo dopĺňate kľúčové slová prostredníctvom súboru. ### Prečo používať odporúčané kľúčové slová? * Nasmerujte inzerentov na vyhľadávacie výrazy s vysokým nákupným zámerom a presnosťou pre dané produkty * Zobrazte výrazy, ktoré by inzerentom bez pomoci nemusely napadnúť * Zvýšte konkurenciu pri hodnotných kľúčových slovách pri zachovaní pravidiel programu * Znížte manuálnu prácu so súbormi, keď je zapnuté generovanie pomocou AI **Tento sprievodca pokrýva** * Predpoklady a kompletný postup * Autentifikáciu API pre postupy čítania/overovania * Aktiváciu AI krok za krokom (beta) a voliteľnú implementáciu TSV * Testovanie v prostredí Sandbox, kontrolný zoznam pred spustením, riešenie problémov ### Pravidlá zobrazovania Keď inzerenti pridajú **odporúčané** kľúčové slová do kampane, na zhodujúce sa vyhľadávacie výrazy zákazníkov sa môžu zobrazovať **iba produkty prepojené s týmto kľúčovým slovom**. Používateľské rozhranie zobrazuje, ktoré produkty sa mapujú na ktoré odporúčané kľúčové slová:
**Vlastné** vyhľadávacie výrazy zvolené inzerentom sa zvyčajne vzťahujú na všetky produkty kampane podľa pravidiel umiestnenia; **odporúčané** výbery obmedzujú spôsobilosť pomocou mapovania \*\*predajca / Epsilon. ## Predpoklady Tento kontrolný zoznam použite pred začiatkom. * [ ] **Predajca** zavedený (alebo v procese zavedenia) s Epsilon Retail Media, vrátane synchronizácie katalógu. * [ ] **Prístup do prostredia Sandbox** k používateľskému rozhraniu kampane a API, kde budete overovať kľúčové slová (ak je k dispozícii pre váš program). * [ ] **Pre doručenie TSV:** GCS bucket (alebo cesta) **zriadená používateľom** Epsilon\*\*, a prihlasovacie údaje, ktoré môže váš tím použiť na odovzdanie objektov (metóda potvrdená s Epsilon—často kľúč servisného účtu alebo federovaný prístup). Upozorňujeme, že ak robíte iba určenie rozsahu, toto sa rieši v rámci procesu aktivácie, ak dodávate kľúčové slová. * [ ] **Technický kontakt**, ktorý môže odovzdávať súbory, spúšťať kontroly API a koordinovať s Epsilon harmonogramy ingestovania a prechody. * [ ] **Povedomie o vydaní:** spôsobilosť produktov pre návrhy podľa kľúčových slov vyžaduje platformu (pozrite si Pravidlá zobrazovania vyššie). *** ## Prehľad toku integrácie 1. Potvrdíte s Epsilon ako budú kľúčové slová dodávané:Epsilon vygenerované\*\*, **súbor TSV** alebo **oboje**. 2. Ak poskytujete súbor, odovzdajte ho do bucketu GCS zriadeného spoločnosťou Epsilon. 3. Epsilon povolí túto funkciu a (v prípade súborov) ingestuje váš súbor. Pre kľúčové slová **AI** Epsilon sa dohodne na pravidlách, voliteľnom prekrytí vs. nahradení a overení v stagingu. 4. Údaje sa v platforme uložia ako **navrhované kľúčové slová**. 5. Pred spustením pre vašich inzerentov ich **overíte** vo svojom sandboxe priamo v UI. 6. Spustíte **ostrú prevádzku** v produkcii a oznámite tímom inzerentov, že navrhované kľúčové slová sú k dispozícii. *** ## Sprievodca implementáciou krok za krokom ### Krok 1: Potvrďte svoj model dodávania s Epsilon Účel\ Vyhnite sa budovaniu súborovej pipeline, ak vaše potreby spĺňa **iba AI**, alebo sa vyhnite duplicite práce, ak Epsilon za vás prekryje/nahradí zoznamy. **Čo musíte urobiť** * Rozhodnite sa: **iba AI**, **iba TSV** alebo **oboje**. * Potvrďte **prekrytie** vs. **nahradenie** pre akékoľvek existujúce údaje navrhovaných kľúčových slov. * Potvrďte, ktoré **umiestnenia** existujú (`ORGANIC` iba vs. aj `CROSS_SELL` / `SUBSTITUTE`). *** ### Krok 2: Aktivujte AI navrhované kľúčové slová **Účel**\ Získajte Epsilon-vygenerované kľúčové slová filtrované podľa pravidiel do platformy **bez** udržiavania TSV. **Čo musíte urobiť** 1. Zapojte Epsilon\*\* — Poskytnite svoje špecifické **obchodné pravidlá** (napríklad brand conquesting) a spôsob, akým by sa mali nové údaje vzťahovať k existujúcim zoznamom, ak už synchronizujete navrhované kľúčové slová (**prekrytie** vs. **nahradenie**). 2. Otestujte v sandboxe\*\* — Spolupracujte s Epsilon na načítanie alebo kontrolu kľúčových slov v **stagingu/sandboxe**. Vyskúšajte **Cielenie** v používateľskom rozhraní kampane na nečisto: vyberte produkty a potvrďte, že navrhované frázy vyzerajú správne. 3. Produkcia\*\* — Po schválení, Epsilon povolí produkciu. **Vy** oznámite tímom inzerentov, že navrhované kľúčové slová sú aktívne (v UI sa zobrazia po ich povolení). **Ako fungujú AI návrhy kľúčových slov** 1. **Pochopenie produktu** - Modelovanie využíva zámer produktu, kontext predajcu a jazyk. 2. **Generovanie kľúčových slov** - Z tohto pochopenia sa vygenerujú kandidátske kľúčové slová. 3. **Klasifikácia** - Kľúčové slová sa vyberajú pomocou údajov o reklamách a vyhľadávaní, aby sa dodržiavali pravidlá programu (napríklad konqueryng značky alebo špecifické pravidlá predajcu, ako je cielenie na zložky produktu). 4. **Načítanie pre UI** — Páry produkt–kľúčové slovo sa ukladajú v rovnakom systéme, aký používa tok **navrhovaných kľúčových slov** pri nastavovaní kampane. **Správa a riadenie** * Správanie pri schvaľovaní (**automatická vs. manuálna kontrola predajcom**) závisí od **konfigurácie programu** dohodnutej s Epsilon. * Ak máte **malú históriu dopytov na reklamu**, môžete byť požiadaní o zdieľanie **krátkej vzorky organických vyhľadávacích dopytov na webe** (napríklad za **sedem dní**), aby generovanie zodpovedalo reálnemu jazyku nakupujúcich. * **Veľmi veľké katalógy** môžu rozsah generovania obmedziť na produkty s **nedávnou reklamnou aktivitou** (napríklad za **posledných 90 dní**) namiesto každej SKU — potvrďte s Epsilon. * **AI generované navrhované kľúčové slová (beta)** sa momentálne zameriavajú na prípady organického vyhľadávania; podpora pre ďalšie typy umiestnení sa môže rozšíriť. **Overenie** * Navrhované kľúčové slová sa zobrazujú v sandboxovom **Cielení** pre produkty v rozsahu. * Správanie pri schvaľovaní (automatická vs. manuálna kontrola) zodpovedá konfigurácii programu. **Časté chyby** | Chyba | Riešenie | | ------------------------------------------------------------- | ---------------------------------------------------------------------- | | Kľúčové slová nevyzerajú v súlade so značkou alebo pravidlami | Upravte biznis pravidlá s Epsilon a znova spustite kontrolu v sandboxe | | Malo alebo žiadne návrhy pre veľké katalógy | Potvrďte, či je generovanie obmedzené na nedávno inzerované SKU | *** ### (Voliteľné pre Krok 2): Vytvorte súbor TSV (cesta poskytnutá predajcom) **Účel**\ Dodajte záväzné riadky **product\_code → search\_term** (a voliteľne rank/type). **Čo musíte urobiť** * Vygenerujte súbor oddelený tabulátormi s prepojeniami produktov a kľúčových slov. * Použite kódovanie **UTF-8** a zakončenia riadkov **LF**. * Zahrňte riadok hlavičky, ktorý zodpovedá názvom polí vo vašej špecifikácii feedu; minimálne: `product_code`, `search_term`, `search_term_type`. Pozrite [Dátové modely a definície polí](#data-models--field-definitions). * Udržiavajte približne **\~20 navrhovaných kľúčových slov na produkt** kvôli prehľadnosti. * Opakujte `product_code` na viacerých riadkoch pre viacero výrazov; použite `**search_term_type`\*\*, keď máte viacero druhov umiestnení. * Overte súbor a potom ho doručte do GCS bucketu, ktorý Epsilon zabezpečuje. **Poznámka:** Keď synchronizujete feed predajcu, Epsilon Retail Media zabezpečí **GCS bucket** pre odovzdanie súborov. Operácie platformy musia dokončiť konfiguráciu — počítajte s časom potrebným na aktiváciu. **Príklad súboru (ukážka)** ``` product_code search_term search_term_rank search_term_type abc123 cereal 1 ORGANIC abc123 cereals 2 ORGANIC 12345 milk 1 CROSS_SELL ``` Overenie * Otvorte v textovom editore: polia oddelené **tabulátorom**, žiadne nežiaduce zakončenia riadkov len s CR. * Náhodne skontrolujte niekoľko `product_code` hodnôt, či existujú vo vašom feede **katalógu**. **Časté chyby** | Chyba | Riešenie | | ------------------------------- | ------------------------------------------------------------- | | Čiarky CSV namiesto tabulátorov | Znovu exportujte ako TSV | | Nesprávne ID produktov | Zlaďte s `gtin` / `item` použitým pri synchronizácii katalógu | | Príliš veľa riadkov na SKU | Skráťte na výrazy s najvyššou hodnotou | *** ### Krok 3: Overte návrhy v UI **Účel**\ Zachyťte problémy s mapovaním na poslednú chvíľu pred produkciou. **Čo musíte urobiť** * V **sandboxe** vytvorte alebo upravte kampaň, vyberte umiestnenia, ktoré podporujú navrhované kľúčové slová, pridajte produkty, otvorte **Cielenie** / výber kľúčových slov. * Potvrďte navrhované frázy pre každý produkt a to, či **vlastné** vs. **navrhované** správanie zodpovedá vašim očakávaniam (pozrite \*\*Pravidlá zobrazovania v časti **Prehľad**). * Potvrďte, že **navrhované** výbery obmedzujú spôsobilé produkty na tie, ktoré sú prepojené vo vašom feede alebo AI kanáli. **Overenie** * Vo vašom sandboxovom UI: navrhované kľúčové slová sa zobrazujú pre produkty prepojené s kľúčovými slovami vo vašom súbore alebo AI kanáli. * Návrhy zodpovedajú očakávaniam umiestnenia a katalógu. **Časté chyby** | Chyba | Riešenie | | -------------------------------------- | -------------------------------------------------------------- | | Návrhy iba na jednom katalógu | Doplňte ostatné katalógy alebo upravte rozsah katalógu kampane | | Zobrazuje sa nesprávny typ umiestnenia | TAM skontroluje umiestnenie ↔ `search_term_type` konfiguráciu | *** ## Dátové modely a definície polí ### TSV (súbor predajcu) | Pole | Typ | Vyžadované | Popis | Akceptované hodnoty | | ------------------ | ------- | ---------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | `product_code` | string | Áno | Identifikátor produktu predajcu; rovnaký ako v katalógu `gtin` / `item` v príslušných prípadoch | Nie je prázdne; musí existovať v synchronizovanom katalógu | | `search_term` | string | Áno | Kľúčové slovo alebo fráza navrhnutá pre SKU | Text UTF-8; vyhýbajte sa riadiacim znakom | | `search_term_rank` | integer | No | Relatívna relevantnosť; **1** je najvyššia | Kladné celé čísla; nižšie = vyššia priorita | | `search_term_type` | string | No | Mapuje riadky na druhy umiestnení (**placement**) | `ORGANIC`, `CROSS_SELL`, `SUBSTITUTE`; predvolené sa spracováva ako `ORGANIC` ak je vynechané | | (konce riadkov) | — | — | Formát súboru | LF\*\*; kódovanie súboru \*\*UTF-8 | ### Typy umiestnení a `search_term_type` `search_term_type` sa zhoduje s typmi umiestnení: **ORGANIC**, **CROSS\_SELL** a **SUBSTITUTE**. Väčšina programov predajcov používa jedno umiestnenie pre **organické vyhľadávanie** pre štandardné reklamy vo výsledkoch vyhľadávania. **CROSS\_SELL** a **SUBSTITUTE** sú **samostatné umiestnenia** na stránke vyhľadávania (alebo súvisiacom inventári) s odlišným zámerom zobrazovania — nie sú to len dodatočné stĺpce v rovnakej organickej aukcii. Váš Technical Account Manager vám potvrdí, ktoré umiestnenia existujú pre váš menný priestor. **Ako sa typy umiestnení líšia** * **Organic** — Reklamy zodpovedajúce zámeru vyhľadávania kupujúceho pre daný produkt (napríklad kolový nápoj pri vyhľadaní „cola“). * **Cross-sell** — Doplnkový zámer (napríklad pizza pri vyhľadaní „cola“). * **Substitute** — Zámer pre podobný produkt (napríklad iný variant kolového nápoja pri vyhľadaní „cola“). Môžete synchronizovať **jeden kanál na typ umiestnenia** alebo **skombinovať typy v jednom súbore** (opakujte `product_code` s rôznymi `search_term_type`). Váš Technical Account Manager nakonfiguruje umiestnenia tak, aby sa pre každý povrch zobrazoval správny typ návrhu. Navrhované kľúčové slová môžu byť **zobrazené alebo skryté pre jednotlivé umiestnenia**. Kombinované typy pre 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äčšina programov používa iba umiestnenia pre **organické** vyhľadávanie. `CROSS_SELL` a `SUBSTITUTE` zodpovedajú **dodatočným umiestneniam**, nie „extra stĺpcom“ v rovnakej organickej pozícii — potvrdďte so svojím Technical Account Managerom, s ktorými umiestneniami pracujete. ### Viacero katalógov Implementujte navrhované kľúčové slová vo **všetkých** katalógoch vo vašom mennom priestore, ak je to možné (či už z vášho kanála, generovania prostredníctvom AI, alebo z oboch). Tým sa zníži zmätok ohľadom značky, keď jeden katalóg obsahuje návrhy a iné nie. Pri kampaniach s viacerými katalógmi, ak má dáta iba jeden katalóg, kampane závislé od navrhovaných výberov fungujú naplno iba v danom katalógu. \## *** ## Testovanie, Sandbox a Uvedenie do prevádzky **Sandbox / testovacie prostredie** * Overte návrhy v používateľskom rozhraní v kroku **Cielenie** kampane. **Vzorové testovacie prípady** | Test | Kroky | Očakávaný výsledok | | --------------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | Návrhy v používateľskom rozhraní sú viditeľné | Pridajte produkty v sandboxovej kampani; otvorte **Cielenie** | Navrhované kľúčové slová sa zobrazujú pre každý produkt | | Pravidlo zobrazovania | Vyberte navrhované kľúčové slovo prepojené s podmnožinou produktov | Pre daný výraz sú spôsobilé iba prepojené produkty | | Pokrytie naprieč viacerými katalógmi | Opakujte kontrolu používateľského rozhrania naprieč katalógmi v mennom priestore | Návrhy sú prítomné vo všetkých katalógoch s dátami (alebo je rozsah zdokumentovaný) | Kontrolný zoznam pre uvedenie do prevádzky * [ ] TSV bolo spracované bez chýb (ak sa používa cesta k súboru) alebo bola schválená AI pipeline (ak sa používa beta) * [ ] Navrhované kľúčové slová sú viditeľné v používateľskom rozhraní sandboxu pre reprezentatívne produkty * [ ] Menné priestory s viacerými katalógmi majú pokrytie vo všetkých katalógoch (alebo je rozsah zdokumentovaný) * [ ] Komunikácia inzerentovi bola odoslaná pred alebo pri aktivácii v produkcii * [ ] Partner API vracia očakávané riadky v produkcii (náhodná kontrola) *** ## Riešenie problémov a časté otázky **Problém:** Návrhy sa v používateľskom rozhraní nikdy nezobrazia.\ **Pravdepodobná príčina:** Import nie je povolený, nesprávny katalóg alebo pozícia nie je nakonfigurovaná.\ Riešenie:\*\* Potvrďte s Epsilon že import z GCS alebo AI pipeline je aktívny; overte mapovanie pozícií pre `search_term_type`. **Môžeme použiť jeden súbor TSV pre viacero typov pozícií?**\ Áno. Opakujte `product_code` na viacerých riadkoch s rôznymi `search_term_type` hodnotami. Váš Technical Account Manager nakonfiguruje, ktoré typy sa zobrazia pre danú pozíciu. **Čo ak máme viacero katalógov v jednom namespace?**\ Implementujte odporúčané kľúčové slová vo všetkých katalógoch, ak je to možné. Kampane, ktoré závisia od odporúčaných výberov, fungujú naplno len v katalógoch s dátami. **Pri kontaktovaní podpory uveďte:** * Namespace a ID katalógu * Vzorku `product_code` a očaká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/sk/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.