> 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/references/product-ad-reference-1.md). # Riferimento per gli annunci prodotto Di seguito sono descritte le proprietà possibili in una richiesta standard e la risposta quando si riceve un annuncio. ## Elementi richiesti | Stringa | Descrizione | Obbligatorio/opzionale | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | | `catalogId` | L'identificatore del catalogo prodotti per il tuo sito web. | Obbligatorio | | `customerId` | L'identificatore unico per il cliente a cui vengono mostrati gli annunci. | Opzionale | | `filterMode` | Modo opzionale per definire la struttura della richiesta. Per ulteriori informazioni, consulta Filtraggio della generazione di annunci. | Opzionale, preferito | | `maxNumberOfAds` | Il numero massimo di annunci che desideri ricevere, fino a 10. | Obbligatorio | | `options` |

Modo opzionale per definire la struttura della richiesta. Per ulteriori informazioni, consulta Filtraggio della generazione di annunci.

Questo è anche l'oggetto in cui puoi richiedere informazioni sull'inserzionista per conformarti alla legislazione pubblicitaria locale come quella europea Legge sui servizi digitali.

| Opzionale, preferito | | `placement` | Il posizionamento univoco per il quale stai richiedendo gli annunci. | Obbligatorio | | `productFilters` | Qualsiasi filtro prodotto pertinente alla richiesta. Come una categoria, una posizione o una dimensione. | Obbligatorio | | `sessionId` | L'identificatore unico della sessione del cliente. Utilizzato per l'attribuzione nelle integrazioni standard. Consulta Opzioni del flusso di lavoro di integrazione per ulteriori informazioni. | Obbligatorio nelle integrazioni standard | | `memoryToken` |

Utilizzato per la paginazione. Utilizza un token fornito in una precedente richiesta di annunci per garantire che Epsilon Retail Media mostri solo nuovi annunci ai tuoi clienti.

Se fornito, Epsilon Retail Media escluderà gli annunci mostrati in precedenza nella risposta dell'annuncio. Consulta Paginazione per saperne di più.

| Opzionale | | `dtmCookieId` | Cookie creati e memorizzati dal sito web, utilizzati per monitorare il comportamento dell'utente sullo stesso dominio. | Opzionale | | `audience` | Specifica segmenti di pubblico specifici a cui appartiene l'acquirente. Rilevante solo se si utilizza [Opzione di targeting per pubblico 3](/retail-media-interface/integration/it/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Opzionale | ## Elementi restituiti | Stringa | Descrizione | Valore di esempio | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.customPayload` |

Questo payload personalizzato che deve essere trasmesso dal file di catalogo alla generazione dell'annuncio.

Il campo deve contenere un oggetto JSON valido serializzato in un array di byte ed codificato in Base64. L'oggetto JSON deve essere conforme a uno schema.

| Personalizzato per integrazione | | `ads.sellerId` | L'ID univoco del venditore. Verrà popolato solo se un sellerId è impostato su un team. I sellerId vengono in genere utilizzati durante l'integrazione dei venditori del marketplace. | `73nns-32sxr-32ss` Personalizzato per integrazione | | `ads.id` |

L'ID univoco dell'annuncio.
Questo è univoco per ogni richiesta effettuata a Epsilon Retail Media e non può essere archiviato in cache.

| `display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4` | | `ads.gtin` | Il codice prodotto dell'annuncio. Questo sarà il codice prodotto sincronizzato nel tuo catalogo prodotti. | `25813383` | | `ads.discount` | Legacy, può essere ignorato. | `{
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
}` | | `ads.position` | La posizione dell'annuncio nella risposta Epsilon Retail Media . È necessario rispettare questa posizione nel caso in cui vengano utilizzate campagne a Canone fisso. | 1 | | `ads.memoryToken` |

Utilizzato per la paginazione e l'incatenamento delle richieste di annunci.

Se fornito nella richiesta di annuncio successiva per lo stesso contesto, Epsilon Retail Media escluderà gli annunci mostrati in precedenza nella risposta dell'annuncio. Consulta Paginazione per saperne di più.

| | | `ads.metadata` |

Oggetto contenente le informazioni sull'inserzionista necessarie per aiutare gli inserzionisti a conformarsi alla legislazione pubblicitaria locale come il Legge sui servizi digitaliin Europa.

advertiser viene rilevato dal Nome azienda nel team fornitore.

onBehalfOf viene rilevato dal Finanziatore dell'annuncio nel team fornitore.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `banners` | Comprende oggetti banner. Visualizza il [Riferimento per l'annuncio banner (statico)](/retail-media-interface/integration/it/references/banner-ad-static-reference.md) per saperne di più. | `"banners": [],` | | `metadata.warnings` | Oggetto contenente informazioni di avviso sulla richiesta di annuncio. Attualmente avvisa solo se viene superato il numero massimo di segmenti. | `"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]` | --- # 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/references/product-ad-reference-1.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.