Se usó la API de Cloud Translation para traducir esta página.

Anuncios de video

Con el lanzamiento de la compatibilidad con los anuncios de video, los compradores pueden comprar inventario de video mediante Authorized Buyers. En este documento, se describen los requisitos de integración para comprar a través de RTB con el protocolo de Authorized Buyers. Para obtener información sobre los protocolos disponibles, consulta la sección Selecciona un protocolo de la guía de introducción.

Los compradores pueden comprar un inventario de video en todas las posiciones, ya sean anuncios in-stream o intersticiales. Consulta el artículo Anuncios intersticiales para obtener información detallada.

Requisitos del comprador

Los nuevos compradores de RTB deben desarrollar sus ofertantes con el búfer de protocolo más reciente y la información que se describe en las siguientes secciones. Para descargar el protocolo, consulta la página de datos de referencia de las ofertas en tiempo real. Para obtener información sobre cómo desarrollar un ofertante, consulta Cómo procesar la solicitud y Cómo crear la respuesta.

Macros compatibles

Las siguientes macros son compatibles con las creatividades de video in-stream:

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

Las macros de clics (como CLICK_URL_ESC) no son necesarias porque Authorized Buyers incluye sus herramientas de seguimiento de clics en un wrapper de VAST. Por lo tanto, las macros de clics no son compatibles con los anuncios de video in-stream. Para obtener más información sobre las macros compatibles, consulta Especifica macros en Compila la respuesta.

Detalles del texto destacado

El protocolo de ofertas en tiempo real usa un mensaje de video, que se define en el archivo real-time- bidding-proto.txt para identificar solicitudes de video y proporcionar información adicional específica del video sobre la solicitud.

La siguiente lista de campos del mensaje de video anidado también proporciona descripciones y ejemplos detallados:

description_url

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

    http://www.publisher.com/watchpagelink

EndCapSupport

Cuando se habilita, el anuncio complementario se puede seleccionar para que se renderice como un anuncio final gráfico (tarjeta de información) en el espacio de video una vez que termina de reproducirse.

`END_CAP_NOT_ENABLED`	El anuncio complementario no se renderiza como extremo final.
`END_CAP_OPTIONAL`	La limitación final se renderiza si la respuesta contiene un banner complementario apto, pero este no es obligatorio.
`END_CAP_FORBIDDEN`	Se filtra una respuesta con un anuncio complementario.
`END_CAP_REQUIRED`	Se filtra una respuesta sin anuncio complementario.

is_embedded_offsite

Si se establece como true, el video se incorpora en páginas fuera del dominio del publicador.

is_rewarded

Si se establece en true, indica que el usuario recibe una recompensa por ver el anuncio de video. Las recompensas típicas pueden ser leer un artículo adicional de forma gratuita, recibir una vida extra en un juego o acceder a una sesión de música patrocinada sin anuncios.

max_ad_duration

Es la duración máxima permitida en milisegundos para el anuncio que se muestra. Cuando se establece en 0, no hay duración máxima.

max_ads_in_pod

Es la cantidad máxima de anuncios en un grupo de anuncios de video de Authorized Buyers. Un valor distinto de cero indica que el espacio publicitario actual es un grupo de anuncios que puede mostrar varios anuncios de video. La cantidad real de anuncios de video que se muestran puede ser menor o igual que este valor, pero no puede superarlo.

min_ad_duration

Es la duración mínima (expresada en milisegundos) del anuncio que debe mostrar. Si no se establece o tiene un valor menor o igual que cero, no hay duración mínima.

Placement

Describe dónde se reproducirá el video.

`UNKNOWN_PLACEMENT`	La ubicación es desconocida o indeterminable.
`INSTREAM`	In-stream significa que el anuncio se reproduce antes, durante o después de otro contenido de video. Es similar a un comercial de televisión tradicional. El contenido de video que el usuario está mirando no se reproduce mientras se reproduce el anuncio.
`INTERSTITIAL`	Intersticial significa que el anuncio de video se reproduce frente a contenido que no es de video (por ejemplo, un artículo de noticias o un videojuego). El anuncio cubre la totalidad o casi todo el espacio de la pantalla que ocupa el contenido, y el usuario no puede continuar hasta que el anuncio haya terminado o se lo omita.
`IN_FEED`	El formato de video in-feed es una creatividad de video que se muestra cuando el usuario se desplaza por un feed de contenido, por lo general, el feed de una aplicación social, un artículo de noticias, etc. El video se renderiza en el feed principal y en el flujo de visión y lectura del usuario. El video no se renderiza a un costado como los videos en banner.

