> 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/generating-ads/banner-x-responsive/video-ads-banner-x.md).

# Annunci video Banner X

Gli inserzionisti e i retailer possono caricare video promozionali nei loro banner, che vengono visualizzati direttamente sul loro sito web o sulla loro app. Questi video influenzano le decisioni di acquisto presentando i prodotti in modo coinvolgente. I video interattivi consentono ai consumatori di esplorare e acquistare i prodotti direttamente dal video, offrendo le opzioni **aggiungi al carrello** o **acquista ora**.

<figure><img src="/files/uF1YBohJi31kysvez17Z" alt="" width="450"><figcaption></figcaption></figure>

## Perché scegliere gli annunci video per il tuo sito?

I video onsite consentono ai tuoi inserzionisti di coinvolgere più profondamente gli acquirenti sul tuo sito web, creando esperienze d'acquisto più invitanti e aumentando il tempo che gli acquirenti trascorrono sul tuo sito per esplorare le proprie opzioni.

| Motivi                                            | Descrizione                                                                                                                                                                                                                                                                   |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Promuovere la storia di un brand                  | Gli annunci video ad alto coinvolgimento mostrano una parte coinvolgente e pertinente della storia complessiva di un inserzionista o specifica per un prodotto, connettendoli più profondamente al tuo brand retail.                                                          |
| Lanci di nuovi prodotti                           | Gli inserzionisti possono utilizzare i video per presentare i nuovi prodotti in modo più approfondito rispetto a quanto potrebbero fare con un semplice display. I video consentono loro di connettersi con gli acquirenti sul valore che i nuovi prodotti possono apportare. |
| Brand awareness                                   | Gli inserzionisti che desiderano promuovere la awareness in una nuova categoria o con nuovi messaggi possono utilizzare i video in posizioni chiave del tuo sito per comunicare direttamente con i tuoi acquirenti.                                                           |
| Rafforzare la connessione con il tuo brand retail | I video possono rafforzare la connessione tra un inserzionista e il tuo brand retail nella mente degli acquirenti.                                                                                                                                                            |

## Specifiche del video

* Dimensione massima del file\*\*: 300 MB
* **Tipi di file accettati**: Video/mp4, video/quicktime, video/x-msvideo
* **Validazione opzionale del codec**: H.264, H.265
* **Altezze e larghezze**: Definite dal retailer in pixel
* Limite di durata\*\*: Nessuno
* **Revisione della campagna**: Obbligatoria per le campagne banner X che contengono un elemento video
* **Supporto dei tag**: Tag VAST standard erogato come `adm` nella risposta dell'annuncio

## Integrare gli annunci video

