> 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/banner-ad-static-reference.md).
# Riferimento per gli annunci banner (statici)
Di seguito vengono descritte le proprietà possibili in una richiesta standard come descritto in [Richiesta di annunci banner](/retail-media-interface/integration/it/generating-ads/banner-ads-static/requesting-banner-ads.md) per la tua richiesta e la risposta se ricevi un annuncio.
{% hint style="info" %}
Gli annunci banner vengono richiesti sullo stesso `/generate` endpoint degli annunci di prodotti. È possibile utilizzare una singola richiesta per recuperare entrambi i tipi di annunci.
{% endhint %}
## Elementi richiesti
| Stringa | Descrizione | Obbligatorio/facoltativo |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `bannerSlots` | Un array di slot banner per i quali desideri ricevere annunci banner. Specificando un maxNumberOfAds per gli slot banner, puoi recuperare più di un banner per lo slot. Un simile caso d'uso si verificherebbe per i posizionamenti a carosello. | Obbligatorio |
| `bannerSlotIds` | Un array di slot banner per i quali desideri ricevere annunci banner | Obbligatorio, sostituito da bannerSlots |
| `catalogId` | L'identificatore del catalogo prodotti per il tuo sito web. | Obbligatorio |
| `contentStandardId` | L'identificatore dello standard di contenuto per il tuo sito web. | Obbligatorio |
| `customerId` | L'identificatore univoco per il cliente a cui vengono erogati gli annunci. | Facoltativo |
| `filterMode` | Modo facoltativo di definire la struttura della tua richiesta. Vedi [Filtraggio della generazione di annunci](/retail-media-interface/integration/it/data-api/api-overview/ad-generation-filtering-1.md) per maggiori informazioni. | Facoltativo, preferito |
| `maxNumberOfAds` | Il numero massimo di annunci di prodotti che desideri vengano restituiti, fino a 15. | Obbligatorio, consente l'erogazione di annunci di prodotti nella stessa richiesta. Se non sono richiesti annunci di prodotti, impostare su `0` |
| `options` | Modo facoltativo di definire la struttura della tua richiesta. Vedi Filtraggio della generazione di annunci per maggiori informazioni.
Questo è anche l'oggetto in cui puoi richiedere le informazioni sull'inserzionista per conformarti alla legislazione pubblicitaria locale come quella europea Legge sui servizi digitali .
| Facoltativo, preferito |
| `placement` | Il posizionamento univoco per cui stai richiedendo gli annunci. | Obbligatorio |
| `productFilters` | Qualsiasi filtro di prodotto pertinente alla tua richiesta. Ad esempio una categoria, una posizione o una dimensione. | Obbligatorio |
| `sessionId` | L'identificatore univoco della sessione del cliente. Utilizzato per l'attribuzione nelle integrazioni standard. Consulta le opzioni del flusso di lavoro di integrazione per maggiori informazioni. | Obbligatorio nelle integrazioni standard |
| `dtmCookieId` | Cookie creati e memorizzati dal sito web, utilizzati per monitorare il comportamento dell'utente sullo stesso dominio. | Facoltativo |
| `audience` | Specifica i 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) | Facoltativo |
## Elementi restituiti
| Stringa | Descrizione | Valore di esempio |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `banners.altText` | Testo alternativo per l'immagine hero nel raro caso in cui non venga visualizzata. | `Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.` |
| `banners.contentStandardId` | L'identificatore dello standard di contenuto per il tuo sito web. | \`4ffb80ba-b9a9-4567-8069-79b2eca93473 |
| `banners.expiry` | La scadenza dell'annuncio. Questo è l'ultimo momento in cui un clic può essere segnalato a Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` |
| `banners.id` | L'ID univoco dell'annuncio.
Questo è univoco per ogni richiesta effettuata a Epsilon Retail Media e non può essere salvato in cache.
| `banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=` |
| `banners.imageUrl` | Il link dell'immagine del banner. | `[]\() |
| `banners.gtins` | Un array contenente fino a 20 codici prodotto selezionati tra i prodotti pubblicizzati della campagna. | `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` |
| `banners.linkUrl` | L'URL inoltrato dal banner quando il cliente fa clic sul banner. | ` |
| `banners.slotId` | L'ID dello slot specifico per il banner che hai richiesto. | `Category_Top` |
| `banners.tags` | Questo campo restituisce eventuali tag di terze parti inseriti dall'inserzionista nella propria campagna. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` |
| `banners.text` | Utilizzato nelle integrazioni personalizzate come campo di testo aggiuntivo. | |
| `banners.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 |
| `banners.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 |
| `banners.metadata` | Oggetto contenente le informazioni sull'inserzionista necessarie per aiutare gli inserzionisti a rispettare la legislazione pubblicitaria locale come il Legge sui servizi digitali in Europa.
advertiser viene ripreso dal Nome della società nel team fornitore.
onBehalfOf viene ripreso dal Finanziatore dell'annuncio nel team fornitore.
| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` |
| `metadata.warnings` | Oggetto contenente informazioni di avviso relative alla richiesta di annunci. 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/banner-ad-static-reference.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.