La implementación de una solución de video basada en etiquetas para la demanda de Ad Exchange sin el uso del SDK de IMA es una opción en fase beta y es posible que no esté disponible para su red. Para obtener más información, puede comunicarse con su administrador de cuentas.
En este artículo, se muestra una lista de los parámetros obligatorios y recomendados para las etiquetas de anuncios de VAST que se usan para publicar anuncios en implementaciones web.
En esta página, encontrarás lo siguiente:
- Parámetros obligatorios para la publicación de anuncios
- Parámetros obligatorios para la programática
- Parámetros recomendados para la programática
Puedes revisar las listas de otros tipos de implementación o los requisitos de las URLs para las etiquetas de anuncios de VAST.
Parámetros obligatorios y recomendados para la Web
Parámetros obligatorios para la publicación de anuncios
Descripción
El parámetro de correlator (correlator) admite un valor variable que comparten múltiples solicitudes provenientes de la misma vista de página. Se usa para implementar exclusiones de la competencia, incluso en entornos sin cookies.
Ejemplos de uso
correlator=4345645667
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Uso del SDK
- Si usa el SDK de IMA, el valor de correlator se establece automáticamente. Si tu reproductor intenta establecer este valor, el SDK lo reemplaza y establece su propio valor.
- Si no usas el SDK de IMA, asegúrate de elegir un valor entero positivo verdaderamente aleatorio que no se vuelva a usar en varias páginas vistas.
Descripción
El parámetro de URL de descripción (description_url) acepta un valor variable que debe describir el video que se reproduce en la página.
La URL de descripción debe referirse a los videos que se reproducen en una página específica de una app web, para dispositivos móviles o para TVs. No debe ser el dominio de nivel superior de todos los videos ni de todas las solicitudes de anuncios. Por ejemplo, si tienes una página https://www.ejemplo.com/golf.html para mostrar videos sobre golf, configúrala como el valor de description_url.
Ejemplos de uso
El valor de description_url debe estar codificado en formato de URL para las páginas web con videos y los dispositivos OTT o CTV. Sin embargo, el valor de description_url no debe estar codificado para las apps para dispositivos móviles.
Con codificación en formato de URL:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
Sin codificación:
description_url=
https://www.ejemplo.com/golf.html
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en apps web y para dispositivos móviles. También es obligatorio si utilizas Ad Exchange o AdSense para la asignación dinámica.
Se recomienda usar este parámetro para la monetización programática.
Uso del SDK
El SDK de IMA no configura este parámetro automáticamente, Debe configurarse de forma manual.
Consulta las guías del SDK de IMA para tu plataforma.
Descripción
El parámetro de entorno (env) admite un valor constante que indica que una solicitud es in-stream o que proviene específicamente de un reproductor de video.
Los valores posibles son instream, que se puede utilizar para anuncios de video y audio, o vp, que solo se puede utilizar para anuncios de video.
Ejemplos de uso
Video o audio:
env=instream
Solo video:
env=vp
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Este parámetro es obligatorio para generar informes precisos sobre el tipo de solicitud desglosado por "Etiqueta de video".
Descripción
El parámetro de indicador de esquema de Google Ad Manager (gdfp_req) acepta un valor constante que indica que la solicitud de anuncio es para el inventario de Google Ad Manager.
Ejemplos de uso
gdfp_req=1
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Descripción
El parámetro de unidad de anuncios (iu) acepta un valor variable que se debe establecer en la unidad de anuncios actual, con el formato: /network_code/.../ad_unit.
Ejemplos de uso
iu=/6062/videodemo
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Descripción
El parámetro de formato de salida (output) admite un valor constante que se debe establecer para el formato de salida del anuncio.
Ejemplos de uso
Usa la versión de VAST predeterminada de tu red:
output=vast
Usa VAST 4 (puedes establecer versiones específicas para etiquetas específicas):
output=xml_vast4
Usa la configuración de VMAP predeterminada de tu red:
output=vmap
Usa VMAP 1:
output=xml_vmap1
Usa VMAP 1 para mostrar VAST 4 (si muestras VAST dentro de VMAP):
output=xml_vmap1_vast4
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en la Web, en apps para dispositivos móviles, en TV conectadas, en audio y en publicidad digital exterior. Es obligatorio para generar el formato de respuesta de publicación de anuncios correcto.
Uso del SDK
En VAST, si su reproductor de video usa el SDK de IMA, el parámetro de salida para una solicitud de anuncio de video siempre se establecerá en output=xml_vast4. Esto no supone ningún riesgo de confiabilidad, ya que el SDK es retrocompatible con todas las versiones de VAST que pueda publicar cualquier servidor de anuncios de terceros.
Descripción
El parámetro de tamaño (sz) admite un valor variable que debe definirse con el tamaño del espacio de anuncio de video principal.
Si hay varios tamaños, debes separarlos con el carácter de barra vertical (|).
No incluyas "v" después del tamaño.
Ejemplos de uso
Tamaño único:sz=400x300
Varios tamaños:sz=300x250|400x300
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en la Web, en apps para dispositivos móviles, en TVs conectadas y en publicidad digital exterior.
Este parámetro es opcional si solo se solicita ad_type=audio.
Descripción
El parámetro de impresiones retrasadas (unviewed_position_start) admite un valor constante para indicar las impresiones de video retrasadas.
Ejemplos de uso
unviewed_position_start=1
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en la Web y en apps para dispositivos móviles cuando hay una oportunidad de impresión retrasada.
Descripción
El parámetro de URL (url) admite un valor variable que se debe definir con la URL completa desde la que se envía la solicitud. Este valor es necesario para ayudar a los compradores a identificar y comprender el contexto del origen de donde proviene esta solicitud. En la medida de lo posible, este valor se debe propagar de forma dinámica en la solicitud de anuncio.
- En la Web, esta es la URL de la página que muestra el reproductor de video.
- En entornos que no son web, se debe definir como una URL que represente de la manera más precisa posible el inventario de video o audio que se va a monetizar, por ejemplo, si el usuario mira un video dentro de una app para dispositivos móviles que también está disponible en una URL equivalente para computadoras de escritorio.*
Nota: url difiere de description_url en que url hace referencia a la ubicación desde la que se realizó una solicitud de anuncio, mientras que description_url es una página web rastreable que describe el contenido del video.
El valor de este parámetro debe estar codificado.
Ejemplos de uso
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* En el caso de las apps, si no es posible establecer este parámetro en un valor de URL variable, se recomienda el siguiente patrón: url=https%3A%2F%2F<app/bundleid>.example.com
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar la publicación de anuncios en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Uso del SDK
Si usas el SDK de IMA, el valor de URL se define automáticamente. Si el reproductor establece este valor, el SDK de IMA respetará el valor establecido.
Parámetros obligatorios para la programática
Descripción
El parámetro de posición de OTT (ott_placement) acepta un valor constante que indica una solicitud de una posición de OTT que no es in-stream.
Definiciones de posiciones para los siguientes ejemplos:
- Pausa: Es un formato out-stream que aparece como una superposición sobre el contenido de video cuando un usuario pausa la reproducción.
- Pantalla principal: Es un anuncio que aparece en la pantalla principal de un dispositivo de CTV o una app de OTT. Esto incluye implementaciones de anuncios masthead, banners y tarjetas en una pantalla principal.
- Pantalla en pantalla: Es un anuncio de video in-stream que se reproduce en un reproductor de video de anuncios independiente junto al contenido de video. Por lo general, requiere que se apriete el contenido de video y se cargue un segundo reproductor de video.
- Banner en L: Es un anuncio gráfico in-stream que implica apretar el contenido de video y crear un anuncio alrededor de él. Por lo general se trata de un cuadro de contenido de anuncio en forma de L, pero existen más variantes.
- Superposición: Es cualquier formato de anuncio in-stream que aparece sobre el contenido de video, pero no ocupa la pantalla completa. Puede ser un anuncio gráfico o de video.
Ejemplos de uso
Formatos compatibles y sus valores correspondientes:
Pausa:
ott_placement=1
Pantalla principal:
ott_placement=2
Pantalla en pantalla:
ott_placement=3
Banner en L:
ott_placement=4
Superposición:
ott_placement=5
Personalizado/otro:
ott_placement=99
Requisitos y recomendaciones
Este parámetro solo es obligatorio para la monetización programática en la Web, en apps para dispositivos móviles y en TV conectadas para los publicadores que monetizan posiciones no estándares en entornos de transmisión OTT.
Descripción
El parámetro de posición (plcmt) admite un valor constante que se usa para indicar si el inventario in-stream se declara o no como "In-stream" o "Complementario" de acuerdo con las pautas de las especificaciones de IAB.
En el caso de las solicitudes de contenido que no son in-stream, este campo se completa automáticamente para los compradores en función del formato de inventario declarado y anula cualquier declaración de contenido in-stream o complementario.
Ejemplos de uso
Solicitud de contenido in-stream:
plcmt=1
Solicitud de contenido complementario:
plcmt=2
Requisitos y recomendaciones
Este parámetro es obligatorio para la monetización programática en la Web, en apps para dispositivos móviles, en TV conectadas, en audio y en publicidad digital exterior.
Descripción
El parámetro de reproducción automática de video (vpa) admite un valor constante que indica si el contenido de video de un anuncio comienza con una reproducción automática o con un clic.
Los valores posibles son click si la página espera una acción del usuario o auto si el video se reproduce automáticamente. Este parámetro no cambia el estado del reproductor de video, por lo que el reproductor debe controlar el comportamiento de reproducción de forma directa.
Ejemplos de uso
Reproducción automática:
vpa=auto
Clic para reproducir:
vpa=click
Este parámetro debe dejarse sin configurar si se desconoce.
Requisitos y recomendaciones
Este parámetro es obligatorio para la monetización programática en la Web, en apps para dispositivos móviles, en TVs conectadas y en audio.
Este parámetro también se recomienda según los Lineamientos de medición de video del Media Rating Council (MRC).
Descripción
El parámetro de reproducción de video silenciada (vpmute) admite un valor constante que indica si la reproducción del anuncio comienza mientras el reproductor de video está silenciado. Este parámetro no cambia el estado del reproductor de video, por lo que el reproductor debe controlar el comportamiento de reproducción de forma directa.
Ejemplos de uso
La reproducción comienza silenciada:
vpmute=1
La reproducción comienza sin silenciar:
vpmute=0
Requisitos y recomendaciones
Este parámetro es obligatorio para la monetización programática en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Este parámetro también se recomienda según los Lineamientos de medición de video del Media Rating Council (MRC).
Parámetros recomendados para la programática
Descripción
El parámetro de reproducción continua de audio (aconp) admite un valor constante que indica si el reproductor está configurado para reproducir continuamente contenido de audio. Esto ayuda a Google Ad Manager a seleccionar los anuncios más adecuados para la experiencia del usuario.
Ejemplos de uso
Reproducción continua activada:
aconp=2
Reproducción continua desactivada:
aconp=1
Si no sabes si el audio se reproduce de forma continua, este parámetro debe dejarse sin configurar o establecerse en aconp=0.
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Este parámetro también se recomienda según los Lineamientos de medición de audio del Media Rating Council (MRC).
Descripción
El parámetro de sugerencia de tipo de dispositivo (dth) acepta un valor constante que ayuda a reducir la clasificación incorrecta de los dispositivos, en especial en los entornos de TVs conectadas y decodificadores.
La clasificación incorrecta de los dispositivos puede deberse a errores no intencionados del publicador o del OEM de la TV conectada. Este parámetro se usaría junto con otros indicadores para que Google detecte automáticamente las instancias en las que se podría volver a clasificar el inventario de TVs conectadas.
Ejemplos de uso
Solicitudes de:
- Teléfono celular:
dth=1 - Smartphone:
dth=2 - Computadora de escritorio:
dth=3 - Tablet:
dth=4 - TV conectada:
dth=5 - Consola de juegos:
dth=6 - Decodificador:
dth=7
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Uso del SDK
Se recomienda este parámetro para las implementaciones de PAL y PAI (sin SDK). No es necesario para el SDK de IMA ni el SDK de DAI.
Descripción
En el caso de las integraciones que usan la biblioteca de acceso programático (PAL), el parámetro de nonce de video acepta un valor de cadena variable.
El nonce es seguro para las URLs, por lo que no es necesario que lo codifiques para ese formato.
Nota: Si anteriormente proporcionaste un nonce con el parámetro heredado paln, te recomendamos que migres al parámetro givn y que dejes de enviar paln. No incluyas ambos parámetros.
Ejemplos de uso
Lee las guías de introducción de PAL, para obtener más información sobre el valor que se pasa a este parámetro.
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles, en TV conectadas, en audio y en publicidad digital exterior.
Descripción
El parámetro de idioma (hl) admite un valor constante que se usa para solicitar anuncios en ese idioma y durante la selección de anuncios y la renderización de anuncios de video en la asignación dinámica para Ad Exchange o Video de AdSense.
Ejemplos de uso
Solicita anuncios en italiano:
hl=it
El valor del parámetro puede ser cualquier código ISO 639-1 (dos letras) o ISO 639-2 (tres letras). Consulte una lista de códigos válidos.
Si se omite, el valor se establece de forma predeterminada en cualquier idioma con segmentación de anuncios por idioma en Ad Exchange.
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles, en TVs conectadas, en audio y en publicidad digital exterior.
Descripción
El parámetro de nombre del socio de OMID (omid_p) admite un valor variable que indica el nombre del socio que integra la medición de OMID, junto con la versión del socio.
El parámetro de APIs de SDK compatibles (sdk_apis) admite valores variables que pueden ser una lista única o separada por comas de APIs compatibles.
Estos parámetros son parte de un conjunto de parámetros que se usan para la visibilidad y la verificación de anuncios.
Ejemplos de uso
Cuando no usas la PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Consulte una lista de posibles valores de frameworks de las API.
Cuando se usas la PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles, en TV conectadas, en audio y en publicidad digital exterior.
Uso del SDK
- Este parámetro solo se aplica a los publicadores que desean realizar mediciones de Vista activa cuando usan el SDK de Open Measurement (SDK de OM).
- Para indicar la compatibilidad con OMID cuando se usa la biblioteca de acceso programático (PAL), es necesario usar los parámetros
omidPartnerNameyomidPartnerVersionpara configurar el nombre y la versión del socio. Cuando no uses el SDK de PAL ni de IMA, debes configurar los parámetrosomid_pysdk_apis. - No se debe usar cuando se utiliza el SDK de IMA, ya que se configura automáticamente.
Descripción
El parámetro de reproducción continua de video (vconp) admite un valor constante que indica si el reproductor está configurado para reproducir contenido de video de forma continua, de manera similar a un broadcast de TV.
Ejemplos de uso
Reproducción continua ACTIVADA:
vconp=2
Reproducción continua DESACTIVADA:
vconp=1
Este parámetro debe dejarse sin configurar si se desconoce.
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles, en TVs conectadas y en audio.
Este parámetro también se recomienda según los Lineamientos de medición de video del Media Rating Council (MRC).
Descripción
El parámetro de duración del video (vid_d) admite un valor variable que especifica la duración del contenido, en segundos.
- Los parámetros
vid_dyallcuesse usan para publicar anuncios durante el video sin transferencia de contenido. - Para mostrar anuncios durante el video, es necesario implementar reglas de anuncios. Si en tus reglas de anuncios se usan inserciones basadas en el tiempo (por ejemplo, "Cada N segundos" o "En horarios fijos"), se utilizan aquellas establecidas en la regla de anuncios y se ignoran las inserciones que se pasan a
allcues. Los anuncios durante el video igualmente requieren duración, de manera que se debe pasarvid_d.
Ejemplos de uso
Duración del contenido de video de 90,000 segundos (25 horas):
vid_d=90000
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles y en TVs conectadas.
Descripción
El parámetro de posición del video (vpos) admite un valor constante que indica si la solicitud se envía desde un anuncio previo al video, durante el video o al final del video.
Ejemplos de uso
Anuncio previo al video:
vpos=preroll
Anuncio durante el video:
vpos=midroll
Anuncio al final del video:
vpos=postroll
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles, en TVs conectadas y en audio.
Si se usan reglas de anuncios, no se necesita este parámetro, ya que el servidor de anuncios lo agrega automáticamente.
Descripción
El parámetro "¿Por qué este anuncio?" (wta) admite un valor constante que indica la compatibilidad del reproductor de video para renderizar insignias de anuncios.
Ejemplos de uso
Si el reproductor debe renderizar el ícono de AdChoices proporcionado en la respuesta de VAST, usa lo siguiente:
wta=1(o bien omite el parámetrowtao pasawtasin establecer un valor)Las solicitudes de audio deben usar
wta=1si el ícono de AdChoices proporcionado en la respuesta de VAST se renderizará en anuncios complementarios o se proporcionará al usuario de otro modo.
Si el reproductor no debe renderizar el ícono de AdChoices proporcionado en la respuesta de VAST, usa lo siguiente:
wta=0
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios para ningún tipo de implementación específica, se recomienda para la monetización programática en la Web, en apps para dispositivos móviles, en TVs conectadas y en audio.
Cuando se usa el parámetro, ocurre lo siguiente:
- El tráfico con
&wta=0no es elegible para ciertos tipos de personalización de la demanda de Google. - El tráfico con
&wta=0del EEE no es elegible para las creatividades con insignias de anuncios habilitadas en las líneas de pedido de reservación y de Programática garantizada administradas por el publicador.
Los anuncios deben satisfacer los requisitos regulatorios aplicables para los anuncios publicados en el Espacio Económico Europeo (EEE). Esto incluye un mecanismo para que los usuarios denuncien contenido ilegal. Los publicadores deben notificar a Google sobre cualquier denuncia de contenido ilegal a través del formulario de Solicitudes de eliminación de contenido en Google.
Uso del SDK
La funcionalidad de insignias de anuncios se admite automáticamente cuando se usa el SDK de IMA. Si este no se usa, los reproductores de video deben implementar la compatibilidad conIcon y con IconClickFallbackImage de VAST, como se indica en el estándar de VAST de IAB.