> 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/sv/feature-integrations/suggested-keywords.md). # Föreslagna sökord **Föreslagna sökord** kopplar **söktermer** till **produktkoder** i din katalog. När annonsörer skapar kampanjer visas dessa termer under **Målinriktning** (val av sökord) för de produkter de lägger till. Annonsörer kan välja från förslag i stället för att enbart ange anpassade sökord, vilket förbättrar anpassningen till hur din webbplats indexerar sökningar och hur du vill att kampanjer ska matcha SKU:er mot sökfrågor.
**Föreslagna sökord kan tillhandahållas på två sätt:** 1. **Epsilon AI-genererade sökord** — Epsilon genererar, klassificerar och läser in produkt–sökordspar för din räkning. Du **behöver inte** underhålla en separat sökordsfil för dessa förslag när denna väg är din enda källa. Genereringen använder produkt- och katalogkontext, köpares sökbeteende och signaler som är anpassade till dina **återförsäljares affärsregler** (till exempel varumärkeserövring och andra programbegränsningar). 2. **Återförsäljarhanterat TSV-flöde** — Du synkroniserar en fil som matchar varje `product_code` till ett eller flera `search_term` -värden, med valfri rangordning och typ. Du hanterar de föreslagna sökorden per produkt. Återförsäljare kan välja att använda **Epsilon endast genererade sökord**, **endast din fil**, eller **båda** (till exempel AI-förslag **överlagrade** på en befintlig lista, eller en koordinerad **ersättning** under utrullningen så att befintliga godkännanden hanteras avsiktligt). Om Epsilon tillhandahåller **AI-föreslagna sökord** för ditt program och du **inte** behöver ett TSV-flöde för återförsäljare, börja med [**Steg 3: Aktivera AI-föreslagna sökord (beta)**](#step-3-activate-ai-suggested-keywords-beta)**. Använd**[**Steg 2: Bygg TSV-filen**](#step-2-optional-build-the-tsv-file-retailer-supplied-path) endast när du underhåller eller kompletterar sökord via fil. ### Varför använda föreslagna sökord? * Styr annonsörer mot söktermer med hög köpintention och hög produktprecision * Lyft fram termer som annonsörer kanske inte tänker på utan vägledning * Öka konkurrensen på värdefulla sökord och följ samtidigt programreglerna * Minska manuellt filarbete när AI-generering är aktiverad **Den här guiden täcker** * Förutsättningar och flöde från början till slut * API-autentisering för läs-/valideringsflöden * Steg-för-steg AI-aktivering (beta) och valfri TSV-implementering * Sandlådetestning, checklista för go-live, felsökning ### Visningsregler När annonsörer lägger till **föreslagna** sökord i en kampanj är **endast produkter som är länkade till det sökordet** behöriga att visas på matchande kundsöktermer. Användargränssnittet visar vilka produkter som matchar vilka föreslagna sökord:
**Anpassade** söktermer som väljs av annonsören gäller vanligtvis över kampanjprodukter i enlighet med placeringsregler; **föreslagna** val begränsar behörigheten med hjälp av \*\*återförsäljar- / Epsilon-matchningen. ## Förutsättningar Använd den här checklistan innan du börjar. * [ ] **Återförsäljare** onboardad (eller pågår) med Epsilon Retail Media, inklusive katalogsynkronisering. * [ ] **Sandlådeåtkomst** till kampanjens användargränssnitt och API:er där du validerar sökord (när det är tillgängligt för ditt program). * [ ] **För TSV-leverans:** GCS-bucket (eller sökväg) **tillhandahållen av Epsilon**, och autentiseringsuppgifter som ditt team kan använda för att överföra objekt (metod bekräftad med Epsilon—ofta tjänstekontonyckel eller federerad åtkomst). Observera att om du bara gör en omfattningsbedömning hanteras detta som en del av aktiveringsprocessen om du tillhandahåller sökord. * [ ] **Teknisk kontakt** som kan överföra filer, köra API-kontroller och koordinera med Epsilon om inläsningsscheman och övergångar. * [ ] **Lanseringsmedvetenhet:** produktbehörighet per sökord för förslag kräver plattform (se Visningsregler ovan). *** ## Översikt över integrationsflödet 1. Du bekräftar med Epsilon hur sökord kommer att tillhandahållas:Epsilon genererade\*\*, **TSV-fil**, eller **båda**. 2. Om du tillhandahåller en fil överför du den till den GCS-bucket som tillhandahålls av Epsilon. 3. Epsilon aktiverar funktionen och (för filer) läser in din fil. För **AI**-sökord, Epsilon samordnar regler, valfri överlagring jämfört med ersättning, samt validering i staging. 4. Data landar som **föreslagna sökord** i plattformen. 5. Du **verifierar** i din sandlåda direkt i användargränssnittet före lansering till dina annonsörer. 6. Du **går live** i produktion och meddelar annonsörsteamen att föreslagna sökord är tillgängliga. *** ## Steg-för-steg-implementeringsguide ### Steg 1: Bekräfta din försörjningsmodell med Epsilon Syfte\ Undvik att bygga en filpipeline om **endast AI** uppfyller dina behov, eller undvik dubbelarbete om Epsilon kommer att överlagra/ersätta listor åt dig. **Vad du behöver göra** * Bestäm: **Endast AI**, **endast TSV**, eller **båda**. * Bekräfta **överlagring** jämfört med **ersättning** för befintliga data för föreslagna sökord. * Bekräfta vilka **placeringar** som finns (`ORGANIC` endast kontra även `CROSS_SELL` / `SUBSTITUTE`). *** ### Steg 2: Aktivera AI-föreslagna sökord **Syfte**\ Få Epsilon-genererade, regelfiltrerade sökord till plattformen **utan** att underhålla en TSV. **Vad du behöver göra** 1. Engagera Epsilon\*\* — Tillhandahåll dina specifika **affärsregler** (till exempel varumärkeserövring), och hur nya data ska relatera till befintliga listor om du redan synkroniserar föreslagna sökord (**överlagring** jämfört med **ersättning**). 2. Testa i sandlåda\*\* — Arbeta med Epsilon för att läsa in eller granska sökord i **staging/sandbox**. Testkör **Inriktning** i kampanjens användargränssnitt: välj produkter och bekräfta att föreslagna fraser ser korrekta ut. 3. Produktion\*\* — Efter godkännande, Epsilon aktiverar produktionen. **Du** kommunicerar till annonsörsteamen att de föreslagna sökorden är live (användargränssnittet visar dem när de har aktiverats). **Så fungerar AI-sökordsförslag** 1. **Förstå produkten** – Modelleringen använder produktens avsikt, återförsäljarens kontext och språk. 2. **Generera sökord** – Kandidatsökord skapas utifrån denna förståelse. 3. **Klassificera** – Sökord väljs ut med hjälp av annons- och sökdata så att programregler (till exempel varumärkeserövring eller återförsäljarspecifika policyer som att rikta in sig på ingredienserna i en produkt) följs. 4. **Läs in för användargränssnittet** — Produkt–sökordspar lagras i samma system som används av flödet för **föreslagna sökord** i kampanjinställningen. **Styrning** * Beteende för godkännande (**automatisk vs manuell återförsäljargranskning**) beror på den **programkonfiguration** som avtalats med Epsilon. * Om du har **lite historik över annonsfrågor** kan du bli bedd att dela ett **kort urval av organiska sökförfrågningar på webbplatsen** (till exempel cirka **sju dagar**) så att genereringen matchar det faktiska köpande kundspråket. * **Mycket stora kataloger** kan avgränsa genereringen till produkter med **nyligen genomförd annonsaktivitet** (till exempel de **senaste 90 dagarna**) i stället för varje SKU — bekräfta med Epsilon. * **AI-genererade föreslagna sökord (beta)** fokuserar för närvarande på användningsfall för **organisk** sökning; stöd för ytterligare placeringstyper kan utökas. **Validering** * Föreslagna sökord visas i sandbox-**Inriktning** för produkter som omfattas. * Beteende för godkännande (automatisk vs manuell granskning) matchar programkonfigurationen. **Vanliga fel** | Fel | Lösning | | ------------------------------------------------------- | --------------------------------------------------------------------- | | Sökorden ser ut att strida mot varumärket eller policyn | Förfina affärsreglerna med Epsilon och kör sandbox-granskningen igen | | Få eller inga förslag för stora kataloger | Bekräfta om genereringen är avgränsad till nyligen annonserade SKU:er | *** ### (Valfritt för steg 2): Bygg din TSV-fil (sökväg tillhandahållen av återförsäljaren) **Syfte**\ Tillhandahåll auktoritativa **product\_code → search\_term**-rader (samt valfri rangordning/typ). **Vad du behöver göra** * Generera en tabbladdad fil med kopplingar mellan produkter och sökord. * Använd **UTF-8**-kodning och **LF**-radbrytningar. * Inkludera en rubrikrad som matchar de fältnamn som din flödesspecifikation använder; som minst: `product_code`, `search_term`, `search_term_type`. Se [Datamodeller och fältdefinitioner](#data-models--field-definitions). * Håll dig till cirka **\~20 föreslagna sökord per produkt** för användbarhetens skull. * Upprepa `product_code` på flera rader för flera termer; använd `**search_term_type`\*\* när du har flera typer av placeringar. * Validera filen och leverera den sedan till den GCS-bucket som Epsilon tillhandahåller. **Obs:** När du synkroniserar ett återförsäljarflöde, Epsilon Retail Media tillhandahåller en **GCS-bucket** för filer. Plattformsdriften måste slutföra konfigurationen — beräkna handläggningstid för aktivering. **Exempelfil (utdrag)** ``` product_code search_term search_term_rank search_term_type abc123 cereal 1 ORGANIC abc123 cereals 2 ORGANIC 12345 milk 1 CROSS_SELL ``` Validering * Öppna i en textredigerare: fält separerade med **tabb**, inga felaktiga radbrytningar med endast CR. * Stickprovskontrollera att flera `product_code` -värden finns i ditt **katalog**-flöde. **Vanliga fel** | Fel | Lösning | | ------------------------------------ | ------------------------------------------------------------------ | | CSV-kommatecken i stället för tabbar | Exportera om som TSV | | Felaktiga produkt-ID:n | Anpassa till `gtin` / `item` som används i katalogsynkroniseringen | | För många rader per SKU | Minska till de mest värdefulla termerna | *** ### Steg 3: Verifiera förslag i användargränssnittet **Syfte**\ Upptäck kartläggningsproblem i sista minuten före produktion. **Vad du behöver göra** * Skapa eller redigera en kampanj i **sandbox**, välj placeringar som stöder föreslagna sökord, lägg till produkter, öppna **Inriktning** / sökordsval. * Bekräfta föreslagna fraser per produkt och att beteendet för **anpassat** vs **föreslagit** matchar dina förväntningar (se \*\*Visningsregler i **Översikt**). * Bekräfta att **föreslagna** val begränsar kvalificerade produkter till de som är länkade i ditt flöde eller din AI-pipeline. **Validering** * I ditt sandbox-användargränssnitt: föreslagna sökord visas för produkter som är länkade till sökord i din fil eller AI-pipeline. * Förslagen stämmer överens med förväntningarna på placering och katalog. **Vanliga fel** | Fel | Lösning | | ---------------------------- | ------------------------------------------------------------------ | | Förslag endast på en katalog | Fyll på andra kataloger eller justera kampanjens katalogomfattning | | Fel placeringstyp visas | TAM granskar placering ↔ `search_term_type` konfiguration | *** ## Datamodeller och fältdefinitioner ### TSV (återförsäljarfil) | Fält | Typ | Obligatorisk | Beskrivning | Tillåtna värden | | ------------------ | ------ | ------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | | `product_code` | sträng | Ja | Återförsäljarens produktidentifierare; samma som i katalogen `gtin` / `item` i förekommande fall | Icke-tom; måste finnas i den synkroniserade katalogen | | `search_term` | sträng | Ja | Sökord eller fras som föreslås för SKU:n | UTF-8-text; undvik styrtecken | | `search_term_rank` | heltal | No | Relativ relevans; **1** är högst | Positiva heltal; lägre = högre prioritet | | `search_term_type` | sträng | No | Mappar rader till **placement**-typer | `ORGANIC`, `CROSS_SELL`, `SUBSTITUTE`; standardvärde behandlas som `ORGANIC` om utelämnats | | (radbrytningar) | — | — | Filformat | LF\*\*; filkodning \*\*UTF-8 | ### Placeringstyper och `search_term_type` `search_term_type` motsvarar placeringstyperna: **ORGANIC**, **CROSS\_SELL** och **SUBSTITUTE**. De flesta återförsäljarprogram använder en enda **organic search**-placering för vanliga sökresultatannonser. **CROSS\_SELL** och **SUBSTITUTE** är **separata placeringar** på söksidan (eller relaterat inventarium) med annan visningsavsikt – de är inte bara extra kolumner i samma organiska auktion. Din Technical Account Manager bekräftar vilka placeringar som finns för ditt namnområde. **Hur placeringstyper skiljer sig åt** * **Organic** — Annonser som matchar köparens sökavsikt för produkten (till exempel en colaprodukt på "cola"). * **Cross-sell** — Kompletterande avsikt (till exempel pizza på "cola"). * **Substitute** — Avsikt för liknande produkt (till exempel en annan colavariant på "cola"). Du kan synkronisera **ett flöde per placeringstyp** eller **kombinera typer i en enda fil** (repetition `product_code` med olika `search_term_type`). Din Technical Account Manager konfigurerar placeringar så att rätt förslagstyp visas per yta. Föreslagna sökord kan **visas eller döljas per placering**. Kombinerade typer för en produkt: | product\_code | search\_term | search\_term\_rank | search\_term\_type | | ------------- | ------------ | ------------------ | ------------------ | | 12345 | cookies | 1 | ORGANIC | | 12345 | cookie | 2 | ORGANIC | | 12345 | milk | 1 | CROSS\_SELL | **Obs:** De flesta program använder endast **organiska** sökplaceringar. `CROSS_SELL` och `SUBSTITUTE` motsvarar **ytterligare placeringar**, inte "extra kolumner" i samma organiska utrymme – bekräfta vilka placeringar du använder med din Technical Account Manager. ### Flera kataloger Implementera föreslagna sökord i **alla** kataloger i ditt namnområde när det är möjligt (oavsett om det är från ditt flöde, AI-generering eller båda). Detta minskar varumärkesförvirring när en katalog har förslag och andra inte har det. För kampanjer med flera kataloger, om endast en katalog har data, fungerar kampanjer som beror på föreslagna urval endast fullt ut i den katalogen. \## *** ## Testning, sandbox och driftsättning **Sandbox- / testmiljö** * Verifiera UI-förslag i kampanjens **Targeting**-steg. **Exempel på testfall** | Test | Steg | Förväntat resultat | | ---------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------- | | UI-förslag synliga | Lägg till produkter i sandbox-kampanj; öppna **Targeting** | Föreslagna sökord visas per produkt | | Visningsregel | Välj ett föreslaget sökord kopplat till en delmängd av produkter | Endast kopplade produkter är behöriga för den termen | | Täckning för flera kataloger | Upprepa UI-kontroll över kataloger i namnområdet | Förslag finns i alla kataloger med data (eller omfattningen är dokumenterad) | Checklista för driftsättning * [ ] TSV har lästs in utan fel (om filsökväg används) eller AI-pipelinen har godkänts (om beta används) * [ ] Föreslagna sökord är synliga i sandbox-UI för representativa produkter * [ ] Namnområden med flera kataloger har täckning i alla kataloger (eller omfattningen är dokumenterad) * [ ] Annonsörskommunikation skickad före eller vid aktivering i produktion * [ ] Partner-API returnerar förväntade rader i produktion (stickprovskontroll) *** ## Felsökning och vanliga frågor **Problem:** Förslag visas aldrig i gränssnittet.\ **Sannolik orsak:** Inläsning är inte aktiverad, felaktig katalog eller så är placeringen inte konfigurerad.\ Lösning:\*\* Bekräfta med Epsilon att GCS-inläsning eller AI-pipeline är aktiv; verifiera placeringsmappning för `search_term_type`. **Kan vi använda en TSV för flera placeringstyper?**\ Ja. Upprepa `product_code` på flera rader med olika `search_term_type` värden. Din Technical Account Manager konfigurerar vilka typer som visas per placering. **Vad händer om vi har flera kataloger i en namnrymd?**\ Implementera förslagna sökord i alla kataloger när det är möjligt. Kampanjer som beror på förslagna val fungerar endast fullt ut på kataloger med data. **Inkludera följande vid kontakt med support:** * Namnrymd och katalog-ID * Exempel på `product_code` och förväntat `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/sv/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.