> 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/it/data-api/catalog-products-2.md). # Catalogo e prodotti Per integrarti con Epsilon Retail Media, avrai bisogno di almeno un catalogo di prodotti. ## Cos'è un catalogo? Un catalogo è un raggruppamento di prodotti e delle relative caratteristiche, utilizzato più comunemente per raggruppare tutti i prodotti del sito di un integratore in un unico catalogo. I cataloghi vengono selezionati dagli inserzionisti durante la procedura di creazione della campagna e le loro campagne verranno erogate solo all'interno del catalogo di prodotti selezionato. È prassi comune raggruppare tutti i prodotti in un unico catalogo per un integratore, semplificando la selezione per gli inserzionisti. La creazione di più cataloghi può essere utilizzata per segmentare la disponibilità dei prodotti in diversi rivenditori o paesi a scopo di targeting della campagna. {% hint style="info" %} Se desideri creare più cataloghi, contatta il tuo Technical Account Manager per discutere le best practice, poiché potrebbero esserci modi con un supporto migliore per implementare il targeting. {% endhint %} {% hint style="warning" %} Se ti stai integrando in un namespace di rete, dovresti creare un unico catalogo. {% endhint %} ## Cosa sono i prodotti? I prodotti sono i singoli GTIN presente sul sito di un integratore. I prodotti sincronizzati con Epsilon Retail Media vengono sincronizzati con i singoli valori e attributi identificativi. I prodotti dovrebbero rappresentare ciascun GTIN/SKU presente nel catalogo prodotti attuale. I prodotti vengono selezionati dagli inserzionisti durante la creazione della campagna; verranno visualizzati per la selezione solo i prodotti rilevanti per i cataloghi selezionati dall'inserzionista. I prodotti non devono essere utilizzati per rappresentare più di un singolo GTIN di prodotto. Le variazioni dello stesso prodotto devono essere elencate come prodotti diversi, ad es. le varianti da 200 ml, 600 ml e 2 l dello stesso tipo di bevanda verrebbero considerate come tre prodotti diversi in Epsilon Retail Media, in linea con le best practice dell'integratore esistenti. ## Spiegazione dei filtri prodotto I filtri prodotto vengono utilizzati principalmente per la generazione di annunci, oltre a contenere proprietà quali `imageUrl` e nome. Quando richiedi annunci da Epsilon Retail Media, invierai un contesto contenente le informazioni rilevanti sulla pagina per garantire che a ciascuna pagina vengano erogati annunci pertinenti. La struttura dei filtri spetta all'integratore, ma la cosa più importante da considerare è che questi filtri prodotto verranno inviati nel contesto di generazione degli annunci. I filtri prodotto devono corrispondere esattamente a quanto richiesto nella generazione dell'annuncio. Di seguito viene descritto un esempio di contesto contenente `productFilters` : ```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 } ``` Questo contesto restituirà solo annunci per prodotti che contengono tutti i filtri nell'array pertinente. {% hint style="info" %} Se desideri utilizzare valori di offerta minima per categoria, assicurati che le tue categorie siano di facile utilizzo e facili da capire per gli inserzionisti che creano campagne, ad es. category:Keyboards è più facile da capire rispetto a category:12. {% endhint %} ## Fornitura di immagini e nomi dei prodotti Epsilon Retail Media ha bisogno di informazioni su immagini e nomi dei prodotti per renderli reperibili durante la creazione delle campagne nel Epsilon Retail Media portale. Questi valori possono essere inviati a Epsilon Retail Media all'interno di tag formattati come nell'esempio seguente: ```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" ] } ] } ``` Si vedono in varie aree del Epsilon Retail Media portale, tra cui la selezione dei prodotti, come nell'esempio seguente:
Screen Shot 2021-05-24 at 12.12.31 pm.png

Immagine di riferimento

--- # 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/it/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.