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

Anuncios de video en el protocolo de RTB de Google

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

Los compradores pueden comprar inventario de video en varias posiciones actualmente es in-stream e intersticial. Consulta anuncios intersticiales para obtener más detalles.

Requisitos para los compradores

Los compradores de RTB nuevos deberían desarrollar a 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 Procesa la solicitud y Crear la respuesta.

Macros compatibles

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

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

No se necesitan macros de clics (como CLICK_URL_ESC) porque Authorized Buyers incluye sus servicios de seguimiento de clics en un wrapper de VAST. Por lo tanto, no se admiten macros de clics para anuncios de video in-stream. Para obtener más información sobre macros compatibles, consulta Especifica macros en Crea la respuesta.

Detalles del texto destacado

El protocolo de licitación en tiempo real utiliza un mensaje de video, definido en la real-time-Bidding-proto.txt para identificar las solicitudes de video y para proporcionar información adicional específica sobre el video sobre la solicitud.

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

description_url

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

EndCapSupport

Cuando se habilita, se puede elegir el anuncio complementario se renderizará como un extremo (tarjeta de información) en el espacio de video. después de que termina de reproducirse el anuncio de video.

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

is_embedded_offsite

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

is_rewarded

Si se configura como true, indica que el usuario recibe un por ver el anuncio de video. Una recompensa típica puede ser leer un artículo adicional gratis, recibir una vida extra en un juego o conseguir una sesión de música sin anuncios patrocinada.

max_ad_duration

Es la duración máxima permitida en milisegundos del 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 video de Authorized Buyers. Un valor distinto de cero indica que el espacio publicitario actual es un grupo de anuncios de video. que pueden 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 en milisegundos del anuncio que debería devolver. Si no se establece o tiene un valor inferior o igual a cero, no hay una duración mínima.

Placement

Describe dónde se reproducirá el video.

`UNKNOWN_PLACEMENT`	La posición es desconocida o indeterminable.
`INSTREAM`	In-stream significa que el anuncio se reproduce antes, durante o después de otro contenido de video. Esto es similar a un comercial de TV tradicional. El contenido de video que el usuario está mirando no se reproduce mientras se está reproduciendo el anuncio.
`INTERSTITIAL`	Intersticial significa que el anuncio de video se reproduce frente a contenido que no sea de video (por ejemplo, un artículo de noticias o un videojuego) El anuncio cubre todo o casi todo el espacio en la pantalla ocupado por el contenido y el usuario no puede continuar al contenido hasta que el anuncio haya terminado o se haya omitido.
`IN_FEED`	El formato de video in-feed es una creatividad de video que se muestra cuando el usuario es desplazarse por un feed de contenido, generalmente el feed de una aplicación social, El video se renderiza en el feed principal y en el del flujo de trabajo de visión y lectura. El video no se renderiza a un lado, como video en banner.

skippable_max_ad_duration

Es la duración máxima del anuncio en milisegundos. que deberías mostrar si el anuncio se puede omitir. Por lo general, difiere de la duración máxima para los anuncios que no se pueden omitir. Si este campo no se establece o tiene un valor inferior o igual a 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 clic para reproducir. 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 reproduce hasta que se hace clic en él.

video_ad_skippable

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

`ALLOW_SKIPPABLE`	significa que se permiten tanto los anuncios que se pueden omitir como los que no.
`REQUIRE_SKIPPABLE`	significa que solo se pueden mostrar anuncios que se pueden omitir.
`BLOCK_SKIPPABLE`	significa que solo se pueden mostrar anuncios que no se pueden omitir.

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

videoad_start_delay

Tiempo en milisegundos desde el inicio del video hasta el punto en que aparece el anuncio. 0 significa anuncio previo al video y -1 significa anuncio al final del video. Cualquier otro valor positivo indica que la ranura está en la mitad del video.

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

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 configura 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). Para 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 tablets.
`PERSONAL_COMPUTER`	incluye computadoras de escritorio y laptops.
`CONNECTED_TV`	incluye ambas TVs conectadas (es decir, smart TVs) y los dispositivos conectados (como Roku, Apple TV, etc.).
`GAME_CONSOLE`	incluye dispositivos de juego dedicados.

brand

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

model

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

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 este horario disponible. serán visibles para el usuario final según la frecuencia con la que no han sido visibles en el pasado. Expresado como porcentaje en el rango de [0, 100]. El valor predeterminado es -1. indica que los datos de visibilidad del historial no están disponibles.

content_attributes.duration_seconds

Cuántos segundos (por ejemplo, 200) se reproduce el video Esto se declara en el mensaje ContentAttributes. Se establece en el valor especificado en los metadatos del video. proporcionada 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. Todo otros campos existentes en la solicitud de oferta también se aplican al video.

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.

allowed_vendor_type

El proveedor permitido. 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.

allowed_video_formats

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

`VIDEO_FLASH`	Permite videos en formato Flash Video (FLV).
`VIDEO_HTML5`	Permite videos en formato HTML5.
`VPAID_FLASH`	Permite videos que utilizan la publicación de anuncios del reproductor de video Formato de video Flash de definición de interfaz (VPAID)
`VPAID_JS`	Permite los videos que utilizan el VPAID JavaScript.

companion_slot

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

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

url

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

    http://www.publisher.com/watchpagelink

Al responder 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 del 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 de oferta de video son los siguientes:

