API para socios
Referencia de API

Anuncios de vídeo

📘

Función beta

Esta función se encuentra actualmente en versión beta y puede cambiar. Le animamos a que nos envíe sus comentarios para ayudar a perfeccionarla.

Los anunciantes y minoristas pueden cargar vídeos promocionales a sus banners, los cuales se mostrarán directamente en su sitio web o aplicación. Estos vídeos influyen en las decisiones de compra al presentar los productos de una forma atractiva. Los vídeos interactivos permiten a los consumidores explorar y adquirir productos directamente desde el vídeo, con opciones de añadir al carrito o comprar ahora.

¿Por qué elegir anuncios de vídeo para su sitio?

Gracias a los anuncios de vídeo, sus anunciantes podrán interactuar de forma más profunda con sus compradores en el sitio web para crear experiencias de compra más atractivas y aumentar el tiempo que pasan en el sitio explorando sus opciones.

RazonesDescripción
Fomente una historia de marcaLos anuncios de vídeo de alta participación muestran una parte atractiva y relevante de la historia general o específica de un anunciante para conectar a los usuarios de una forma más profunda con su marca minorista.
Lanzamientos de nuevos productosLos anunciantes pueden usar vídeos para presentar nuevos productos de forma más profunda que mediante simples anuncios gráficos. El formato vídeo les permite transmitir mejor a los compradores el valor que pueden aportarles los nuevos productos.
Conciencia de marcaLos anunciantes interesados en dar a conocer una nueva categoría de productos o difundir nuevos mensajes pueden utilizar vídeos en ubicaciones clave de su sitio para comunicarse directamente con los compradores.
Conexión más profunda con su marca minoristaEl formato vídeo permite profundizar la conexión entre un anunciante y su marca minorista en la mente de los compradores.

Especificaciones para el vídeo

  • Tamaño máximo de archivo: 300 MB
  • Tipos de archivo aceptados: video/mp4, video/quicktime, video/x-msvideo
  • Validación opcional de códecs: H.264, H.265
  • Alturas y anchuras: Definidas por el minorista en píxeles
  • Límite de duración: Ninguna
  • Revisión de la campaña: Obligatoria para las campañas de banner X que contengan un elemento de vídeo
  • Compatibilidad de etiquetas: la etiqueta estándar VAST se sirve como adm en la respuesta del anuncio

Integre anuncios de vídeo

Puede crear anuncios de vídeo interactivos de tipo banner X que se integren a la perfección con reproductores de vídeo compatibles con VAST 4.0 para proporcionar a los minoristas un formato de publicidad interactiva que agilice su implementación con un mínimo esfuerzo.

Los anuncios banner X de vídeo 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 vídeo admitidos.

Al incorporar anuncios de vídeo en las campañas, la respuesta al anuncio incluye un campo denominado adm. Este campo contiene las etiquetas XML requeridas para cumplir con VAST 4.0, lo que permite una fácil integración en reproductores de vídeo.

Requisitos de integración

Solicitud de anuncio

Deberá enviar una solicitud de anuncio a nuestro endpoint de banner X. El contenido de vídeo y otros elementos de los banners solo se servirán en las campañas que tengan configurados vídeos y contenido de banner. Tendrá que asegurarse de que haya campañas configuradas con recursos de vídeo para poder recibir anuncios con el objeto adm proporcionado.

Puede obtener más información sobre cómo solicitar anuncios en Generar anuncios de banner X

Reproductor de vídeo (renderización de anuncios)

Epsilon Retail Media sirve una etiqueta VAST (Video Ad Server Template) en nuestra respuesta publicitaria como adm de la respuesta del banner X. Por lo tanto, es probable que necesite un reproductor de vídeo para analizar la etiqueta VAST y renderizar el anuncio de vídeo.

📘

¿No tiene un reproductor de vídeo?

Es posible utilizar una amplia variedad de reproductores de vídeo de código abierto. Le recomendamos que revise las opciones de pago disponibles, así como las de código abierto, como Video JS o Clappr. Tenga en cuenta que para interpretar las etiquetas VAST, podrían ser necesarios complementos adicionales.

Previsualizador de banner X

Actualice su previsualizador del banner x para garantizar que la previsualización de anuncios se realice correctamente al crear, gestionar y revisar campañas. Vea el previsualizador de banner X.

Seguimiento e informes

Las etiquetas VAST permiten realizar distintos tipos de seguimientos (impresiones, clics, progreso e interacción); sin embargo, la versión beta solo permite hacer el seguimiento de impresiones y clics. Esto se suma a los informes de pedidos estándar.

🚧

Capacidades futuras

La elaboración de informes de progreso e interacción está prevista para una versión futura.

Elementos de seguimiento

Se utiliza la plantilla de publicación de anuncios en vídeo (VAST) con fines de seguimiento. La etiqueta VAST incluye varios mecanismos de seguimiento:

  • Seguimiento de impresiones
  • Seguimiento de clics
  • Seguimiento del progreso (inicio, primer cuartil, punto medio, tercer cuartil, finalización)
    • Primer cuartil (25 % visto): Indicador temprano de la participación inicial
    • Punto medio (50 % visto): Indica un interés sostenido del espectador a mitad del contenido
    • Tercer cuartil (75 % visto): Demuestra un fuerte compromiso del espectador con el contenido
    • Completado (100 % visto): Confirma que el espectador ha visto todo el vídeo (indicador de máxima participación)
  • Seguimiento de interacciones (silenciar, activar sonido, pausar, reanudar, pantalla completa)
    • Silenciar: El usuario ha silenciado el audio del vídeo
    • Activar sonido: El usuario ha activado el sonido del vídeo
    • Pausar: El usuario ha pausado la reproducción de vídeo
    • Reanudar: El usuario ha reanudado la reproducción del vídeo después de haberlo pausado

