Anuncios de video

En esta guía, se describen los requisitos de integración, la configuración y campos relevantes del protocolo OpenRTB que pueda usar para realizar ofertas en videos en el inventario de Google. El protocolo de RTB de Google dejó de estar disponible y no se analizará en esta guía. Para obtener información sobre los anuncios de video en el protocolo de RTB de Google, consulte la guía de RTB sobre los anuncios de video en Google.

Google admite anuncios de video in-stream, nativos y intersticiales. Consultar las guías para Native y Formatos de anuncios intersticiales para obtener más información sobre esos formatos.

Requisitos para los compradores

protocolo RTB

En general, esta guía se referirá al formato Protobuf, pero los nombres de campo y las rutas son equivalentes entre este y el formato JSON, a menos que se indique lo contrario.

En la Página Protos y datos de referencia Para más información para desarrollar un ofertante, consulta Procesar la solicitud y Crea la respuesta.

Revisión de creatividades

Google recomienda que envíes las creatividades para su aprobación antes de ofertar con ellas. Puedes usar el recurso Creatives de la API de Real-time Bidding para iniciar el proceso de revisión.

Configuración de la segmentación previa

Para recibir inventario de video, tu cuenta de Authorized Buyers debe crear una configuración de segmentación previa que incluya el inventario de video.

Macros

Puede especificar macros en el vínculo de la URL del video o en el XML de VAST especificado en BidResponse.seatbid.bid.adm Además, si especificas un video URL, también puedes colocar macros en el documento XML de VAST vinculado. El las siguientes macros son compatibles con creatividades de video:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Las macros de clics, como CLICK_URL_ESC, no se admiten Authorized Buyers incluye sus servicios de seguimiento de clics en un wrapper de VAST. Para obtener más información sobre las macros compatibles, consulta Especifica macros.

Detalles del texto destacado

Puedes usar el campo BidRequest.imp.video de OpenRTB para identificar si una solicitud de oferta entrante es para video in-stream o intersitial inventario y encontrar información adicional específica de video sobre la solicitud. Además, para el inventario de anuncios nativos, puede usar BidRequest.imp.native.{request/request_native}.assets.video para información similar específica del video.

BidRequest.{app/site}.content.producer.domain

La URL, sin parámetros, de la página que describe el contenido del video El editor envía esta URL a Google. Por ejemplo:

http://www.publisher.com/watchpagelink
banner.vcm
Si se establece en true, se puede seleccionar el anuncio complementario para su renderización. Como final (tarjeta de información) en el espacio del video después de que termina el anuncio de video en reproducción. De lo contrario, el anuncio complementario no se renderizará como un cierre final.
BidRequest.imp.rwdd
Si se establece en true, indica que el usuario recibe una recompensa por mirar el anuncio de video. Las recompensas típicas pueden ser leer un artículo adicional de forma gratuita, recibir una vida adicional en un juego o obtener una sesión de música patrocinada sin anuncios.
BidRequest.imp.video.maxduration

Es la duración máxima permitida en segundos del anuncio que debes mostrar. Si no se establece, no hay una duración máxima. Cuándo BidRequest.imp.video.skip es true; esto puede comportan de manera diferente. Consulta Duración máxima de videos que se pueden omitir. para obtener más información.

BidRequest.imp.video.maxseq

Es la cantidad máxima de anuncios en el grupo de anuncios de video. Si no se establece, el espacio publicitario no forma parte de un grupo de videos.

La cantidad real de anuncios de video que se muestran puede ser menor o igual a este valor, pero no puede excederlo.