skippable_max_ad_duration

Es la duración máxima en milisegundos del anuncio que se debe mostrar si se puede omitir. Por lo general, difiere de la duración máxima permitida para los anuncios que no se pueden omitir. Si este campo no se establece o tiene un valor menor o igual que cero, se permite cualquier duración.

VideoPlaybackMethod

Describe cómo reproducir el anuncio de video. Se determina que el método de reproducción es de reproducción automática o de reproducción con un clic según la mejor medición disponible.

`AUTO_PLAY_SOUND_ON`	significa que el anuncio se reproduce automáticamente con el sonido activado.
`AUTO_PLAY_SOUND_OFF`	significa que el anuncio se reproduce automáticamente con el sonido desactivado.
`CLICK_TO_PLAY`	significa que el anuncio no se reproducirá hasta que se haga clic en él.

video_ad_skippable

Este es un valor de SkippableBidRequestType que contiene uno de los siguientes valores:

`ALLOW_SKIPPABLE`	significa que se permiten los anuncios que se pueden omitir y los que no.
`REQUIRE_SKIPPABLE`	significa que solo se mostrarán anuncios que se puedan omitir.
`BLOCK_SKIPPABLE`	significa que solo se mostrarán anuncios que no se puedan omitir.

Si no se establece este campo, la opción predeterminada es permitir los anuncios que se pueden omitir.

videoad_start_delay

Es el tiempo en milisegundos desde el inicio del video hasta el punto en el que se muestra el anuncio. 0 significa anuncio previo al video y -1 significa anuncio final del video. Cualquier otro valor positivo indica que el espacio está en el medio del video.

El valor es válido solo si se configura este parámetro. Si no la estableces, se desconoce la posición de visualización.

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

advertising_id

Este campo es un UUID de 16 bytes que se establece solo cuando se usa SSL. Es la versión sin encriptar de encrypted_advertising_id. En el caso de los dispositivos iOS, contiene el Identificador para anunciantes (IDFA). En el caso de los dispositivos Android, contiene el identificador de Android (ADID). En el caso de los dispositivos de TV conectada, contiene sus identificadores únicos (por ejemplo, RIDA de Roku).

device_type

Especifica el tipo de dispositivo.

`UNKNOWN_DEVICE`	es el valor predeterminado para este campo.
`HIGHEND_PHONE`	incluye teléfonos celulares con capacidades de video.
`TABLET`	incluye dispositivos tableta.
`PERSONAL_COMPUTER`	incluye dispositivos de escritorio y portátiles.
`CONNECTED_TV`	incluye TVs conectadas (es decir, smart TVs) y dispositivos conectados (como Roku, Apple TV, etcétera).
`GAME_CONSOLE`	incluye dispositivos dedicados para juegos.

brand

Especifica la marca (como Nokia o Samsung) del dispositivo. Este campo es opcional; de forma predeterminada, no se especifica.

model

Especifica el modelo exacto (como N70 o Galaxy) del dispositivo. Este campo es opcional; de forma predeterminada, no se especifica.

screen_orientation

Especifica la orientación del dispositivo cuando se envía la solicitud de anuncio. Los valores válidos son LANDSCAPE, PORTRAIT y UNKNOWN_ORIENTATION.

viewability

Proporciona una estimación de la probabilidad de que el usuario final pueda ver este espacio publicitario en función de la frecuencia con la que lo haya podido ver en el pasado. Se expresa como un porcentaje en el rango de [0, 100]. El valor predeterminado -1 indica que los datos de visibilidad históricos no están disponibles.

content_attributes.duration_seconds

Indica la cantidad de segundos (por ejemplo, 200) de reproducción del video. Esto se declara en el mensaje ContentAttributes. Se establece en el valor especificado en los metadatos del video proporcionados por el editor del video.

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 de la solicitud de oferta también se aplican al video.

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

allowed_vendor_type

Es el proveedor permitido. Consulta el archivo vendors.txt en la documentación técnica para obtener una lista de los ID. Por ejemplo, 309 = Unidad de video de DoubleClick.

allowed_video_formats

Describe las tecnologías de video permitidas para los anuncios que se publican en respuesta a esta solicitud. La respuesta debe indicar la compatibilidad con al menos uno de ellos. Los valores para este campo repetido provienen de la enumeración VideoFormat:

