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

# Anúncios em vídeo do Banner X

Anunciantes e varejistas podem carregar vídeos promocionais em seus banners, que são exibidos diretamente em seu site ou aplicativo. Esses vídeos influenciam as decisões de compra ao apresentar produtos de maneira envolvente. Vídeos interativos permitem que os consumidores explorem e comprem produtos diretamente do vídeo, apresentando opções de **adicionar ao carrinho** ou **comprar agora**.

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

## Por que usar anúncios em vídeo para o seu site?

O vídeo no site permite que seus anunciantes se engajem mais profundamente com seus compradores em seu site, criando experiências de compra mais atraentes e aumentando o tempo que os compradores passam em seu site explorando suas opções.

| Motivos                                      | Descrição                                                                                                                                                                                                                                    |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Promover a história de uma marca             | Anúncios em vídeo de alto engajamento apresentam uma parte envolvente e relevante da história geral ou específica do produto de um anunciante, conectando-os mais profundamente à sua marca de varejo.                                       |
| Lançamentos de novos produtos                | Os anunciantes podem usar vídeos para apresentar novos produtos de forma mais aprofundada do que conseguiriam com display simples. O vídeo permite que eles se conectem com os compradores sobre o valor que os novos produtos podem trazer. |
| Reconhecimento de marca                      | Anunciantes que buscam promover o reconhecimento em uma nova categoria ou com uma nova mensagem podem usar vídeos em locais-chave do seu site para se comunicar diretamente com seus compradores.                                            |
| Aprofundar a conexão com sua marca de varejo | O vídeo pode aprofundar a conexão entre um anunciante e sua marca de varejo na mente dos compradores.                                                                                                                                        |

## Especificações de vídeo

* Tamanho máximo do arquivo\*\*: 300 MB
* **Tipos de arquivos aceitos**: Video/mp4, video/quicktime, video/x-msvideo
* **Validação opcional de codec**: H.264, H.265
* **Alturas e larguras**: Definidas pelo varejista em pixels
* Limite de duração\*\*: Nenhum
* **Análise da campanha**: Obrigatória para campanhas do banner X que contêm um elemento de vídeo
* **Suporte a tags**: Tag VAST padrão fornecida como `adm` na resposta do anúncio

## Integrar anúncios em vídeo

Você pode criar anúncios em vídeo interativos do banner X que se integram perfeitamente com [VAST 4.0](https://iabtechlab.com/wp-content/uploads/2016/05/VAST4.0_Updated_April_2016.pdf) players de vídeo compatíveis, oferecendo aos varejistas um formato de publicidade interativo que simplifica a implantação com o mínimo de esforço.

Banner X anúncios em vídeo aderem ao padrão Digital Video Ad Serving Template (VAST) 4.0, garantindo uma integração suave e compatível com players de vídeo suportados.

Ao incorporar anúncios em vídeo em campanhas, a resposta do anúncio inclui um campo chamado `adm`. Este campo contém as tags XML necessárias para conformidade com o VAST 4.0, permitindo fácil incorporação em players de vídeo.

### Requisitos de integração

#### Solicitação de anúncio

Você precisará enviar uma solicitação de anúncio para o nosso Banner X endpoint. Vídeos e outros conteúdos de banner só serão exibidos para campanhas que tenham vídeos e conteúdos de banner configurados. Você precisará garantir que existam campanhas configuradas com recursos de vídeo antes de receber anúncios com o `adm` objeto fornecido.

Você pode ver mais sobre como solicitar anúncios em [Gerar anúncios de banner X](/retail-media-interface/integration/pt-br/integration/bannerx.md)

#### Player de vídeo (renderização do anúncio)

Epsilon Retail Media fornece uma tag VAST (Video Ad Server Template) em nossa resposta de anúncio como o `adm` objeto da resposta do banner X. Como tal, você provavelmente precisará de um player de vídeo para analisar a tag VAST e renderizar o anúncio em vídeo.

{% hint style="info" %}
**Não tem um player de vídeo?** Uma variedade de players de vídeo open-source pode ser usada. Recomendamos revisar as opções pagas e open-source disponíveis, como Video JS ou Clappr. Observe que plugins adicionais podem ser necessários para analisar tags VAST.
{% endhint %}

#### Banner X visualizador de prévia

Atualize seu visualizador de prévia do banner x para garantir que a pré-visualização do anúncio seja renderizada corretamente ao criar, gerenciar e revisar campanhas. Veja [Visualizador de prévia do Banner X](/retail-media-interface/integration/pt-br/generating-ads/banner-x-responsive/integrating-your-banner-x-previewer.md).

#### Rastreamento e relatórios

Uma variedade de rastreamentos (impressões, cliques, progresso e interação) é possível, consulte o guia em [Relatório de interação de vídeo do Banner X](/retail-media-interface/integration/pt-br/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)

### Elementos de rastreamento

Utiliza o [Video Ad Serving Template](https://iabtechlab.com/standards/vast/) (VAST) para fins de rastreamento. A tag VAST inclui vários mecanismos de rastreamento:

* Rastreamento de impressões
* Rastreamento de cliques
* Rastreamento de progresso (start, firstQuartile, midpoint, thirdQuartile, complete)
  * **Primeiro quartil (25% assistido)**: Indicador inicial de engajamento inicial
  * **Ponto médio (50% assistido)**: Indica interesse sustentado do espectador na metade do conteúdo
  * **Terceiro quartil (75% assistido)**: Mostra forte comprometimento do espectador com o conteúdo
  * **Concluído (100% assistido)**: Confirma que o espectador assistiu ao vídeo inteiro, indicando engajamento máximo
* Rastreamento de interação (mute, unmute, pause, resume, fullscreen)
  * **Mute**: O usuário silenciou o áudio do vídeo
  * **Unmute**: O usuário ativou o som do áudio do vídeo
  * **Pause**: O usuário pausou a reprodução do vídeo
  * **Resume**: O usuário retomou a reprodução do vídeo após pausar

{% hint style="info" %}
**Veja o guia de integração para rastrear interações** Consulte o guia em [Relatório de interação de vídeo do Banner X](/retail-media-interface/integration/pt-br/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
{% endhint %}

### Exemplo de resposta de anúncio para anúncios em vídeo

Aqui está um trecho de como seria a resposta do anúncio em vídeo, incluindo informações relacionadas ao 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/pt-br/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.