BidRequest.imp.video.minduration
Es la duración mínima en segundos del anuncio que debes mostrar. Cuándo no establecida, no hay una duración mínima.
BidRequest.imp.video.plcmt
Describe dónde se reproducirá el video.
PLCMT_UNKNOWN La posición es desconocida o indeterminable.
PLCMT_INSTREAM Anuncios previos al video, durante el video y al final del video que se reproducen antes, durante o después del contenido de video en vivo que solicitó el consumidor. El video in-stream debe estar configurado en "sonido activado" de forma predeterminada en iniciar el reproductor o tienen explícitamente la intención clara del usuario de ver contenido de video. Aunque puede haber otro contenido en torno al reproductor, el contenido de video debe ser el centro de la visita del usuario. Integra debe seguir siendo el contenido principal de la página y el único video reproductor visual capaz de reproducir audio durante la reproducción. Si el jugador Se convierte en flotante o fijo, las llamadas subsiguientes al anuncio transmitir el tamaño actualizado del reproductor.
PLCMT_ACCOMPANYING_CONTENT Anuncios previos al video, durante el video y al final del video que se reproducen antes, durante o después de la transmisión de contenido de video. El reproductor de video se carga y se reproduce antes, entre o después de párrafos de texto o contenido gráfico, y comienza a reproducirse solo cuando entra en el viewport. El contenido complementario solo debe comenzar a reproducirse después de ingresar al viewport. Puede convertirse en un reproductor flotante o fijo a medida que se desplaza. fuera de la página.
PLCMT_INTERSTITIAL Anuncios de video que se reproducen sin contenido de video. Durante la reproducción, debe ser el enfoque principal de la página y ocupar la mayor parte del viewport, y no se puede desplazar fuera de la vista. Esto puede ser en posiciones como videos integrados en la aplicación o presentaciones de diapositivas.
PLCMT_NO_CONTENT_STANDALONE Anuncios de video que se reproducen sin contenido de video en streaming Pueden aparecer en posiciones como presentaciones de diapositivas, feeds nativos, en el contenido o fijos o flotantes.
BidRequest.imp.video.playbackmethod
Describe cómo reproducir el anuncio de video. El método de reproducción se determina como reproducción automática o reproducción con clic según la mejor medición disponible.
AUTO_PLAY_SOUND_ON Se inicia cuando se carga la página con el sonido activado.
AUTO_PLAY_SOUND_OFF Se inicia cuando se carga la página con el sonido desactivado.
CLICK_TO_PLAY Se inicia con un clic con el sonido activado.
MOUSE_OVER Se inicia cuando se coloca el cursor sobre él con el sonido activado.
ENTER_SOUND_ON Se inicia cuando se ingresa a la vista del viewport con el sonido activado.
ENTER_SOUND_OFF Se inicia cuando se ingresa al viewport con el sonido desactivado de forma predeterminada.
BidRequest.imp.video.skip
Si es true, indica que el reproductor permitirá que se omita el video o que se permiten los anuncios que se pueden omitir. De lo contrario, indica de que no están permitidos los anuncios que se pueden omitir.
BidRequest.imp.video.startdelay

Un valor de 0 indica anuncios previos al video, -1 indica anuncios durante el video y -2 indica anuncios al final del video.

Cualquier otro valor positivo es el tiempo en segundos desde el inicio del video hasta el punto en el que se muestra el anuncio.

Estos indicadores no son exclusivos de las creatividades de video, pero son particularmente valiosos para que los ofertantes los lean:

BidRequest.device.ifa
Este campo es un UUID de 36 caracteres que se configura solo cuando se usa SSL; y no con codificación hash. Es la versión sin encriptar de BidRequest.device.dpidm5 En el caso de los dispositivos iOS, contiene el identificador para anunciantes (IDFA) en mayúsculas. Para Android contiene el identificador de Android (ADID) en minúsculas caracteres. En el caso de los dispositivos de TV conectada, contiene sus identificadores únicos (por ejemplo, RIDA de Roku).
BidRequest.device.devicetype
Especifica el tipo de dispositivo.
MOBILE Un alias obsoleto para HIGHEND_PHONE o TABLET.
PERSONAL_COMPUTER Incluye computadoras de escritorio y laptops.
CONNECTED_TV incluye TVs conectadas (es decir, smart TVs) y dispositivos conectados (como Roku, Apple TV, etcétera).
HIGHEND_PHONE Incluye dispositivos telefónicos de alta gama.
TABLET Incluye las tablets.
CONNECTED_DEVICE Incluye dispositivos de juego dedicados.
SET_TOP_BOX Incluye dispositivos decodificadores.
OOH_DEVICE Incluye dispositivos de publicidad exterior, por ejemplo, carteles digitales.
BidRequest.device.make
Especifica la marca (como Nokia o Samsung) del dispositivo.
BidRequest.device.model
Especifica el modelo exacto (como N70 o Galaxy) del dispositivo si disponible; de lo contrario, contendrá un modelo genérico como "iphone" o "ipad".
BidRequest.imp.metric
Cuando Metric.type se establezca en completion_rate, Metric.value será una fracción en el rango [0.0, 1.0] que representa el porcentaje de finalización histórico de los anuncios de video publicados en el espacio publicitario. El valor predeterminado de -1.0 indica que el historial Los datos del porcentaje de respuesta no están disponibles.
BidRequest.imp.video.poddur
Es la cantidad de tiempo en segundos de toda la pausa publicitaria, incluidos todos los espacios publicitarios. que incluye el Pod. Se establece en el valor especificado en los metadatos del video que proporciona el publicador.

La solicitud de oferta de video también contiene información sobre el inventario como la vertical, los proveedores permitidos y la información del canal. Todos los demás campos existentes en la solicitud de oferta también se aplican a los videos.