`VIDEO_FLASH`	Permite videos con formato de video Flash (FLV).
`VIDEO_HTML5`	Permite videos con formato HTML5.
`VPAID_FLASH`	Permite videos que utilizan el formato de video Flash con definición de la interfaz de publicación de anuncios para reproductores de video (VPAID).
`VPAID_JS`	Permite videos que utilizan el formato de video VPAID JavaScript.

companion_slot

Este campo representa un mensaje de CompanionSlot que incluye los siguientes campos:

`height`	Son las alturas disponibles para este espacio.
`width`	Son los anchos disponibles para este espacio.
`CreativeFormat`	El formato de creatividad representa los formatos posibles para la creatividad en este espacio complementario.

url

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

    http://www.publisher.com/watchpagelink

Cuando responde a una solicitud de video, el ofertante debe mostrar una URL de redireccionamiento de VAST en el campo video_url. La respuesta a la oferta también debe contener la declaración adecuada para el anuncio de video. A continuación, se incluye un extracto de una respuesta adecuada a la oferta de video:

protocol_version: 1
  ad {
    adslot {
      id: 1
      max_cpm_micros: 50000000
    }
    click_through_url: "http://google.com/"
    video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/
    B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml"
  }

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

attribute: Son todos los atributos de los anuncios que se pueden mostrar desde este fragmento. Consulta el archivo comprador-declarable-creative-attributes.txt para ver la lista de ID. Verificamos que ninguno de estos atributos esté en la lista excluded_attribute de la solicitud de oferta. Establece este campo solo si se muestra un fragmento HTML o un anuncio de video. Por ejemplo, si estableces este campo en 30, indicas que el anuncio requiere compatibilidad con VPAID para renderizarse.

Creatividad de video	In-stream (todos)	In-feed/artículo	Anuncios in-feed o artículos nativos	Intersticial	En banner
VPAID + VAST
VAST
MRAID + JS
JS personalizado
Nativo + VAST

Creatividad de video	In-stream (todos)	In-feed/artículo	Anuncios in-feed o artículos nativos	Intersticial	En banner
VPAID + VAST
VAST
MRAID + JS
JS personalizado
Nativo + VAST

Formato del video	Indicadores recomendados (solo indicadores relevantes para videos)	Indicadores relacionados (solo indicadores relevantes de video)
In-stream (VPAID)	Objeto VIDEO presente y `video.placement = INSTREAM &`
In-stream (sin VPAID)	Objeto VIDEO presente y `video.placement = INSTREAM & video.api = 1 VPAID 1.0 or 2:VPAID 2.0`
Outstream	Objeto VIDEO presente `video.linearity: linear` La posición depende de la posición real, valores que se indican a continuación `Video.startdelay = 0`
In-feed	Objeto VIDEO presente y `video.placement = IN-FEED`
In-article	Objeto VIDEO presente y `video.placement = IN-ARTICLE`
Nativo	Objeto NATIVE presente y
En banner	El objeto de video no está presente & `banner.battr ≠ 6` Video en banner (reproducción automática) y `banner.battr ≠ 7` Video en banner (iniciado por el usuario)

Formato del video	Detalles de la solicitud de oferta (solo los detalles relevantes del video)
In-stream	Objeto VIDEO presente y `video.placement = INSTREAM &`	`video.api = 1` VPAID 1.0 o `2`: VPAID 2.0
Outstream	Objeto VIDEO presente `video.linearity: linear` La posición depende de la posición real, valores que se indican a continuación `Video.startdelay = 0`
In-feed	Objeto VIDEO presente y `video.placement = IN-FEED`
In-article	Objeto VIDEO presente y `video.placement = IN-ARTICLE`
Nativo	Objeto NATIVE presente y
Intersticial (VAST)	Objeto VIDEO presente y `video.placement = INTERSTITIAL`
Intersticial (sin VAST)	Objeto VIDEO presente y `video.placement = INTERSTITIAL`	Filtradas
En banner (MRAID)	El objeto de video no está presente & `banner.battr ≠ 6` Video en banner (reproducción automática) y `banner.battr ≠ 7` Video en banner (iniciado por el usuario)
En banner (sin MRAID)	El objeto de video no está presente & `banner.battr ≠ 6` Video en banner (reproducción automática) y `banner.battr ≠ 7` Video en banner (iniciado por el usuario)