Puoi creare annunci video banner X interattivi che si integrano perfettamente con [VAST 4.0](https://iabtechlab.com/wp-content/uploads/2016/05/VAST4.0_Updated_April_2016.pdf) lettori video compatibili, fornendo ai retailer un formato pubblicitario interattivo che semplifica l'implementazione con il minimo sforzo.

Banner X gli annunci video sono conformi allo standard Digital Video Ad Serving Template (VAST) 4.0, garantendo un'integrazione fluida e compatibile con i lettori video supportati.

Quando si incorporano annunci video nelle campagne, la risposta dell'annuncio include un campo denominato `adm`. Questo campo contiene i tag XML necessari per la conformità a VAST 4.0, consentendo un semplice inserimento nei lettori video.

### Requisiti di integrazione

#### Richiesta di annuncio

Dovrai inviare una richiesta di annuncio al nostro Banner X endpoint. Il video e gli altri contenuti del banner verranno erogati solo per le campagne che hanno video e contenuti banner configurati. Dovrai assicurarti che vi siano campagne configurate con asset video prima di poter ricevere annunci con l'oggetto `adm` fornito.

Puoi trovare maggiori informazioni su come richiedere annunci in [Genera annunci Banner X](/retail-media-interface/integration/it/integration/bannerx.md)

#### Lettore video (rendering dell'annuncio)

Epsilon Retail Media eroga un tag VAST (Video Ad Server Template) nella nostra risposta dell'annuncio come oggetto `adm` della risposta banner X. Di conseguenza, è probabile che ti serva un lettore video per analizzare il tag VAST e riprodurre l'annuncio video.

{% hint style="info" %}
**Non hai un lettore video?** È possibile utilizzare diversi lettori video open source. Consigliamo di valutare le opzioni a pagamento e open source disponibili, come Video JS o Clappr. Tieni presente che potrebbero essere necessari plugin aggiuntivi per analizzare i tag VAST.
{% endhint %}

#### Banner X anteprima

Aggiorna lo strumento di anteprima del tuo banner x per assicurarti che l'anteprima dell'annuncio venga riprodotta correttamente durante la creazione, la gestione e la revisione delle campagne. Vedi [Anteprima di Banner X](/retail-media-interface/integration/it/generating-ads/banner-x-responsive/integrating-your-banner-x-previewer.md).

#### Tracciamento e reportistica

È possibile effettuare diversi tipi di tracciamento (impression, clic, avanzamento e interazione); fai riferimento alla guida in [Report sull'interazione con i video Banner X](/retail-media-interface/integration/it/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)

### Elementi di tracciamento

Utilizza il [Video Ad Serving Template](https://iabtechlab.com/standards/vast/) (VAST) a scopi di tracciamento. Il tag VAST include diversi meccanismi di tracciamento:

* Tracciamento delle impression
* Tracciamento dei clic
* Tracciamento dell'avanzamento (start, firstQuartile, midpoint, thirdQuartile, complete)
  * **Primo quartile (25% visualizzato)**: Indicatore precoce del coinvolgimento iniziale
  * **Punto medio (50% visualizzato)**: Indica un interesse sostenuto dello spettatore a metà del contenuto
  * **Terzo quartile (75% visualizzato)**: Mostra un forte coinvolgimento dello spettatore nei confronti del contenuto
  * **Completato (100% visualizzato)**: Conferma che lo spettatore ha guardato l'intero video, indicando il massimo coinvolgimento
* Tracciamento dell'interazione (mute, unmute, pause, resume, fullscreen)
  * **Disattiva audio**: L'utente ha disattivato l'audio del video
  * **Attiva audio**: L'utente ha riattivato l'audio del video
  * **Pausa**: L'utente ha messo in pausa la riproduzione del video
  * **Riprendi**: L'utente ha ripreso la riproduzione del video dopo la pausa

{% hint style="info" %}
**Visualizza la guida all'integrazione per il tracciamento delle interazioni** Fai riferimento alla guida in [Report sull'interazione con i video Banner X](/retail-media-interface/integration/it/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
{% endhint %}

### Esempio di risposta dell'annuncio per gli annunci video

Ecco uno snippet di come apparirebbe la risposta dell'annuncio video, incluse le informazioni relative a VAST:

```
{
  "ads": [
    {
      "contentStandardId": "00000000-0000-0000-0000-000000000001",
      "slotId": "Double_Tile",
      "banners": [
        {
          "citrusAdId": "example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789",
          "citrusCampaignName": "Example-Campaign-Name",
          "citrusContentStandardId": "00000000-0000-0000-0000-000000000001",
          "citrusSlotId": "Double_Tile",
          "citrusExpiry": "2026-12-31T00:00:00.000000000Z",
          "headingText": "Example heading text",
          "bannerText": "Example banner text",
          "bannerTextColour": "000000",
          "tags": {},
          "gtins": [
            "00000000000000"
          ],
          "sellerId": "",
          "position": 1,
          "metadata": {},
          "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<VAST version=\"4.0\">
    <Ad id=\"1\">
        <InLine>
            <AdSystem>CitrusAd</AdSystem>
            <Impression><![CDATA[https://example.com/v1/resource/first-i/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]></Impression>
            <ViewableImpression>
                <Viewable><![CDATA[https://example.com/v1/resource/first-i/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]></Viewable>
                <NotViewable></NotViewable>
                <ViewUndetermined></ViewUndetermined>
            </ViewableImpression>
            <AdTitle>example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789</AdTitle>
            <Creatives>
                <Creative>
                    <UniversalAdId
                        idRegistry=\"citrusad.com\"
                        idValue=\"00000000-0000-0000-0000-000000000002\">
                        00000000-0000-0000-0000-000000000002
                    </UniversalAdId>
                    <Linear>
                        <Duration></Duration>
                        <MediaFiles>
                            <ClosedCaptionFiles>
                                <ClosedCaptionFile type=\"text/vtt\" language=\"en\">
                                    <![CDATA[https://example.com/media/example-transcript.vtt]]>
                                </ClosedCaptionFile>
                            </ClosedCaptionFiles>
                            <Mezzanine>
                                <![CDATA[https://example.com/media/example-video-1.mp4]]>
                            </Mezzanine>
                            <MediaFile
                                delivery=\"progressive\"
                                type=\"video/mp4\"
                                width=\"160\"
                                height=\"128\"
                                bitrate=\"3552\"
                                codec=\"h264\">
                                <![CDATA[https://example.com/media/example-video-1.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                        <VideoClicks>
                            <ClickTracking>
                                <![CDATA[https://example.com/v1/resource/second-c/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]>
                            </ClickTracking>
                            <ClickThrough></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>

                <Creative>
                    <UniversalAdId
                        idRegistry=\"citrusad.com\"
                        idValue=\"00000000-0000-0000-0000-000000000003\">
                        00000000-0000-0000-0000-000000000003
                    </UniversalAdId>
                    <Linear>
                        <Duration></Duration>
                        <MediaFiles>
                            <Mezzanine>
                                <![CDATA[https://example.com/media/example-video-2.mp4]]>
                            </Mezzanine>
                            <MediaFile
                                delivery=\"progressive\"
                                type=\"video/mp4\"
                                width=\"1920\"
                                height=\"1080\"
                                bitrate=\"832398\"
                                codec=\"h264\">
                                <![CDATA[https://example.com/media/example-video-2.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                        <VideoClicks>
                            <ClickTracking>
                                <![CDATA[https://example.com/v1/resource/second-c/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]>
                            </ClickTracking>
                            <ClickThrough></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>
            </Creatives>
        </InLine>
    </Ad>
</VAST>",
          "videoTranscriptFiles": [
            {
              "videoFileId": "00000000-0000-0000-0000-000000000002",
              "format": "txt",
              "url": "https://example.com/media/example-transcript.txt",
              "language": "en"
            }
          ]
        }
      ]
    }
  ]
}
```

<br>


---

# 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/generating-ads/banner-x-responsive/video-ads-banner-x.md?ask=<question>&goal=<endgoal>
```

`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.