Los campos de ancho y alto del mensaje del espacio publicitario de una solicitud de video corresponden al tamaño del reproductor de anuncios de video.

BidRequest.imp.ext.allowed_vendor_type
Los proveedores permitidos Consulta la vendors.txt en la documentación técnica para obtener una lista de los IDs. Por ejemplo, 309 = Unidad de video de DFA.
BidRequest.imp.video.mimes
Una lista de entidades permitidas que describe los tipos de MIME de contenido admitidos para los anuncios publicados en respuesta a la solicitud de oferta; por ejemplo, "video/mp4". La respuesta a la oferta deben indicar apoyo para al menos uno de ellos.
BidRequest.imp.video.protocols
Describe las versiones de VAST compatibles de un publicador para las solicitudes de anuncios de video. Contiene un array de valores de enum Protocol, incluidos los siguientes: VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER, VAST_4_0, VAST_4_0_WRAPPER y muchos más.
BidRequest.imp.video.companionad
Este campo incluye un array de objetos Banner que representan anuncios complementarios si están disponibles.
BidRequest.site.page

Es la URL de la página de reproducción del video o la URL de la página en la que se incorporó el video. Por ejemplo:

http://www.publisher.com/watchpagelink

Cuando responda a una solicitud de video, el ofertante debe mostrar una URL de redireccionamiento de VAST o un archivo en formato XML de VAST en el campo BidResponse.seatbid.bid.adm. La respuesta de la oferta también debe contener la declaración adecuada para el anuncio de video. El El siguiente es un extracto de una respuesta a la oferta de video adecuada: 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Los campos importantes en una respuesta de oferta de video son los siguientes:

BidResponse.seatbid.bid.ext.attribute
Son los atributos de los anuncios que se pueden mostrar en este fragmento. Consulta el archivo buyer-declarable-creative-attributes.txt para ver la lista de IDs. Verificamos que ninguno de estos atributos coincida con los que el publicador no permite en la solicitud de oferta. Por ejemplo, si configuras si alguno de los campos incluye 30, eso indicaría que el anuncio requiere compatibilidad con VPAID para renderizarse.
BidResponse.seatbid.bid.adm

En el caso de los anuncios de video, es la URL de redireccionamiento de VAST del anuncio. Por ejemplo:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

Como alternativa, puede ser XML de VAST sin procesar.

Ejemplos de respuestas y solicitudes de oferta

Formatos de video

Cómo los compradores pueden incluir videos

En las siguientes tablas, se ilustran las formas en que los compradores pueden incluir videos en sus creatividades y las posiciones en las que se pueden publicar para la Web y las aplicaciones para dispositivos móviles, respectivamente.

Web

Creatividad de video In-stream (todo) In-feed/artículo Anuncios nativos in-feed/in-article Intersticial En banner

VPAID + VAST

 

VAST

 

MRAID y JS

 

 

 

 

 

JS personalizado

 

Nativo + VAST

 

App para dispositivos móviles

Creatividad de video In-stream (todo) In-feed/artículo Anuncios nativos in-feed/in-article Intersticial En banner

VPAID + VAST

 

 

 

 

 

VAST

MRAID y JS

JS personalizado

Nativo + VAST

Clave: Formato o tecnología no disponibles

La creatividad de video se acepta en esta posición, sujeta a bloqueos del publicador

La creatividad de video no está disponible en esta posición

Indicadores recomendados de OpenRTB

En las siguientes tablas, se muestran los indicadores recomendados de OpenRTB para todos los formatos de video de y Web móvil y Aplicación para dispositivos móviles.

Web móvil y web para computadoras de escritorio

Formato del video Indicadores recomendados (solo indicadores relevantes de video) Indicadores relacionados (solo indicadores relevantes para videos)

In-stream (VPAID)

Objeto VIDEO presente y
video.placement = INSTREAM   &

In-stream (sin VPAID)

Objeto VIDEO presente   &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

Anuncios que no son in-stream

Objeto VIDEO presente

video.linearity: linear
La posición depende de la posición
real, los valores son los siguientes
Video.startdelay = 0

In-feed

Objeto VIDEO presente   &
video.placement = IN-FEED

In-article

Objeto VIDEO presente   &
video.placement = IN-ARTICLE

Nativo

Objeto NATIVE presente y

En banner

Objeto de video no presente &
banner.battr ≠ 6 Video en banner (reproducción automática) y
banner.battr ≠ 7 Video en banner (Iniciado por el usuario)

App para dispositivos móviles

Formato del video Detalles de la solicitud de oferta (solo los detalles relevantes del video)

In-stream

Objeto VIDEO presente   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 o 2: VPAID 2.0