attribute: Son todos los atributos de los anuncios que se pueden mostrar en este fragmento. Consulta la comprador-declarable-creative-attributes.txt para la lista de IDs. Verificamos que ninguno de estos atributos se encuentre en el Lista excluded_attribute de la solicitud de oferta. Solo configura este campo si se muestra un fragmento HTML o un anuncio de video. Por ejemplo, establecer este campo en 30 indica Debe ser compatible con VPAID para su renderización.

Creatividad de video	In-stream (todos)	In-feed/artículo	In-feed/artículo nativo	Intersticial	En banner
VPAID + VAST
VAST
MRAID y JS
JS personalizado
Nativo + VAST

Creatividad de video	In-stream (todos)	In-feed/artículo	In-feed/artículo nativo	Intersticial	En banner
VPAID + VAST
VAST
MRAID y JS
JS personalizado
Nativo + VAST

Formato del video	Indicadores recomendados (solo indicadores relevantes de video)	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` de la posición depende del valor real posición, con valores como los siguientes `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	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)

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` de la posición depende del valor real posición, con valores como los siguientes `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)	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 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)

Formato del video	Indicadores recomendados relevantes para los videos	Indicadores relevantes de los videos relacionados
In-stream (VPAID)	VIDEO: mensaje presente y `placement = INSTREAM & Allowed_video_formats = VPAID_JS`	`Allowed_video_formats = VIDEO_HTML5 Allowed_ad_types = VIDEO`
In-stream (sin VPAID)	VIDEO: mensaje presente y `placement = INSTREAM & Allowed_video_formats ≠ VPAID_JS`	Allowed_video_formats = VIDEO_HTML5 & `excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-feed	VIDEO: mensaje presente y `placement = IN-FEED`	Allowed_video_formats = VIDEO_HTML5 & `excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-article	VIDEO: mensaje presente y `placement = IN-ARTICLE`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Nativo	Presente un mensaje NATIVE y `VIDEO = 000x000` en el 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 en el protocolo de RTB de Google

Requisitos para los compradores

Macros compatibles

Detalles del texto destacado

Orientación previa

Ejemplos de respuestas y solicitudes de oferta

Formatos de video de AdX

Cómo pueden incluir videos los compradores

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

Web móvil y computadoras de escritorio

Aplicación para dispositivos móviles

Cómo los publicadores pueden permitir o no los videos

OpenRTB

Protocolo de AdX

Casos extremos

Glosario

Campos de AdX y OpenRTB en formatos Instream y Outstream

Protocolo de AdX

Protocolo de OpenRTB

Fuente del valor de la solicitud de oferta

Formato del video	Detalles de la solicitud de oferta relevante para el video	Indicadores relacionados con los videos
In-stream	VIDEO: mensaje presente `placement = INSTREAM`	`Allowed_video_formats = VIDEO_HTML5 excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-feed	VIDEO: mensaje presente y `placement = IN-FEED`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-article	VIDEO: mensaje presente y`placement = IN-ARTICLE`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Nativo	Presente un mensaje NATIVE y `VIDEO = 000x000` en el mensaje nativo	`Allowed_ad_types = NATIVE`
Intersticial	VIDEO: mensaje 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 una unidad de video in-stream	In-stream (todos)	Objeto de video presente y `video.placement = INSTREAM`
Habilitar VPAID	Web in-stream	Objeto de video presente y `video.api = 1` (VPAID 1.0) o `2` (VPAID 2.0)
Habilitar IBV	En banner Intersticial	`banner.battr ≠ 6` Video en banner (reproducción automática) o `7` Video en banner (Iniciado por el usuario)
Habilitar outstream (instrucciones)	In-feed In-article	Objeto de video presente y `video.placement = IN-FEED` o `IN-ARTICLE`
Habilitar outstream (instrucciones)	Nativo	Objeto nativo presente
Bloquear video intersticial	Aplicación intersticial	El objeto VIDEO no está presente

Opción de pub	Formatos aplicables	En la solicitud de oferta se describe como (NOTA: estos son TODOS los indicadores de la opción de publicación en la solicitud de oferta (para ver los indicadores recomendados, consulta la siguiente tabla)	Es la configuración predeterminada.
Especificar una unidad de video in-stream	In-stream (todos)	Mensaje de video presente y `placement = INSTREAM`	N/A
Habilitar VPAID	Web in-stream	Mensaje de video presente y `Allowed_video_formats = VPAID_JS &` `excluded_attribute ≠ 30 InstreamVastVideoType: Vpaid`	Inhabilitar
Habilitar IBV	En banner Intersticial	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)`	Inhabilitar
Habilitar outstream (instrucciones)	In-feed In-article	Mensaje de video presente y `Allowed_video_formats = VIDEO_HTML5 & placement = IN-FEED or IN-ARTICLE`	Inhabilitar
Habilitar outstream (instrucciones)	Nativo	Mensaje nativo presente y `VIDEO = 000x000` en el mensaje nativo	Inhabilitar
Bloquear video intersticial	Aplicación intersticial	El mensaje de VIDEO no está presente y `excluded_attribute = 30 InstreamVastVideoType: Vpaid`	Habilitar

OpenRTB Objeto	Campos	AdX /Exchange Ofertas Out-stream	Valores de muestra	¿Quién lo determina? /Dónde este valor deriva ?
Objeto
Video	mímica	sí	["application/javascript", "video/mp4"]",	Google
	duraciónmin	no		Configurado por el publicador
	duración máxima	sí		Configurado por el publicador
	Reproducción de hod	sí	[6]	Por lo general, el publicador Configurada
	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, valor predeterminado de 5 s
	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ín.	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 el valor predeterminado es verdadero . porque la etiqueta del anuncio siempre es seguro