Formato del video	Indicadores relevantes para los videos recomendados	Indicadores relevantes para los videos relacionados
In-stream (VPAID)	Mensaje de VIDEO presente y `placement = INSTREAM & Allowed_video_formats = VPAID_JS`	`Allowed_video_formats = VIDEO_HTML5 Allowed_ad_types = VIDEO`
In-stream (sin VPAID)	Mensaje de VIDEO presente y `placement = INSTREAM & Allowed_video_formats ≠ VPAID_JS`	Allowed_video_formats = VIDEO_HTML5 y `excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-feed	Mensaje de VIDEO presente y `placement = IN-FEED`	Allowed_video_formats = VIDEO_HTML5 y `excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-article	Mensaje de VIDEO presente y `placement = IN-ARTICLE`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Nativo	Mensaje NATIVO presente y `VIDEO = 000x000` dentro del mensaje nativo	`Allowed_ad_types = NATIVE`
En banner	`excluded_attribute ≠ 95` VideoType: video en banner (el publicador puede bloquearlo)	`Allowed_ad_types = BANNER`

Anuncios de video

Requisitos del comprador

Macros compatibles

Detalles del texto destacado

Segmentación previa

Ejemplos de respuestas y solicitudes de oferta

Formatos de video de AdX

Cómo los compradores pueden incluir videos

Web

Indicadores recomendados de OpenRTB

Web móvil y web para computadoras de escritorio

Aplicación para dispositivos móviles

Indicadores recomendados de protocolo de AdX

Computadoras de escritorio y la Web móvil

Aplicación para dispositivos móviles

Cómo los publicadores pueden permitir o rechazar los anuncios de video

OpenRTB

Protocolo de AdX

Casos extremos

Glosario

Campos de AdX y OpenRTB en formatos In-stream y outstream

Protocolo de AdX

OpenRTB Proto

Fuente del valor de la solicitud de oferta

Formato del video	Detalles de la solicitud de oferta relevante para el video	Indicadores relacionados con videos relevantes
In-stream	Mensaje de VIDEO presente `placement = INSTREAM`	`Allowed_video_formats = VIDEO_HTML5 excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-feed	Mensaje de VIDEO presente y `placement = IN-FEED`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-article	Mensaje de VIDEO presente y `placement = IN-ARTICLE`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Nativo	Mensaje NATIVO presente y `VIDEO = 000x000` dentro del mensaje nativo	`Allowed_ad_types = NATIVE`
Intersticial	Mensaje de VIDEO presente y `placement = INTERSTITIAL &`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
En banner (MRAID)	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable) & excluded_attribute ≠ 32 MraidType: MRAID`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = BANNER`
En banner (sin MRAID)	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable) & excluded_attribute = 32 MraidType: MRAID`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = BANNER`

Opción de pub	Formatos aplicables	Se describe en la solicitud de oferta como
Especificar un video in-stream una unidad	In-stream (todos)	Objeto de video presente y `video.placement = INSTREAM`
Habilitar VPAID	In-stream web	Objeto de video presente & `video.api = 1` (VPAID 1.0) o `2` (VPAID 2.0)
Habilitar la IBV	En banner Intersticial	`banner.battr ≠ 6` Video en banner (reproducción automática) o `7` Video en banner (iniciado por el usuario)
Cómo habilitar los outstream (instructions)	In-feed In-article	Objeto de video presente & `video.placement = IN-FEED` o `IN-ARTICLE`
Cómo habilitar los outstream (instructions)	Nativo	Objeto nativo presente
Bloquear video intersticial	Aplicación intersticial	El objeto VIDEO no está presente.

Objeto de OpenRTB	Campos	AdX /Exchange Ofertas Outstream	Valores de muestra	¿Quién lo determina? /¿De dónde deriva este valor?
Objeto
Video	mimos	sí	["application/javascript", "video/mp4"]",	Google
	minduración	no		Configurada por el publicador
	duraciónmáx.	sí		Configurada por el publicador
	playmet hod	sí	[6]	Por lo general, configurado por el publicador
	API (MRAID)	sí	[1,2]	Google
	protocols	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 predeterminado
	omitir	sí	1	Publicador/Google - para Intersticial => Google - para Instream => El publicador decide si permitirá los anuncios que se pueden omitir, los que no se pueden omitir o ambos. Recompensa los anuncios que 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 x	sí	1	Google
impresión
	Protege	sí	1	Google tiene el valor predeterminado "true" porque la etiqueta de anuncio siempre es segura.