Anuncios que no son in-stream

Objeto VIDEO presente

video.linearity: linear
La posición depende de la posición
real, los valores son los siguientes
Video.startdelay = 0

In-feed

Objeto VIDEO presente   &
video.placement = IN-FEED

In-article

Objeto VIDEO presente   &
video.placement = IN-ARTICLE

Nativo

Objeto NATIVE presente

Anuncio intersticial (VAST)

Objeto VIDEO presente y
video.placement = INTERSTITIAL

Anuncio intersticial (sin VAST)

Objeto VIDEO presente   &
video.placement = INTERSTITIAL

Filtradas

En banner (MRAID)

Objeto de video no presente &
banner.battr ≠ 6 Video en banner (reproducción automática) y
banner.battr ≠ 7 Video en banner (Iniciado por el usuario)

En el banner

(sin MRAID)

Objeto de video no presente &
banner.battr ≠ 6 Video en banner (reproducción automática) y
banner.battr ≠ 7 Video en banner (Iniciado por el usuario)

Cómo los publicadores pueden permitir o rechazar videos

La siguiente tabla ilustra las formas en que los editores pueden permitir o no videos en sus posiciones.

Opción de pub Formatos aplicables Se describe en la solicitud de oferta como

Especificar una unidad de video in-stream

In-stream (todo)

Objeto de video presente &
video.placement = INSTREAM

Habilitar VPAID

In-stream web

Objeto de video presente &
video.api = 1 (VPAID 1.0) o 2 (VPAID 2.0)

Habilitar IBV

En el banner

Intersticial

banner.battr ≠ 6 Video en banner (reproducción automática) o 7 Video en banner (Iniciado por el usuario)

Habilitar (instrucciones)

In-feed

In-article

Objeto de video presente y
video.placement = IN-FEED o IN-ARTICLE

Habilitar los anuncios que no son in-stream (instrucciones)

Nativo

Objeto nativo presente

Bloquea los anuncios intersticiales de video

Aplicación intersticial

El objeto VIDEO no está presente

Casos extremos

# Descripción del caso Comentarios Solicitud de oferta

1

Cierre personalizado diferido con MRAID

En el caso de los anuncios intersticiales, cerrar el anuncio puede enviar una notificación al comprador con MRAID, incluso si no usó el cierre personalizado.


La X que se aplicó en Authorized Buyers siempre aparecerá sobre cualquier cierre personalizado, incluso si este aparece debajo después de 5 segundos.

Glosario

Consulta el glósario de videos de Authorized Buyers.

Campos relevantes para los formatos In-stream y que no son in-stream

Consulta OpenRTB 2.5 (a partir de la página 47)

BidRequest.Video.
Placement
In-stream mWeb

1: In-stream
2: En banner

mApp

1: In-stream
2: In-Banner
Anuncios que no son in-stream mApp Interstitial

5: Anuncio intersticial

Native

3: In-Article
4: In-Feed

Rewarded

is_rewarded_inventory: Es un valor booleano de la extensión de OpenRTB.
linearity

Indica si la impresión debe ser lineal, no lineal, etc. Si no se especifica ninguno, se supone que se permiten todos.

In-stream mWeb

1: LINEAR (in-stream)

mApp

1: LINEAR (in-stream)
Anuncios que no son in-stream mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
In-stream mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
Anuncios que no son in-stream Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Fuente del valor de la solicitud de oferta

OpenRTB
Objeto		 Campos Authorized Buyers
/Exchange
Ofertas
Anuncios que no son in-stream		 Valores de muestra ¿Quién lo determina?
/¿De dónde proviene este valor
?
Objeto
Video mímica sí ["application/javascript",
"video/mp4"]",		 Google
minduration no Configurado por el publicador
duración máxima sí Configurado por el publicador
playbackmet
hod		 sí [6] Por lo general, el publicador
Configurada
API (MRAID) sí [1,2] Google
protocolos sí [2,3,5,6,7,8] Google
linealidad sí [1] Google
posición sí [1] Google
ancho del reproductor sí 400.400.300 Google
altura del reproductor sí 225,300,153 Google
retraso de inicio sí 0 Google, 5 s predeterminados
omitir sí 1 Publicador/Google
- para Intersticial => Google
- para In-stream => Publicador
decide si permitirá
que se pueden omitir, que no se pueden omitir o ambos.
Anuncios recompensados, que siempre no se pueden omitir
tasa de bits mínima No Google
tasa de bits máxima no Google
pos sí 1 Google
Dispositivo
Proporción de px sí 1 Google
impresión
Seguro sí 1 Google
es
predeterminado como verdadero porque la etiqueta del anuncio siempre es
segura.