> 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/data-api/catalog-products-2.md). # Katalog och produkter För att integrera med Epsilon Retail Mediabehöver du minst en produktkatalog. ## Vad är en katalog? En katalog är en gruppering av produkter och deras attribut, som oftast används för att gruppera alla produkter på en integratörs webbplats i en enda katalog. Kataloger väljs av annonsörer i kampanjskapandeprocessen, och deras kampanjer kommer endast att köras inom deras valda produktkatalog. Det är vanlig praxis att alla produkter grupperas i en enda katalog för en integratör, vilket gör valet enkelt för annonsörer. Skapandet av flera kataloger kan användas för att segmentera produkttillgänglighet hos olika återförsäljare eller i olika länder för kampanjriktningsändamål. {% hint style="info" %} Om du vill skapa flera kataloger, kontakta din Technical Account Manager för att diskutera bästa praxis, eftersom det kan finnas sätt att implementera riktning som stöds bättre. {% endhint %} {% hint style="warning" %} Om du integrerar i en nätverksnamnrymd bör du skapa en enda katalog. {% endhint %} ## Vad är produkter? Produkter är individuella GTIN på en integratörs webbplats. Produkter som synkroniseras med Epsilon Retail Media synkroniseras med individuella identifieringsvärden och attribut. Produkter bör representera varje GTIN/SKU i din nuvarande produktkatalog. Produkter väljs av annonsörer när kampanjer skapas, och endast de produkter som är relevanta för de kataloger som annonsören har valt visas för urval. Produkter bör inte användas för att representera mer än ett enda produkt-GTIN. Varianter av samma produkt bör listas som olika produkter, t.ex. 200 ml, 600 ml och 2 l-varianter av samma dryckesprodukt skulle betraktas som tre olika produkter i Epsilon Retail Media, vilket överensstämmer med befintlig bästa praxis för integratörer. ## Förklaring av produktfilter Produktfilter används främst för generering av annonser förutom att de innehåller egenskaper som `imageUrl` och namn. När du begär annonser från Epsilon Retail Mediaskickar du en kontext som innehåller relevant sidinformation vilket säkerställer att relevanta annonser visas på varje sida. Strukturen på filtren är upp till integratören, men det viktigaste att tänka på är att dessa produktfilter kommer att skickas i din kontext för annonsgenerering. Produktfilter bör matcha exakt det som begärs i annonsgenereringen. Ett exempel på kontext som innehåller `productFilters` beskrivs nedan: ```http POST $BASE_URL/v1/ads/generate HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "customerId": "wertg5432a", "sessionId": "ec9-4e07-881d-3e9", "placement": "search", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "searchTerm": "chocolate", "productFilters": [ ["category:Cupboard"],["dietary:Gluten-free"] ], "options": { "filterMode": "AndOr" }, "maxNumberOfAds": 3 } ``` Denna kontext kommer endast att returnera annonser för produkter som innehåller alla filter i den relevanta matrisen. {% hint style="info" %} Om du vill använda lägsta budvärden för kategorier, se till att dina kategorier är användarvänliga och lätta att förstå för annonsörer som skapar kampanjer, t.ex. category:Keyboards är lättare att förstå än category:12. {% endhint %} ## Tillhandahålla bilder och produktnamn Epsilon Retail Media behöver information om produktbilder och produktnamn för att göra dem sökbara när kampanjer skapas i Epsilon Retail Media -portalen. Dessa värden kan skickas till Epsilon Retail Media inuti taggar formaterade som följande exempel: ```http POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "catalogProducts": [ { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 50, "price": "19.99", "tags": [ ""imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0" ] } ] } ``` De syns på olika ställen i Epsilon Retail Media -portalen, inklusive i produktvalet, som i exemplet nedan:
Screen Shot 2021-05-24 at 12.12.31 pm.png

Referensbild

--- # 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/data-api/catalog-products-2.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.