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

# Anuncios de vídeo de Banner X

Los anunciantes y retailers pueden cargar videos promocionales en sus banners, que se muestran directamente en su sitio web o aplicación. Estos videos influyen en las decisiones de compra al mostrar los productos de manera atractiva. Los videos interactivos permiten a los consumidores explorar y comprar productos directamente desde el video, con opciones como **añadir al carrito** o **comprar ahora**.

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

## ¿Por qué anuncios de video para tu sitio?

El video en el sitio permite que tus anunciantes interactúen de forma más profunda con tus compradores en tu sitio web, creando experiencias de compra más atractivas e incrementando el tiempo que los compradores pasan en tu sitio explorando sus opciones.

| Razones                                        | Descripción                                                                                                                                                                                                                      |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Promover la historia de una marca              | Los anuncios de video de alto impacto muestran una parte atractiva y relevante de la historia general o de un producto específico del anunciante, conectándolos de manera más profunda con tu marca de retail.                   |
| Lanzamientos de nuevos productos               | Los anunciantes pueden usar el video para presentar nuevos productos de forma más detallada que con un display simple. El video les permite conectar con los compradores sobre el valor que pueden aportar los nuevos productos. |
| Reconocimiento de marca                        | Los anunciantes que buscan promover el reconocimiento en una nueva categoría o con nuevos mensajes pueden usar el video en ubicaciones clave de tu sitio para comunicarse directamente con tus compradores.                      |
| Profundizar la conexión con tu marca de retail | El video puede profundizar la conexión entre un anunciante y tu marca de retail en la mente de los compradores.                                                                                                                  |

## Especificaciones del video

* Tamaño máximo de archivo\*\*: 300 MB
* **Tipos de archivo aceptados**: Video/mp4, video/quicktime, video/x-msvideo
* **Validación de códec opcional**: H.264, H.265
* **Alturas y anchuras**: Definidas por el retailer en píxeles
* Límite de duración\*\*: Ninguno
* **Revisión de la campaña**: Obligatoria para campañas de banner X que contengan un elemento de video
* **Soporte de etiquetas**: Etiqueta VAST estándar servida como `adm` en la respuesta del anuncio

## Integrar anuncios de video

Puedes crear anuncios de video de banner X interactivos que se integran perfectamente con [VAST 4.0](https://iabtechlab.com/wp-content/uploads/2016/05/VAST4.0_Updated_April_2016.pdf) reproductores de video compatibles, lo que proporciona a los retailers un formato publicitario interactivo que agiliza la implementación con el mínimo esfuerzo.

Banner X los anuncios de video cumplen con el estándar Digital Video Ad Serving Template (VAST) 4.0, lo que garantiza una integración fluida y compatible con los reproductores de video admitidos.

Al incorporar anuncios de video en las campañas, la respuesta del anuncio incluye un campo llamado `adm`. Este campo contiene las etiquetas XML necesarias para el cumplimiento de VAST 4.0, lo que permite incrustarlos fácilmente en reproductores de video.

### Requisitos de integración

#### Solicitud de anuncio

Deberás enviar una solicitud de anuncio a nuestro Banner X endpoint. El video y otros contenidos de banner solo se servirán para campañas que tengan videos y contenidos de banner configurados. Deberás asegurarte de que haya campañas configuradas con recursos de video antes de recibir anuncios con el `adm` objeto proporcionado.

Puedes ver más sobre cómo solicitar anuncios en [Genera anuncios de banner X](/retail-media-interface/integration/es/integration/bannerx.md)

#### Reproductor de video (renderizado de anuncios)

Epsilon Retail Media sirve una etiqueta VAST (Video Ad Server Template) en nuestra respuesta de anuncio como el `adm` objeto de la respuesta de banner X. Como tal, es probable que necesites un reproductor de video para procesar la etiqueta VAST y renderizar el anuncio de video.

{% hint style="info" %}
**¿No tienes un reproductor de video?** Se pueden utilizar diversos reproductores de video de código abierto. Recomendamos revisar las opciones disponibles, tanto de pago como de código abierto, como Video JS o Clappr. Ten en cuenta que es posible que se requieran plugins adicionales para procesar las etiquetas VAST.
{% endhint %}

#### Banner X previsualizador

Actualiza tu previsualizador de banner x para garantizar que la vista previa del anuncio se renderice correctamente al crear, gestionar y revisar campañas. Consulta [Visualizador de Banner X](/retail-media-interface/integration/es/generating-ads/banner-x-responsive/integrating-your-banner-x-previewer.md).

#### Seguimiento y reportes

Es posible realizar una variedad de seguimientos (impresiones, clics, progreso e interacción); consulta la guía en [Informes de interacción de video de Banner X](/retail-media-interface/integration/es/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)

### Elementos de seguimiento

Utiliza el [Video Ad Serving Template](https://iabtechlab.com/standards/vast/) (VAST) con fines de seguimiento. La etiqueta VAST incluye varios mecanismos de seguimiento:

* Seguimiento de impresiones
* Seguimiento de clics
* Seguimiento de progreso (start, firstQuartile, midpoint, thirdQuartile, complete)
  * **Primer cuartil (25% reproducido)**: Indicador temprano del compromiso inicial
  * **Punto medio (50% reproducido)**: Indica un interés sostenido del espectador a la mitad del contenido
  * **Tercer cuartil (75% reproducido)**: Muestra un fuerte compromiso del espectador con el contenido
  * **Completado (100% reproducido)**: Confirma que el espectador vio todo el video, lo que indica el máximo compromiso
* Seguimiento de interacción (mute, unmute, pause, resume, fullscreen)
  * **Silenciar**: El usuario ha silenciado el audio del video
  * **Desactivar silencio**: El usuario ha activado el audio del video
  * **Pausar**: El usuario ha pausado la reproducción del video
  * **Reanudar**: El usuario ha reanudado la reproducción del video tras pausarlo

{% hint style="info" %}
**Consulta la guía de integración para el seguimiento de interacciones** Consulta la guía en [Informes de interacción de video de Banner X](/retail-media-interface/integration/es/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
{% endhint %}

### Ejemplo de respuesta de anuncio para anuncios de video

Aquí tienes un fragmento de cómo se vería la respuesta del anuncio de video, incluida la información relacionada con 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/es/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.