> 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/hu/feature-integrations/suggested-keywords.md). # Javasolt kulcsszavak A **javasolt kulcsszavak** összekötik a **keresési kifejezéseket** a katalógusában található **termékkódokkal**. Amikor a hirdetők kampányokat építenek, ezek a kifejezések a **Célzás** (keresési kulcsszavak kiválasztása) során jelennek meg az általuk hozzáadott termékeknél. A hirdetők a javaslatokból is választhatnak ahelyett, hogy csak egyéni kulcsszavakat írnának be, ami javítja az igazodást ahhoz, ahogyan az Ön webhelye indexeli a keresést, és ahogyan Ön a SKU-kat a lekérdezésekhez szeretné rendelni.
**A javasolt kulcsszavak kétféleképpen adhatók meg:** 1. **Epsilon AI által generált kulcsszavak** — Epsilon az Ön nevében generálja, osztályozza és betölti a termék–kulcsszó párokat. **Nem szükséges** külön kulcsszófájlt fenntartania ezekhez a javaslatokhoz, ha kizárólag ezt az útvonalat használja. A generálás a termék és a katalógus kontextusát, a vásárlói keresési viselkedést, valamint az Ön **kereskedői üzleti szabályaihoz** (például márkakeresési hódítás és egyéb programkorlátok) igazodó szignálokat használja. 2. **Kereskedő által kezelt TSV-hírcsatorna** — Ön szinkronizál egy fájlt, amely az egyes `product_code` elemeket egy vagy több `search_term` értékhez rendeli, opcionális rangsorral és típussal. A javasolt kulcsszavakat termékenként Ön kezeli. A kereskedők dönthetnek úgy, hogy **csak a(z)Epsilon által generált kulcsszavakat**, **csak az Ön fájlját**, vagy **mindkettőt** használják (például AI-javaslatokat egy meglévő listára **ráillesztve**, vagy koordinált **cserét** a bevezetés során, hogy a meglévő jóváhagyásokat szándékosan kezeljék). Ha a(z) Epsilon biztosítja az **AI által javasolt kulcsszavakat** az Ön programjához, és **nincs** szüksége kereskedői TSV-hírcsatornára, kezdje a [**3. lépés: Az AI által javasolt kulcsszavak aktiválása (béta)**](#step-3-activate-ai-suggested-keywords-beta)**résszel. A**[**2. lépés: A TSV-fájl megépítése**](#step-2-optional-build-the-tsv-file-retailer-supplied-path) részt csak akkor használja, ha a kulcsszavakat fájlon keresztül tartja karban vagy egészíti ki. ### Miért érdemes javasolt kulcsszavakat használni? * A hirdetők terelése a magas vásárlási szándékot mutató, termékpontos keresési kifejezések felé * Olyan kifejezések felszínre hozása, amelyekre a hirdetők útmutatás nélkül esetleg nem gondolnának * A verseny növelése az értékes kulcsszavakért a program szabályainak betartása mellett * A manuális fájlmunkák csökkentése az AI-generálás engedélyezésekor **Ez az útmutató a következőket tartalmazza:** * Előfeltételek és a teljes folyamat * API-hitelesítés az olvasási/érvényesítési folyamatokhoz * Lépésről lépésre történő AI-aktiválás (béta) és opcionális TSV-implementáció * Sandbox tesztelés, ellenőrzőlista az élesítéshez, hibaelhárítás ### Kiszolgálási szabályok Amikor a hirdetők **javasolt** kulcsszavakat adnak egy kampányhoz, **csak az adott kulcsszóhoz kapcsolódó termékek** jogosultak megjelenni a egyező ügyfélkeresési kifejezésekre. A felhasználói felület megmutatja, hogy mely termékek mely javasolt kulcsszavakhoz tartoznak:
A hirdető által választott **egyéni** keresési kifejezések általában a elhelyezési szabályoknak megfelelően a kampány összes termékére érvényesek; a **javasolt** kijelölések a \*\*kereskedő / Epsilonhozzárendelés használatával korlátozzák a jogosultságot. ## Előfeltételek Használja ezt az ellenőrzőlistát a kezdés előtt. * [ ] **Kereskedő** regisztrálva (vagy folyamatban) a(z) Epsilon Retail Mediarendszerében, beleértve a katalógusszinkronizálást is. * [ ] **Sandbox hozzáférés** a kampány felhasználói felületéhez és API-jaihoz, ahol érvényesíteni fogja a kulcsszavakat (amikor elérhető az Ön programjában). * [ ] **TSV-szállítás esetén:** GCS bucket (vagy útvonal) **biztosítva a(z)** Epsilon\*\*, és a csapata által az objektumok feltöltéséhez használható hitelesítő adatok (a módszert egyeztette a(z) Epsilon—gyakran szolgáltatási fiók kulcsa vagy federált hozzáférés). Megjegyzés: ha csak a hókör meghatározását végzi, ez az aktiválási folyamat részeként kerül kezelésre, ha kulcsszavakat biztosít. * [ ] **Technikai kapcsolattartó**, aki fájlokat tud feltölteni, API-ellenőrzéseket tud futtatni, és egyeztetni tud a(z) Epsilon féllel a betöltési ütemezésekről és az átállásokról. * [ ] **Kiadási tudnivalók:** a kulcsszavankénti termékjogosultság a javaslatokhoz platformot igényel (lásd a fenti Kiszolgálási szabályokat). *** ## Integrációs folyamat áttekintése 1. Jóváhagyja a(z) Epsilon féllel, hogyan lesznek biztosítva a kulcsszavak:Epsilon generált\*\*, **TSV fájl**, vagy **mindkettő**. 2. Ha fájlt biztosít, töltse fel azt a(z) Epsilon. 3. Epsilon által biztosított GCS bucketbe, engedélyezi a funkciót, és (fájlok esetén) betölti a fájlt. Az **AI** kulcsszavakhoz a(z) Epsilon egyezteti a szabályokat, az opcionális rátételt (overlay) vagy cserét (replace), valamint a staging validációt. 4. Az adatok **javasolt kulcsszavakként** landolnak a platformon. 5. A hirdetők felé történő indulás előtt **ellenőrizze** azokat a sandbox környezetben, közvetlenül a felhasználói felületen. 6. Ön **élesíti** a rendszert a produkciós környezetben, és értesíti a hirdetői csapatokat, hogy a javasolt kulcsszavak elérhetők. *** ## Lépésről lépésre követhető megvalósítási útmutató ### 1. lépés: Erősítse meg az ellátási modellt a(z) Epsilon Cél\ Kerülje el a fájlcsővezeték kiépítését, ha a **csak AI** megfelel az igényeinek, vagy kerülje el a párhuzamos munkát, ha a(z) Epsilon felülírja/lecseréli a listákat Ön helyett. **Teendők** * Döntse el: **Csak AI**, **csak TSV**, vagy **mindkettő**. * Erősítse meg a **rátételt (overlay)** a **cserével (replace)** szemben a meglévő javasolt kulcsszóadatoknál. * Erősítse meg, hogy mely **elhelyezések** léteznek (`ORGANIC` csak vs. szintén `CROSS_SELL` / `SUBSTITUTE`). *** ### 2. lépés: Az AI által javasolt kulcsszavak aktiválása **Cél**\ A(z) Epsilonáltal generált, szabályokkal szűrt kulcsszavak bejuttatása a platformra a TSV karbantartása **nélkül**. **Teendők** 1. Lépjen kapcsolatba a(z) Epsilonféllel — Adja meg a specifikus **üzleti szabályait** (például márkameghódítás/brand conquesting), és azt, hogy az új adatok hogyan kapcsolódjanak a meglévő listákhoz, ha már szinkronizál javasolt kulcsszavakat (**rátétel/overlay** vs **csere/replace**). 2. Tesztelés sandbox környezetben\*\* — Működjön együtt a(z) Epsilon kulcsszavak betöltéséhez vagy áttekintéséhez a **staging/sandbox** környezetben. Futtasson próba-**Célzást** a kampány felületén: válasszon termékeket, és ellenőrizze, hogy a javasolt kifejezések megfelelőnek tűnnek-e. 3. Éles környezet (Production)\*\* — A jóváhagyás után, Epsilon engedélyezi az éles működést. **Ön** értesíti a hirdetői csapatokat, hogy a javasolt kulcsszavak élesek (a felületen az engedélyezés után fognak megjelenni). **Hogyan működnek az AI-kulcsszavas javaslatok** 1. **Értse meg a terméket** - A modellezés a termékszándékot, a kereskedői kontextust és a nyelvet használja. 2. **Kulcsszavak generálása** - Ebből a megértésből jönnek létre a jelölt kulcsszavak. 3. **Osztályozás** - A kulcsszavak kiválasztása hirdetési és keresési adatok alapján történik, hogy a megbízási szabályok (például a márkatúllicitálás vagy a kereskedőspecifikus irányelvek, mint a termék összetevőinek célzása) teljesüljenek. 4. **Betöltés a felületre** — A termék–kulcsszó párok ugyanabban a rendszerben tárolódnak, mint amelyet a kampánybeállítás **javasolt kulcsszó** folyamata használ. **Irányítás (Governance)** * A jóváhagyási viselkedés (**automatikus vs. manuális kereskedői áttekintés**) a megállapodott **programkonfigurációtól** függ Epsilon. * Ha **kevés a hirdetési lekérdezési előzménye**, felkérhetik arra, hogy ossza meg az **szerves helyszíni keresési lekérdezések egy rövid mintáját** (például körülbelül **hét napot**), hogy a generálás illeszkedjen a valódi vásárlói nyelvhez. * **Nagy katalógusok** esetén a generálás a **közelmúltban hirdetési tevékenységet mutató** termékekre korlátozódhat (például az **elmúlt 90 napra**) az összes SKU helyett — egyeztessen a következőkkel: Epsilon. * Az **AI által generált javasolt kulcsszavak (béta)** jelenleg a **szerves** keresési használati esetekre összpontosítanak; a további elhelyezési típusok támogatása bővülhet. **Ellenőrzés** * A javasolt kulcsszavak megjelennek a sandbox **Célzás** menüpontjában a hatókörbe tartozó termékeknél. * A jóváhagyási viselkedés (automatikus vs. manuális áttekintés) megegyezik a programkonfigurációval. **Gyakori hibák** | Hiba | Javítás | | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- | | A kulcsszavak nem márkakompatibilisnek vagy nem az irányelveknek megfelelőnek tűnnek | Finomítsa az üzleti szabályokat a következőkkel: Epsilon és futtassa újra a sandbox áttekintést | | Kevés vagy semmilyen javaslat nincs a nagy katalógusokhoz | Erősítse meg, hogy a generálás a közelmúltban hirdetett SKU-kra van-e korlátozva | *** ### (Opcionális a 2. lépéshez): Építse fel a TSV-fájlt (kereskedő által biztosított útvonal) **Cél**\ Hiteles **product\_code → search\_term** sorok (és opcionális rangsor/típus) megadása. **Mit kell tennie** * Hozzon létre egy tabulátorral tagolt fájlt a termék- és kulcsszó-összekapcsolásokról. * Használjon **UTF-8** kódolást és **LF** sorvégződéseket. * Tartalmazzon egy fejlécsort, amely megegyezik a csatorna-specifikáció által használt mezőnevekkel; legalább: `product_code`, `search_term`, `search_term_type`. Lásd: [Adatmodellek és meződefiníciók](#data-models--field-definitions). * A használhatóság érdekében tartson körülbelül **\~20 javasolt kulcsszót termékenként**. * Ismételje meg a(z) `product_code` elemet több sorban több kifejezéshez; használja a következőt: `**search_term_type`\*\*, ha több elhelyezési típusa van. * Ellenőrizze a fájlt, majd adja át a GCS-tárolónak (bucket) Epsilon beállítások. **Megjegyzés:** Amikor szinkronizálja a kereskedői adatcsatornát, Epsilon Retail Media beállít egy **GCS-tárolót (bucket)** a feltöltésekhez. A platformműveleteknek be kell fejezniük a konfigurációt — hagyjon átfutási időt az aktiváláshoz. **Példa fájl (részlet)** ``` product_code search_term search_term_rank search_term_type abc123 cereal 1 ORGANIC abc123 cereals 2 ORGANIC 12345 milk 1 CROSS_SELL ``` Ellenőrzés * Nyissa meg egy szövegszerkesztőben: a mezőket **tabulátor** választja el, nincsenek eltévedt, csak CR sorvégződések. * Ellenőrizzen szúrópróbaszerűen többet `product_code` értékek léteznek a **katalógus** adatcsatornában. **Gyakori hibák** | Hiba | Javítás | | --------------------------------- | ------------------------------------------------------------------------------- | | CSV vesszők a tabulátorok helyett | Exportálja újra TSV formátumban | | Hibás termékazonosítók | Igazítsa a következöhöz: `gtin` / `item` a katalógus-szinkronizálásban használt | | Túl sok sor jut egy SKU-ra | Vágja vissza a legértékesebb kifejezésekre | *** ### 3. lépés: Ellenőrizze a javaslatokat a felületen **Cél**\ A az utolsó pillanatban felmerülő leképezési problémák kiszűrése az élesítés előtt. **Mit kell tennie** * A **sandbox** környezetben hozzon létre vagy szerkesszen egy kampányt, válasszon ki olyan elhelyezéseket, amelyek támogatják a javasolt kulcsszavakat, adjon hozzá termékeket, nyissa meg a **Célzás** / kulcsszó-kiválasztást. * Erősítse meg a termékenkénti javasolt kifejezéseket, és azt, hogy az **egyéni** vs. **javasolt** viselkedés megfelel-e az elvárásainak (lásd \*\*Kiszolgálási szabályok az **Áttekintésben**). * Erősítse meg, hogy a **javasolt** kijelölések a jogosult termékeket azokra korlátozzák, amelyek össze vannak kapcsolva az adatcsatornájában vagy az AI-folyamatban. **Ellenőrzés** * A sandbox felületén: a javasolt kulcsszavak megjelennek a fájlban vagy az AI-folyamatban a kulcsszavakhoz kapcsolódó termékeknél. * A javaslatok illeszkednek az elhelyezési és katalógus-elvárásokhoz. **Gyakori hibák** | Hiba | Javítás | | --------------------------------------- | ------------------------------------------------------------------------------- | | Javaslatok csak egy katalógusban | Töltse fel a többi katalógust, vagy módosítsa a kampány katalógusának hatókörét | | Helytelen elhelyezési típus jelenik meg | A TAM áttekinti az elhelyezést ↔ `search_term_type` konfiguráció | *** ## Adatmodellek és meződefiníciók ### TSV (kereskedői fájl) | Mező | Típus | Kötelező | Leírás | Elfogadott értékek | | ------------------ | ---------- | -------- | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | `product_code` | string | Igen | Kereskedői termékazonosító; megegyezik a katalógusban szereplővel `gtin` / `item` ha alkalmazható | Nem üres; léteznie kell a szinkronizált katalógusban | | `search_term` | string | Igen | A SKU-hoz javasolt kulcsszó vagy kifejezés | UTF-8 szöveg; kerülje a vezérlőkaraktereket | | `search_term_rank` | egész szám | No | Relatív relevanciaszint; az **1-es** a legmagasabb | Pozitív egész számok; az alacsonyabb = magasabb prioritás | | `search_term_type` | string | No | Sorokat rendel a **placement** típusokhoz | `ORGANIC`, `CROSS_SELL`, `SUBSTITUTE`; az alapértelmezett beállítás kezelése: `ORGANIC` ha hiányzik | | (sorvégződések) | — | — | Fájlformátum | LF\*\*; fájlkódolás \*\*UTF-8 | ### Elhelyezéstípusok és `search_term_type` `search_term_type` igazodik az elhelyezéstípusokhoz: **ORGANIC**, **CROSS\_SELL** és **SUBSTITUTE**. A legtöbb kereskedői program egyetlen **organic search** elhelyezést használ a standard keresési találati hirdetésekhez. A **CROSS\_SELL** és a **SUBSTITUTE** **különálló elhelyezések** a keresési oldalon (vagy a kapcsolódó felületeken) eltérő kiszolgálási szándékkal—nem csupán plusz oszlopok ugyanabban az organikus aukcióban. A technikai fiókkezelője (Technical Account Manager) megerősíti, hogy mely elhelyezések léteznek az Ön névteréhez. **Miben különböznek az elhelyezéstípusok** * **Organic** — A vásárló termékre vonatkozó keresési szándékához illesztett hirdetések (például egy kóla termék a "kóla" keresésre). * **Cross-sell** — Kiegészítő szándék (például pizza a "kóla" keresésre). * **Substitute** — Hasonló termékre vonatkozó szándék (például egy másik kólaváltozat a "kóla" keresésre). Szinkronizálhat **elhelyezéstípusonként egy feedet**, vagy **egyesítheti a típusokat egyetlen fájlban** (ismételje meg a `product_code` eltérő értékkel: `search_term_type`). A technikai fiókkezelője úgy konfigurálja az elhelyezéseket, hogy a megfelelő javaslattípus jelenjen meg felületenként. A javasolt kulcsszavak **elhelyezésenként megjeleníthetők vagy elrejthetők**. Egyesített típusok egy termékhez: | product\_code | search\_term | search\_term\_rank | search\_term\_type | | ------------- | ------------ | ------------------ | ------------------ | | 12345 | cookies | 1 | ORGANIC | | 12345 | cookie | 2 | ORGANIC | | 12345 | milk | 1 | CROSS\_SELL | **Megjegyzés:** A legtöbb program csak **organic** keresési elhelyezéseket használ. `CROSS_SELL` és `SUBSTITUTE` a **további elhelyezéseknek** felelnek meg, nem pedig "extra oszlopoknak" ugyanabban az organikus slotban—egyeztesse a technikai fiókkezelőjével, hogy mely elhelyezésekkel dolgozik. ### Több katalógus Ha lehetséges, valósítsa meg a javasolt kulcsszavakat a névtérben található **összes** katalógusban (akár a feedből, akár AI általi generálásból származnak, vagy mindkettőből). Ez csökkenti a márkával kapcsolatos félreértéseket, ha az egyik katalógusban vannak javaslatok, míg a többiben nincsenek. Több katalógust használó kampányok esetén, ha csak egy katalógus tartalmaz adatokat, a javasolt kijelölésektől függő kampányok csak abban az egy katalógusban működnek teljeskörűen. \## *** ## Tesztelés, Sandbox és Élesítés **Sandbox / tesztkörnyezet** * Ellenőrizze a felületi javaslatokat a kampány **Targeting** (Célzás) lépésében. **Minta tesztesetek** | Teszt | Lépések | Elvárt eredmény | | ----------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | Felületi javaslatok láthatóak | Adjon hozzá termékeket a sandbox kampányban; nyissa meg a **Targeting** lépést | A javasolt kulcsszavak megjelennek termékenként | | Kiszolgálási szabály | Válasszon ki egy javasolt kulcsszót, amely a termékek egy részhalmazához van kapcsolva | Csak a kapcsolódó termékek jogosultak arra a kifejezésre | | Több katalógusos lefedettség | Ismételje meg a felületi ellenőrzést a névtér katalógusai között | A javaslatok jelen vannak minden adattal rendelkező katalógusban (vagy a terjedelem dokumentálva van) | Élesítési ellenőrzőlista * [ ] TSV beolvasva hiba nélkül (fájlelérési út használata esetén) vagy az AI pipeline jóváhagyva (béta használata esetén) * [ ] A javasolt kulcsszavak láthatóak a sandbox felületen a reprezentatív termékeknél * [ ] A több katalógussal rendelkező névterek minden katalógusban rendelkeznek lefedettséggel (vagy a terjedelem dokumentálva van) * [ ] Hirdetői tájékoztató kiküldve a élesítés előtt vagy azzal egy időben * [ ] A Partner API az elvárt sorokat adja vissza éles környezetben (szúrópróbaszerű ellenőrzés) *** ## Hibaelhárítás és GYIK **Probléma:** A javaslatok soha nem jelennek meg a felületen.\ **Valószínű ok:** Az adatbetöltés nincs engedélyezve, hibás katalógus vagy a kihelyezés nincs konfigurálva.\ Megoldás:\*\* Erősítse meg a(z) Epsilon partnerekkel, hogy a GCS adatbetöltés vagy az AI csővezeték aktív; ellenőrizze a kihelyezés feltérképezését a következőhöz: `search_term_type`. **Használhatunk egyetlen TSV-t több kihelyezési típushoz?**\ Igen. Ismételje meg a(z) `product_code` elemet több sorban, eltérő `search_term_type` értékekkel. A technikai fiókmenedzsere állítja be, hogy mely típusok jelenjenek meg kihelyezésenként. **Mi a teendő, ha egy névtérben több katalógusunk is van?**\ Amikor csak lehetséges, valósítsa meg a javasolt kulcsszavakat az összes katalógusban. A javasolt kijelölésektől függő kampányok csak azokon a katalógusokon működnek teljes mértékben, amelyek tartalmaznak adatokat. **Amikor kapcsolatba lép az ügyfélszolgálattal, adja meg a következőket:** * Névtér és katalógus-azonosító * Minta `product_code` és elvárt `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/hu/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.