Ejemplo de respuesta a anuncios de vídeo

He aquí un fragmento de cómo se vería la respuesta del anuncio de vídeo, incluida la información relacionada con VAST:

{

  "ads": [

    {

      "contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",

      "slotId": "Top_Banner",

      "banners": [

        {

          "citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",

          "citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",

          "citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",

          "citrusSlotId": "Top_Banner",

          "citrusExpiry": "2025-02-12T01:33:33.579155107Z",

          "headingText": "recusandae 3205",

          "bannerText": "placeat 2825",

          "bannerTextColour": "ffffff",

          "ctaFlag": true,

          "ctaText": "CTA text",

          "ctaTextAccessibility": "call to action accessibility text",

          "ctaLink": http://citrusad.com ,

          "backgroundColour": "000000",

          "backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,

          "secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,

          "secondaryBackgroundImagePosition": "rightaligned",

          "heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,

          "heroImageAltText": "hero image alt text",

          "secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,

          "secondaryHeroImageAltText": "secondary hero image alt text",

          "secondaryHeroMode": "landscape",

          "tags": {},

          "additionalFields": [

            {

              "id": "text-1",

              "value": "sed 5731"

            }

          ],

          "gtins": [

            "Fingerlime26-fdxvq27",

            "Oranges5-qgxeb6",

            "Cherries9-adkoj11",

            "Incaberries20-ppscn21",

            "Banana14-simfk15"

          ],

          "sellerId": "seller_id_772_659",

          "position": 1,

          "metadata": {

            "advertiserInfo": {

             "advertiser": "Bob's advertising agency",

             "onBehalfOf": "Brand company inc"

            }

          },
          "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<VAST version=\"4.0\">\n    <Ad id=\"1\">\n        <InLine>\n            <AdSystem>CitrusAd</AdSystem>\n            <Impression><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Impression>\n            <ViewableImpression>\n                <Viewable><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Viewable>\n                <NotViewable></NotViewable>\n                <ViewUndetermined></ViewUndetermined>\n            </ViewableImpression>\n            <AdTitle>VAST-4.0-Short-Intro.mp4</AdTitle>\n            <Creatives>\n                <Creative>\n                    <UniversalAdId idRegistry=\"http://citrusad.com \" idValue=\"VAST-4.0-Short-Intro.mp4\">VAST-4.0-Short-Intro.mp4</UniversalAdId>\n                    <Linear>\n                        <Duration></Duration>\n                        <MediaFiles>\n                            <MediaFile delivery=\"progressive\" type=\"video/mp4\" width=\"0\" height=\"0\" bitrate=\"0\" codec=\"\"><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></MediaFile>\n                            <Mezzanine><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></Mezzanine>\n                        </MediaFiles>\n                        <VideoClicks>\n                            <ClickTracking><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/second-c/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></ClickTracking>\n                            <ClickThrough><![CDATA[a/a-national/everything/browse]]></ClickThrough>\n                        </VideoClicks>\n                    </Linear>\n                </Creative>\n            </Creatives>\n        </InLine>\n    </Ad>\n</VAST>"      

       }

      ]

    }

  ]

}

Ejemplo de etiqueta VAST completa

📘

Contiene campos que actualmente no ofrecemos.

Está previsto incorporar el seguimiento en una actualización futura.

El siguiente ejemplo ilustra una configuración de anuncios de vídeo en línea en la que se detalla la definición de material creativo, las URL de clic y los eventos de seguimiento.

<VAST version="4.0" xmlns="http://www.iab.com/VAST">

  <Ad id="inArticle_123" sequence="1">

    <InLine>

      <AdSystem version="1.0">InArticleAdServer</AdSystem>

      <AdTitle>In-Article Video Ad</AdTitle>

      <Description>Video ad that plays within article content</Description>

      <Impression><![CDATA[http://example.com/track/impression]]></Impression>

      <Creatives>

        <Creative>

          <Linear>

            <Duration>00:00:15</Duration>

            <MediaFiles>

              <MediaFile delivery="progressive" type="video/mp4" width="640" height="360">

                <![CDATA[https://example.com/video/ad.mp4]]>

              </MediaFile>

            </MediaFiles>

            <VideoClicks>

              <ClickThrough>https://advertiser.com/landing</ClickThrough>

            </VideoClicks>

            <TrackingEvents>

              <Tracking event="start">http://example.com/tracking/start</Tracking>

              <Tracking event="firstQuartile">http://example.com/tracking/firstQuartile</Tracking>

              <Tracking event="midpoint">http://example.com/tracking/midpoint</Tracking>

              <Tracking event="thirdQuartile">http://example.com/tracking/thirdQuartile</Tracking>

              <Tracking event="complete">http://example.com/tracking/complete</Tracking>

              <Tracking event="progress" offset="00:00:10">http://example.com/tracking/progress-10</Tracking>

              <Tracking event="creativeView">http://example.com/tracking/creativeView</Tracking>

              <Tracking event="mute">http://example.com/tracking/mute</Tracking>

              <Tracking event="unmute">http://example.com/tracking/unmute</Tracking>

              <Tracking event="pause">http://example.com/tracking/pause</Tracking>

              <Tracking event="resume">http://example.com/tracking/resume</Tracking>

              <Tracking event="fullscreen">http://example.com/tracking/fullscreen</Tracking>

              <Tracking event="exitFullscreen">http://example.com/tracking/exitFullscreen</Tracking>

          </TrackingEvents>

          </Linear>

        </Creative>

      </Creatives>

    </InLine>

  </Ad>

</VAST>