En este artículo se muestra una lista completa de los parámetros que se pueden usar en una etiqueta de anuncio de VAST. Puede ser útil si quiere obtener más información sobre un parámetro concreto.
Secciones de esta página:
- Parámetros necesarios para el servicio de anuncios
- Parámetros obligatorios para la programática
- Parámetros recomendados para la programática
- Otros parámetros
Listas de parámetros por tipo de implementación
Si utiliza una implementación específica, puede usar listas de parámetros personalizados que describan el uso y los requisitos de esa implementación. Use la lista de parámetros personalizados para:
Web Aplicación móvil TV conectada Audio Publicidad digital exterior
Todos los parámetros
Parámetros obligatorios para el servicio de anuncios
Por lo general, estos parámetros son obligatorios para el servicio de anuncios en la mayoría de las implementaciones. Sin embargo, puede haber casos en los que no sean necesarios. Para obtener una lista lo más precisa posible, use la lista de parámetros de su tipo de implementación específico.
Descripción
El parámetro de correlación (correlator) acepta un valor variable que comparten varias solicitudes procedentes de la misma vista de página. Con este parámetro se implementa la exclusión de competencia, incluso en los entornos sin cookies.
Ejemplos de uso
correlator=4345645667
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar el servicio de anuncios en la Web, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
Uso del SDK
- Si utiliza el SDK de IMA, el valor de este parámetro se determina automáticamente. Si su reproductor intenta definir este valor, el SDK lo anula con un valor propio.
- En el caso de que no use el SDK de IMA, compruebe que este valor sea de verdad aleatorio, positivo y entero, así como que no se esté reutilizando en vistas de página diferentes.
Descripción
El parámetro "URL de descripción" (description_url) acepta un valor variable que debe describir el vídeo que se reproduce en la página.
El parámetro "URL de descripción" debe usarse en los vídeos que se reproducen en una página específica de una aplicación web, móvil o de televisión. No debe usarse en el dominio de nivel superior de todos los vídeos o de todas las solicitudes de anuncio. Por ejemplo, si tiene una página https://www.sample.com/golf.html para mostrar vídeos sobre golf, configúrela como el valor de description_url.
Ejemplos de uso
El valor description_url debe estar codificado como URL si se usa en páginas web con vídeos o en dispositivos CTV u OTT. Sin embargo, el valor description_url no debe estar codificado para aplicaciones móviles.
Codificado como URL:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
Sin codificar:
description_url=
https://www.sample.com/golf.html
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar el servicio de anuncios en la Web y aplicaciones móviles. También es obligatorio si utiliza Ad Exchange o AdSense para la asignación dinámica.
Este parámetro se recomienda para la monetización programática.
Uso del SDK
El SDK de IMA no da un valor a este parámetro automáticamente, sino que debe hacerse manualmente.
Consulte las guías del SDK de IMA para su plataforma.
Descripción
El parámetro de entorno (env) acepta un valor constante que indica una solicitud in-stream o una solicitud que procede exclusivamente de un reproductor de vídeo.
Los valores posibles son instream, que se puede utilizar en anuncios de vídeo o de audio, y vp, que solo se puede utilizar en anuncios de vídeo.
Ejemplos de uso
Vídeo, audio o ambos:
env=instream
Solo vídeo:
env=vp
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar el servicio de anuncios en la Web, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
Este parámetro es obligatorio para generar informes precisos sobre el tipo de solicitud desglosados por "Etiqueta de vídeo".
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 inventario de Google Ad Manager.
Ejemplos de uso
gdfp_req=1
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar el servicio de anuncios en la Web, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
Descripción
El parámetro de bloque de anuncios (iu) acepta un valor variable que debe ajustarse al bloque de anuncios, con el formato: /network_code/.../ad_unit.
Ejemplos de uso
iu=/6062/videodemo
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar el servicio de anuncios en la Web, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
Descripción
El parámetro de formato de salida (output) acepta un valor constante que debe ajustarse al formato de salida del anuncio.
Ejemplos de uso
Usar la versión de VAST predeterminada de su red:
output=vast
Usar VAST 4 (puede definir versiones específicas para etiquetas concretas):
output=xml_vast4
Usar el ajuste de VMAP predeterminado de su red:
output=vmap
Usar VMAP 1:
output=xml_vmap1
Usar VMAP 1, que devuelve VAST 4 (si devuelve VAST en elementos VMAP):
output=xml_vmap1_vast4
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar el servicio de anuncios en la Web, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior. Es necesario que se envíe el formato de respuesta de servicio de anuncios correcto.
Uso del SDK
Tenga en cuenta que, si utiliza VAST y su reproductor de vídeo utiliza el SDK de IMA, el parámetro "output" de la solicitud de anuncio de vídeo siempre deberá tener el valor output=xml_vast4. Este SDK es completamente fiable, ya que es compatible con todas las versiones anteriores de VAST que cualquier servidor de anuncios externo pueda servir.
Descripción
El parámetro de tamaño (sz) acepta un valor variable que debe ajustarse al tamaño del espacio publicitario de vídeo maestro.
Si usa varios tamaños, deben aparecer separados por una barra vertical (|).
No incluya "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 el servicio de anuncios en la Web, las aplicaciones móviles, las televisiones conectadas y la 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) acepta un valor constante para indicar impresiones retrasadas de vídeos.
Ejemplos de uso
unviewed_position_start=1
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar el servicio de anuncios en la Web y las aplicaciones móviles cuando hay una oportunidad de impresión retrasada.
Descripción
El parámetro de URL (url) acepta un valor variable que debe ajustarse a la URL completa desde la que se envía la solicitud. Este valor es necesario para que los compradores sepan de dónde procede la solicitud. Si es posible, este valor debería rellenarse de forma dinámica en las solicitudes de anuncios.
- En la Web, esta es la URL de la página en la que se muestra el reproductor de vídeo.
- En entornos que no sean web, este valor debe ser la URL que mejor represente el inventario de vídeo o de audio que se monetiza. Por ejemplo, si un usuario ve un vídeo en una aplicación móvil y ese vídeo también está disponible en un sitio para ordenadores, debe ser la URL para ordenadores equivalente.*
Nota: url y description_url son diferentes, ya que url hace referencia a la ubicación desde la que se hizo una solicitud de anuncio, mientras que description_url es una página rastreable en la Web que describe el contenido del vídeo.
El valor de este parámetro debería codificarse.
Ejemplos de uso
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* En el caso de las aplicaciones, si no es posible dar a este parámetro un valor de URL variable, se recomienda este patrón: url=https%3A%2F%2F<app/bundleid>.example.com
Requisitos y recomendaciones
Este parámetro es obligatorio para implementar el servicio de anuncios en la Web, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
Uso de SDK
Si usa el SDK de IMA, este parámetro se rellena automáticamente. Si su reproductor rellena este valor, el SDK de IMA respetará el valor que se asigne.
Descripción
El parámetro de reproducción del vídeo en silencio (vpmute) acepta un valor constante que indica si la reproducción del anuncio empieza mientras el reproductor de vídeo está silenciado. Este parámetro no cambia el estado del reproductor de vídeo, ya que es el reproductor el que debe gestionar directamente el comportamiento de la reproducción.
Ejemplos de uso
La reproducción se inicia en silencio:
vpmute=1
La reproducción se inicia con sonido:
vpmute=0
Requisitos y recomendaciones
Este parámetro es obligatorio para la monetización programática en la Web, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
Este parámetro también se recomienda en las directrices de medición de vídeos del Media Rating Council (MRC).
Parámetros obligatorios para la programática
Descripción
El parámetro de emplazamiento de OTT (ott_placement) acepta un valor constante que indica una solicitud de emplazamiento de OTT que no es in-stream.
Definiciones de emplazamientos de los ejemplos siguientes:
- Pausa: formato out-stream que aparece superpuesto sobre el contenido del vídeo cuando un usuario pausa la reproducción del contenido.
- Pantalla de inicio: anuncio que aparece en la pantalla de inicio de un dispositivo CTV o de una aplicación OTT. Esto incluye las implementaciones de masthead, banner y tile en una pantalla de inicio.
- Imagen en imagen: anuncio de vídeo in-stream que se reproduce en un reproductor de vídeo de anuncio independiente junto al contenido de vídeo. Por lo general, se requiere comprimir el contenido del vídeo y cargar un segundo reproductor de vídeo.
- L-banner: anuncio de display in-stream que comprime el contenido de vídeo y crea un anuncio alrededor del vídeo. Normalmente, aunque no se limita a ello, un recuadro de contenido publicitario en forma de L.
- Superposición: cualquier formato de anuncio in-stream que aparezca encima del contenido de vídeo, pero que no ocupe toda la pantalla. Puede ser un anuncio de display o de vídeo.
Ejemplos de uso
Formatos admitidos y sus valores correspondientes:
Pausa:
ott_placement=1
Pantalla de inicio:
ott_placement=2
Imagen en imagen:
ott_placement=3
L-banner:
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, aplicaciones móviles y TV conectada en el caso de los editores que moneticen emplazamientos no estándar en entornos de streaming OTT.
Descripción
El parámetro de emplazamiento (plcmt) acepta un valor constante que se utiliza para indicar si el inventario in-stream se declara como "in-stream" o "complementario" según las directrices de las especificaciones de IAB.
En las solicitudes que no son in-stream, este campo se rellena automáticamente para los compradores basándose en el formato de inventario declarado, que anula cualquier declaración in-stream o complementaria.
Ejemplos de uso
Solicitud 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, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
Descripción
El parámetro de tipo de lugar (venuetype) se utiliza para indicar el tipo de lugar de publicidad exterior. Los valores que cumplen los requisitos son los IDs de enumeración enteros admitidos por la versión 1.1 de la taxonomía de tipo de lugar de publicidad exterior abierta de IAB.
Ejemplos de uso
Habitaciones de hotel:
venuetype=80703
Tablet en el asiento de atrás de un taxi:
venuetype=103
Requisitos y recomendaciones
Este parámetro es obligatorio para la monetización programática en la publicidad digital exterior.
Descripción
El parámetro de reproducción de vídeo automática (vpa) acepta un valor constante que indica si el contenido de vídeo de un anuncio se inicia automáticamente o si hay que hacer clic en él.
Los valores posibles son click si la página espera una acción de usuario o auto si el vídeo se reproduce automáticamente. Este parámetro no cambia el estado del reproductor de vídeo, ya que es el reproductor el que debe gestionar directamente el comportamiento de la reproducción.
Ejemplos de uso
Reproducción automática:
vpa=auto
Clic para reproducir:
vpa=click
Este parámetro no debe definirse si no se sabe qué valor tiene.
Requisitos y recomendaciones
Este parámetro es obligatorio para la monetización programática en la Web, las aplicaciones móviles, las televisiones conectadas y el audio.
Este parámetro también se recomienda en las directrices de medición de vídeos del Media Rating Council (MRC).
Parámetros recomendados para la programática
Descripción
El parámetro de reproducción continua de audio (aconp) acepta un valor constante que indica si el reproductor pretende reproducir continuamente contenido de audio. Esto ayuda a Google Ad Manager a seleccionar los anuncios más adecuados para la experiencia de usuario.
Ejemplos de uso
Reproducción continua activada:
aconp=2
Reproducción continua desactivada:
aconp=1
Si no sabe si el audio se reproduce de forma continua, no debe definir este parámetro, o bien debe asignarle el valor aconp=0.
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en web, aplicaciones móviles, televisión conectada, audio y medios digitales exteriores.
Este parámetro también se recomienda en las directrices de medición de anuncios de audio del Media Rating Council (MRC).
Descripción
El parámetro de ID de aplicación (msid) y el parámetro de nombre de aplicación (an) aceptan valores variables que deben aplicarse a solicitudes enviadas desde aplicaciones móviles y dispositivos de TV conectada, ya que son necesarios en la mayoría de los anuncios de vídeo programáticos.
Si bien el nombre de la aplicación debe ser legible por personas y en dispositivos iOS y tvOS, el SDK no puede consultar el ID de la aplicación. En estos casos, el parámetro msid no se envía, y el SDK envía el app bundle a través del parámetro an.
Ejemplos de uso
msid=com.package.publisher&an=sample%20app
Los IDs de aplicaciones tienen un nombre y un formato diferentes según la tienda de aplicaciones. Consulte las directrices de IAB para la identificación de aplicaciones o los ejemplos de identificadores únicos comunes.
En el caso de las plataformas en las que no existe ninguna tienda de aplicaciones, IAB recomienda que los editores usen el formato siguiente para los IDs de tienda: com.publisher.deviceplatform
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación específica, se recomienda para la monetización programática en aplicaciones móviles, televisiones conectadas, audio y medios digitales exteriores.
Para proteger la marca y ofrecer más transparencia a los compradores, se recomienda incluir la información de la aplicación.
Uso del SDK
El SDK de IMA rellenará automáticamente ambos parámetros, pero deberán especificarse manualmente en entornos que no sean de SDK, como llamadas de VAST directas, o cuando se utilice la biblioteca de acceso programático (PAL) o el inventario autenticado por el editor (PAI).
Nota: Si se utiliza el SDK de IMA para HTML5, no se usa la información de la aplicación.
Descripción
El parámetro de indicación del tipo de dispositivo (dth) acepta un valor constante que ayuda a reducir la clasificación errónea de los dispositivos, especialmente en entornos de TV conectada y decodificadores.
La clasificación errónea de un dispositivo puede deberse a errores involuntarios del editor o del fabricante de la TV conectada. Este parámetro se usaría junto con otras señales para que Google detecte automáticamente los casos en los que el inventario de televisión conectada se puede volver a clasificar.
Ejemplos de uso
Solicitudes de:
- Teléfono básico:
dth=1 - Teléfono inteligente:
dth=2 - Ordenador:
dth=3 - Tablet:
dth=4 - TV conectada:
dth=5 - Videoconsola:
dth=6 - Decodificador:
dth=7
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en web, aplicaciones móviles, televisión conectada, audio y medios digitales exteriores.
Uso del SDK
Este parámetro se recomienda para las implementaciones de PAL y PAI (no SDK). No es necesario para el SDK de IMA ni para el SDK de inserción dinámica de anuncios.
Descripción
En el caso de las integraciones que usan la biblioteca de acceso programático (PAL), el parámetro de nonce de vídeo acepta un valor de cadena variable.
El nonce es seguro para las URLs, por lo que no es necesario codificarlo como URL.
Nota: Si ya ha proporcionado un nonce con el parámetro antiguo paln, le recomendamos que migre al parámetro givn y deje de enviar paln. No incluya ambos parámetros.
Ejemplos de uso
Puede consultar más información sobre el valor que se envía a este parámetro en las guías para empezar a usar PAL.
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en web, aplicaciones móviles, televisión conectada, audio y medios digitales exteriores.
Descripción
El parámetro de idioma (hl) acepta un valor constante que se utiliza para indicar el idioma de la solicitud de anuncios, la selección de anuncios y el renderizado de anuncios de vídeo en la asignación dinámica de vídeos de Ad Exchange y AdSense.
Ejemplos de uso
Solicitar anuncios en italiano:
hl=it
El valor de parámetro puede ser tanto un código ISO 639-1 (dos letras) como uno ISO 639-2 (tres letras). Consulte la lista de códigos válidos.
Si no se incluye, el valor predeterminado pasa a ser cualquier idioma con segmentación de anuncios por idioma en Ad Exchange.
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en web, aplicaciones móviles, televisión conectada, audio y medios digitales exteriores.
Descripción
El parámetro de ID de aplicación (msid) y el parámetro de nombre de aplicación (an) aceptan valores variables que deben aplicarse a solicitudes enviadas desde aplicaciones móviles y dispositivos de TV conectada, ya que son necesarios en la mayoría de los anuncios de vídeo programáticos.
Si bien el nombre de la aplicación debe ser legible por personas y en dispositivos iOS y tvOS, el SDK no puede consultar el ID de la aplicación. En estos casos, el parámetro msid no se envía, y el SDK envía el app bundle a través del parámetro an.
Ejemplos de uso
msid=com.package.publisher&an=sample%20app
Los IDs de aplicaciones tienen un nombre y un formato diferentes según la tienda de aplicaciones. Consulte las directrices de IAB para la identificación de aplicaciones o los ejemplos de identificadores únicos comunes.
En el caso de las plataformas en las que no existe ninguna tienda de aplicaciones, IAB recomienda que los editores usen el formato siguiente para los IDs de tienda: com.publisher.deviceplatform
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación específica, se recomienda para la monetización programática en aplicaciones móviles, televisiones conectadas, audio y medios digitales exteriores.
Para proteger la marca y ofrecer más transparencia a los compradores, se recomienda incluir la información de la aplicación.
Uso del SDK
El SDK de IMA rellenará automáticamente ambos parámetros, pero deberán especificarse manualmente en entornos que no sean de SDK, como llamadas de VAST directas, o cuando se utilice la biblioteca de acceso programático (PAL) o el inventario autenticado por el editor (PAI).
Nota: Si se utiliza el SDK de IMA para HTML5, no se usa la información de la aplicación.
Descripción
El parámetro de nombre de partner de OMID (omid_p) acepta un valor variable que indica el nombre del partner que integra la medición de OMID y la versión del partner.
El parámetro de APIs de SDK compatibles (sdk_apis) acepta valores variables, que pueden ser una sola API o una lista separada por comas de APIs compatibles.
Estos parámetros forman parte de un conjunto de parámetros que se utilizan para la visibilidad y la verificación de anuncios.
Ejemplos de uso
Cuando no se usa PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Consulta la lista de posibles valores de framework de la API.
Cuando se usa PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, aplicaciones móviles, televisión conectada, audio y medios digitales exteriores.
Uso del SDK
- Este parámetro solo se aplica a los editores que quieran hacer mediciones con Active View cuando usen el SDK de Open Measurement.
- Para indicar la compatibilidad con OMID al usar la biblioteca de acceso programático (PAL), debe usar
omidPartnerNameyomidPartnerVersionpara definir el nombre y la versión del partner. Si no utiliza el SDK de PAL ni de IMA, debe definir los parámetrosomid_pysdk_apis. - No se debe utilizar cuando se utilice el SDK de IMA, ya que se configura automáticamente.
Descripción
Los parámetros de identificadores de dispositivo que se pueden cambiar (rdid, idtype y is_lat) aceptan valores variables. Este valor también se denomina "identificador de publicidad" (IFA).
En las aplicaciones móviles que utilizan el SDK de IMA para Android o iOS, el SDK de IMA envía los identificadores de dispositivo que se pueden cambiar para la segmentación por usuarios a las solicitudes de emisión con los parámetros rdid, idtype e is_lat.
Si no se utiliza el SDK de IMA o si se utiliza la señalización de servidor (SSB), debe enviarlos como parámetros explícitos. Consulte más información sobre los identificadores de dispositivos.
Es necesario utilizar estos valores en casi todos los anuncios de vídeo programáticos.
|
A partir de iOS 14.5, Apple ha desactivado la señal |
Ejemplos de uso
Ver ejemplos detallados de los identificadores de dispositivos que los usuarios pueden cambiar.
Requisitos y recomendaciones
Aunque estos parámetros no son obligatorios para publicar anuncios en ninguna implementación específica, sí lo son para la monetización programática en las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
En las implementaciones web, no se utilizan identificadores de dispositivo que se pueden cambiar.
Uso de SDK
Aunque el SDK de IMA envía este campo automáticamente, los editores transfieren estos parámetros manualmente cuando usan el SDK de PAL.
Descripción
El parámetro de ID de sesión (sid) acepta un valor variable que es un identificador de publicidad que protege la privacidad y que solo se utiliza para limitar la frecuencia.
El ID de sesión se admite en las solicitudes de vídeo in-stream de televisiones conectadas y en el inventario de vídeo in-stream de dispositivos de aplicaciones móviles. Por el momento, no es compatible con la versión web.
Para inhabilitar la transferencia del ID de sesión, indique el valor sid=0.
Ejemplos de uso
sid=123e4567-e89b-12d3-a456-426614174000
Según las directrices sobre el identificador de publicidad de IAB, este parámetro debe rellenarse en formato UUID. Consulte más información sobre los identificadores de dispositivo que se pueden cambiar para la segmentación por usuarios.
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, es necesario para la monetización programática en la publicidad digital exterior.
Este parámetro se recomienda para la monetización programática en las aplicaciones móviles, las televisiones conectadas y el audio.
Uso de SDK
El SDK de IMA envía este parámetro automáticamente.
Descripción
El parámetro de reproducción continua de vídeo (vconp) acepta un valor constante que indica si el reproductor va a reproducir continuamente contenido de vídeo, de forma similar a una emisión de televisión.
Ejemplos de uso
Reproducción continua activada:
vconp=2
Reproducción continua desactivada:
vconp=1
Este parámetro no debe definirse si no se sabe qué valor tiene.
Requisitos y recomendaciones
Aunque 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, las aplicaciones móviles, las televisiones conectadas y el audio.
Este parámetro también se recomienda en las directrices de medición de vídeos del Media Rating Council (MRC).
Descripción
El parámetro de duración del vídeo (vid_d) acepta un valor variable que especifica la duración del contenido en segundos.
- Los parámetros
vid_dyallcuesse usan para servir anuncios mid-roll sin ingestión de contenido. - Es necesario usar reglas de anuncios para devolver anuncios mid-roll. Si en sus reglas de anuncios se utilizan puntos de inserción basados en tiempo (por ejemplo, "Cada N segundos" o "A intervalos fijos"), entonces se usarán esos puntos de inserción y se ignorarán los definidos en
allcues. Los anuncios mid-roll necesitan una duración, por lo que se debe enviarvid_dde todos modos.
Ejemplos de uso
Contenido de vídeo que dura 90.000 segundos (25 horas):
vid_d=90000
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación específica, se recomienda para la monetización programática en la Web, las aplicaciones móviles y las televisiones conectadas.
Descripción
El parámetro de la posición del vídeo (vpos) acepta un valor constante que indica si la solicitud de anuncio se envía desde una posición pre-roll, mid-roll o post-roll.
Ejemplos de uso
Pre-roll:
vpos=preroll
Mid-roll:
vpos=midroll
Post-roll:
vpos=postroll
Requisitos y recomendaciones
Aunque 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, las aplicaciones móviles, las televisiones conectadas y el audio.
Este parámetro no es necesario si se usan reglas de anuncios, ya que el servidor de anuncios lo añade automáticamente.
Descripción
El parámetro "¿Por qué este anuncio?" (wta) acepta un valor constante que indica la compatibilidad del reproductor de vídeo con el procesamiento de insignias de anuncios.
Ejemplos de uso
Si el reproductor debe renderizar el icono de Gestión de anuncios que se proporciona en la respuesta de VAST, utilice lo siguiente:
wta=1(u omita el parámetrowtao envíewtasin ningún valor definido)Las solicitudes de audio deben utilizar
wta=1si el icono de Gestión de anuncios que se proporciona en la respuesta de VAST se va a renderizar en anuncios complementarios o se mostrará al usuario de cualquier otra forma.
Si el reproductor no debe renderizar el icono de Gestión de anuncios proporcionado en la respuesta de VAST, utilice lo siguiente:
wta=0
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ningún tipo de implementación específico, se recomienda para la monetización programática en la Web, las aplicaciones móviles, las televisiones conectadas y el audio.
Cuando se usa el parámetro:
- El tráfico con
&wta=0no es apto para determinados tipos de personalización de la demanda de Google. - El tráfico de
&wta=0del EEE no es apto para las creatividades con insignias de anuncios habilitadas en las líneas de pedido de programática garantizada con reserva y administradas por el editor.
Los anuncios deben cumplir los requisitos normativos aplicables a los anuncios publicados en el Espacio Económico Europeo (EEE). Esto incluye un mecanismo para que los usuarios puedan denunciar contenido ilegal. Los editores deben notificar a Google las denuncias de contenido ilegal a través del formulario Solicitudes de Retiradas de Contenido en Google.
Uso de SDK
La función de insignias de anuncios se admite automáticamente si se utiliza el SDK de IMA. En los que no lo utilizan, debe implementarse la compatibilidad conIcon y IconClickFallbackImage de VAST, tal como se indica en el estándar de VAST de la IAB.Otros parámetros
Por lo general, estos parámetros no son necesarios de forma explícita para publicar anuncios, pero pueden ser obligatorios para usar determinadas funciones o para ciertos tipos de implementación.
Descripción
El parámetro de regla de anuncios (ad_rule) acepta un valor constante que indica si debe devolverse una creatividad de VAST o una respuesta de reglas de anuncios.
El ajuste predeterminado de las reglas de anuncios depende de un ajuste de red de Google Ad Manager que permite que todas las solicitudes sean solicitudes de reglas de anuncios. Si se usa la configuración de red, no es necesario definir ad_rule en la etiqueta de anuncio. Si quiere inhabilitar la función en función de la solicitud de anuncio, puede enviar ad_rule=0 para anular el ajuste de red. Además, si no tiene habilitadas las reglas para anuncios de forma predeterminada, puede habilitarlas o inhabilitarlas pasando ad_rule=1 y ad_rule=0, respectivamente.
Ejemplos de uso
Si el ajuste de reglas para anuncios está inhabilitado:
- Solicitud de creatividades de VAST:
ad_rule=0o no lo defina
Si el ajuste de reglas para anuncios está habilitado:
- Solicitud de creatividades de VAST:
ad_rule=0 - Solicitud de reglas de anuncios (VMAP):
ad_rule=1o no lo defina
Si decide no usar reglas para anuncios, puede utilizar parámetros de etiquetas de anuncio para indicar la pausa publicitaria y la duración del pod de sus etiquetas VAST mediante pmnd, pmxd y pmad.
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ningún tipo de implementación específico, es necesario para usar correctamente las reglas de anuncios de vídeo.
Descripción
El parámetro de consentimiento adicional (addtl_consent) acepta valores variables y lo utilizan los editores que quieren integrar la versión 2.0 del TCF de IAB y usar un proveedor que aún no esté registrado en la Lista global de proveedores de IAB Europe, pero que sí esté registrado en la lista de proveedores de tecnología publicitaria (ATP) de Google.
Puede consultar más información sobre los valores que se envían a este parámetro en las especificaciones técnicas del Modo de Consentimiento Adicional.
Ejemplo de uso
addtl_consent=1~1.35.41.101
Descripción
El parámetro de prueba de anuncio (adtest) debe usarse para asegurarse de que las consultas usadas para probar el inventario de backfill (no garantizado) no se identifiquen como tráfico no válido y no tengan un impacto en los ingresos.
Cuando pruebe el backfill, configure este parámetro como on para asegurarte de que ningún anuncio registre impresiones ni clics para utilizarlos durante las pruebas. Defina esta opción en off en entornos que no sean de pruebas para facturar como de normal. Si no se define ningún valor, el valor predeterminado de este parámetro es off.
Nota: Cuando pruebe líneas de pedido vendidas directamente, debe usar líneas de pedido de prueba que no afecten a los ingresos.
Ejemplos de uso
Activado:
adtest=on
Desactivado:
adtest=off
Descripción
El parámetro de tipo de anuncio (ad_type) acepta un valor constante que indica los tipos de anuncio con los que se debe responder a la solicitud.
Cuando ad_type se define como audio o audio_video, el parámetro vpmute debe configurarse como 0.
Ejemplos de uso
Solo permite anuncios de audio:
ad_type=audio
Permite anuncios de vídeo saltables y no saltables:
ad_type=video
Permite anuncios de audio y de vídeo:
ad_type=audio_video
Este valor
audio_videopermite que compitan los dos formatos, pero solo uno puede servir anuncios. Está pensado para usarse solo para servir creatividades de vídeo en contenido de audio compatible con la reproducción de anuncios de vídeo o creatividades de audio en reproductores de vídeo in-stream de contenido que, por su naturaleza, se puede escuchar, como emisiones deportivas, grabaciones de vídeo, noticias, etc. Consulte más información sobre el audio en contenido de vídeo.
Solo permite anuncios de vídeo saltables:
ad_type=skippablevideo
Solo permite anuncios de vídeo no saltables:
ad_type=standardvideo
Requisitos y recomendaciones
- Si su aplicación tiene contenido de vídeo, defina este parámetro como
videooaudio_video, o bien déjelo sin definir. - Si su aplicación solo tiene contenido de audio (por ejemplo, una aplicación de radio o de voz), debe asignar el valor
audioa este parámetro. Si no se define, no se devolverán anuncios de audio.
Descripción
El parámetro de tamaños de anuncios no lineales (afvsz) acepta valores constantes que deben estar en una lista separados por comas con tamaños de anuncios no lineales que se pueden mostrar en el espacio publicitario de vídeo.
Estos tamaños deben ser cualquiera de los siguientes:
200x200250x250300 x 250336x280450x50468 x 60480x90729x90
Al utilizar el SDK de IMA, este campo se sobrescribe y se rellena con todos los tamaños compatibles con nonLinearAdSlotWidth y nonLinearAdSlotHeight.
No hace falta incluir el parámetro o asignarle un valor si los tamaños no lineales no son compatibles.
Ejemplos de uso
Se admiten todos los tamaños:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
La anchura máxima es 250:
afvsz=200x200,250x250
La altura máxima es 60:
afvsz=450x50,468x60
La anchura máxima es 100:
//vacío; no admite ningún valor
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación o tipo de transacción específicos, es necesario para servir anuncios de vídeo no lineales si no se utiliza el SDK de IMA.
Descripción
El parámetro de todas las marcas (allcues) acepta valores variables que son una lista separada por comas de puntos de inserción indicados en milisegundos. Para cada valor, Google Ad Manager devuelve una pausa publicitaria.
- Los parámetros
vid_dyallcuesse usan para servir anuncios mid-roll sin ingestión de contenido. - Para devolver anuncios mid-roll, también se necesitan reglas de anuncios. Si en sus reglas de anuncios se utilizan puntos de inserción basados en tiempo (por ejemplo, "Cada N segundos" o "A intervalos fijos"), entonces se usarán esos puntos de inserción y se ignorarán los definidos en
allcues. Los anuncios mid-roll necesitan una duración, por lo que se debe enviarvid_dde todos modos.
Ejemplos de uso
Puntos de inserción en los segundos 10 y 20:
allcues=10000,20000
Descripción
El parámetro de tamaños complementarios (ciu_szs) acepta valores variables que son una lista separada por comas con tamaños complementarios.
Separe valores con una barra vertical (|) para indicar un espacio publicitario de varios tamaños.
Ejemplos de uso
ciu_szs=728x90,300x250
Tamaños con un espacio de varios tamaños:
ciu_szs=728x90,300x200|300x250
Descripción
Los parámetros de ID de fuente de contenido (cmsid) y de ID de vídeo (vid) aceptan valores variables.
Para orientar anuncios a contenido de vídeo, su etiqueta maestra de vídeo debe incluir ambos parámetros.
- El
cmsides el número único de una fuente de contenido. Puede verlo en Ad Manager si hace clic en Vídeo, luego en Fuentes de contenido y, a continuación, en el nombre de la fuente. - El parámetro
vides una cadena o un número que identifica un determinado vídeo. El CMS que aloja su contenido asigna este ID. Puede verlo en Ad Manager si hace clic en Vídeo, luego en Contenido y, a continuación, en el contenido de vídeo concreto.
Ejemplos de uso
cmsid=[value]&vid=[value]
Si va a crear una etiqueta para utilizarla en la inserción dinámica de anuncios con vídeos bajo demanda, debe utilizar las macros que insertan dinámicamente la fuente del contenido y el ID de vídeo correctos.
Por ejemplo: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisitos y recomendaciones
Aunque estos parámetros no son obligatorios para publicar anuncios en ninguna implementación o tipo de transacción específicos, sí son necesarios para usar la segmentación por contenido de vídeo.
Descripción
El parámetro de parámetros personalizados (cust_params) acepta valores variables que son pares clave-valor que le permiten definir criterios de segmentación concretos, como datos demográficos, posiciones de páginas, o una o varias páginas específicas.
Ejemplos de uso
Consulte ejemplos de cómo añadir pares clave-valor.
Descripción
El parámetro de categoría de exclusión (excl_cat) acepta valores variables y se utiliza para bloquear las líneas de pedido que contengan la etiqueta de exclusión en la solicitud de anuncio. Use el parámetro cust_params para definir la categoría de exclusión y las etiquetas de exclusión.
Ejemplos de uso
Para definir la categoría de exclusión de dos etiquetas de exclusión (airline_excl_label y train_excl_label), utilice un carácter de barra vertical (|) para separar las etiquetas:
excl_cat=airline_excl_label%7Ctrain_excl_label
A continuación, aplique la codificación de URL y utilice la cadena codificada en cust_params:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
Descripción
El parámetro de RGPD (gdpr) acepta valores constantes y lo utilizan los editores que quieren integrar la versión 2.0 del TCF de IAB. Las solicitudes de VAST directas no leen estos valores automáticamente, pero los aceptan cuando se añaden a las etiquetas de anuncio.
Los únicos valores válidos para este parámetro son 0 y 1. El valor 0 significa que no se aplica el RGPD, y 1 que sí se aplica. Si se aplica el RGPD, también debe proporcionar una cadena de TC válida mediante el parámetro gdpr_consent.
Puede consultar más información sobre los valores que se envían a este parámetro en la guía general sobre cómo implementar el marco o en la sección sobre la cadena de TC de las especificaciones de la versión 2.0 del TCF de la IAB.
Ejemplos de uso
Se aplica el RGPD:
gdpr=1
No se aplica el RGPD:
gdpr=0
Descripción
El parámetro de consentimiento conforme al RGPD (gdpr_consent) acepta valores variables y lo utilizan los editores que quieren integrar la versión 2.0 del TCF de IAB. Las solicitudes de VAST directas no leen estos valores automáticamente, pero los aceptan cuando se añaden a las etiquetas de anuncio.
Puede consultar más información sobre los valores que se envían a este parámetro en la guía general sobre cómo implementar el marco o en la sección sobre la cadena de TC de las especificaciones de la versión 2.0 del TCF de la IAB.
Ejemplos de uso
gdpr_consent=GDPR_CONSENT_123
Descripción
El parámetro de URL de exclusión de IAB (iabexcl) acepta valores variables, que son una lista de categorías separadas por comas.
Ejemplos de uso
iabexcl=3,14,527 excluye "Camiones comerciales", "Vehículos todoterreno" y "Rugby".
Puede descargar una lista de categorías de la taxonomía de contenido de IAB y sus IDs.
Descripción
Los parámetros de identificadores de dispositivo que se pueden cambiar (rdid, idtype y is_lat) aceptan valores variables. Este valor también se denomina "identificador de publicidad" (IFA).
En las aplicaciones móviles que utilizan el SDK de IMA para Android o iOS, el SDK de IMA envía los identificadores de dispositivo que se pueden cambiar para la segmentación por usuarios a las solicitudes de emisión con los parámetros rdid, idtype e is_lat.
Si no se utiliza el SDK de IMA o si se utiliza la señalización de servidor (SSB), debe enviarlos como parámetros explícitos. Consulte más información sobre los identificadores de dispositivos.
Es necesario utilizar estos valores en casi todos los anuncios de vídeo programáticos.
|
A partir de iOS 14.5, Apple ha desactivado la señal |
Ejemplos de uso
Ver ejemplos detallados de los identificadores de dispositivos que los usuarios pueden cambiar.
Requisitos y recomendaciones
Aunque estos parámetros no son obligatorios para publicar anuncios en ninguna implementación específica, sí lo son para la monetización programática en las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
En las implementaciones web, no se utilizan identificadores de dispositivo que se pueden cambiar.
Uso de SDK
Aunque el SDK de IMA envía este campo automáticamente, los editores transfieren estos parámetros manualmente cuando usan el SDK de PAL.
Descripción
El parámetro de dominio del partner que comparte inventario (ipd) acepta valores variables que deben ajustarse a las declaraciones inventorypartnerdomain del archivo app-ads.txt del editor (o ads.txt).
El parámetro inventorypartnerdomain es una especificación de IAB que permite que los editores designen el dominio de un partner que comparte inventario a efectos de validación de ads.txt/app-ads.txt.
Esta declaración es especialmente importante en casos prácticos donde se comparte inventario, en los que el inventario publicitario en el que se origina una solicitud puede ser propiedad de otro partner (el partner que comparte inventario).
Consulte más información sobre archivos ads.txt/app-ads.txt y partners que comparten inventario.
Ejemplos de uso
El atributoinventorypartnerdomain se encuentra en el archivo app-ads.txt que apunta al archivo .txt del partner que puede monetizar el inventario. El valor del parámetro ipd debe coincidir con un valor del archivo app-ads.txt, en uno de los elementos inventorypartnerdomain.Requisitos y recomendaciones
Este parámetro es obligatorio para los editores que monetizan inventario que no es de su propiedad.
Descripción
El parámetro de entidad de ping de impresión (ipe) acepta un valor constante, que sirve para indicar los pings de impresión y de conversión que proceden de un servidor, no de un cliente.
La entidad de ping de impresión se utiliza cuando un servidor envía pings/balizas de impresión desde el servidor.
Ejemplos de uso
Señalización de servidor (SSB):
ipe=ssb
Descripción
Los parámetros de identificadores de dispositivo que se pueden cambiar (rdid, idtype y is_lat) aceptan valores variables. Este valor también se denomina "identificador de publicidad" (IFA).
En las aplicaciones móviles que utilizan el SDK de IMA para Android o iOS, el SDK de IMA envía los identificadores de dispositivo que se pueden cambiar para la segmentación por usuarios a las solicitudes de emisión con los parámetros rdid, idtype e is_lat.
Si no se utiliza el SDK de IMA o si se utiliza la señalización de servidor (SSB), debe enviarlos como parámetros explícitos. Consulte más información sobre los identificadores de dispositivos.
Es necesario utilizar estos valores en casi todos los anuncios de vídeo programáticos.
|
A partir de iOS 14.5, Apple ha desactivado la señal |
Ejemplos de uso
Ver ejemplos detallados de los identificadores de dispositivos que los usuarios pueden cambiar.
Requisitos y recomendaciones
Aunque estos parámetros no son obligatorios para publicar anuncios en ninguna implementación específica, sí lo son para la monetización programática en las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
En las implementaciones web, no se utilizan identificadores de dispositivo que se pueden cambiar.
Uso de SDK
Aunque el SDK de IMA envía este campo automáticamente, los editores transfieren estos parámetros manualmente cuando usan el SDK de PAL.
Descripción
El parámetro de última posición en el pod de anuncios (lip) acepta un valor constante para indicar una solicitud de la última posición de un pod de anuncios para la segmentación o la generación de informes.
Nota: Este parámetro no se aplica a los pods de anuncios optimizados y se ignora si se utiliza.
Ejemplos de uso
lip=1
Descripción
El parámetro de anuncios limitados (ltd) acepta un valor constante que indica si se sirven anuncios de manera limitada si no tienen el consentimiento de los usuarios para utilizar cookies u otros identificadores locales.
Este parámetro se utiliza para indicar una solicitud de anuncios limitados y es diferente del parámetro is_lat. Inhabilite la personalización y el uso de identificadores si es ese su objetivo.
ltd=1, cambiará el comportamiento del SDK de IMA para tratar la solicitud como si no tuviera ID y para no permitir el almacenamiento.Ejemplos de uso
ltd=1
Descripción
El parámetro de duración mínima del anuncio (min_ad_duration) y el parámetro de duración máxima del anuncio (max_ad_duration) aceptan valores variables que, en conjunto, especifican en milisegundos el intervalo de duración al que se debe adaptar un anuncio.
Estos parámetros se pueden usar para restringir las creatividades a la duración requerida en la etiqueta de anuncio de los anuncios individuales o en las solicitudes de pods de anuncios optimizados.
Ejemplos de uso
min_ad_duration=15000&max_ad_duration=30000
Descripción
El parámetro de duración mínima del anuncio (min_ad_duration) y el parámetro de duración máxima del anuncio (max_ad_duration) aceptan valores variables que, en conjunto, especifican en milisegundos el intervalo de duración al que se debe adaptar un anuncio.
Estos parámetros se pueden usar para restringir las creatividades a la duración requerida en la etiqueta de anuncio de los anuncios individuales o en las solicitudes de pods de anuncios optimizados.
Ejemplos de uso
min_ad_duration=15000&max_ad_duration=30000
Descripción
El parámetro de número de mid-roll (mridx) acepta un valor variable que indica el número ordinal de la posición mid-roll (por ejemplo, mid-roll 1, mid-roll 2, etc.).
Ejemplos de uso
mridx=2
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación o tipo de transacción específicos, es necesario para orientar los anuncios a un mid-roll concreto, generar informes sobre el mid-roll y hacer predicciones sobre el mid-roll.
Descripción
El parámetro "no fallback" (nofb) acepta un valor constante para indicar que la solicitud de anuncio no debe devolver una lista de reproducción de anuncios de vídeo de respaldo.
Ejemplos de uso
Respaldo inhabilitado:
nofb=1
Puede inhabilitar el respaldo de anuncio único y el bufé de anuncios de pods de anuncios optimizados en cada solicitud de anuncio enviando nofb=1.
Descripción
El parámetro de anuncios no personalizados (npa) acepta un valor constante para indicar que la solicitud de anuncio debe tratarse como no personalizada.
Debe definir específicamente npa=1 o incluir simplemente npa (sin un valor definido) para etiquetar una solicitud como no personalizada. Las solicitudes de anuncios que no tengan este parámetro o que lo tengan definido como npa=0 de forma predeterminada se tratan como solicitudes de anuncios personalizados.
Ejemplos de uso
Anuncios no personalizados:
npa=1
Requisitos y recomendaciones
Este parámetro solo es obligatorio si el usuario inhabilita la personalización. Los editores deben asegurarse de que representan el estado preciso del usuario cuando controlan el estado.
Descripción
El parámetro de emplazamiento de OTT (ott_placement) acepta un valor constante que indica una solicitud de emplazamiento de OTT que no es in-stream.
Definiciones de emplazamientos de los ejemplos siguientes:
- Pausa: formato out-stream que aparece superpuesto sobre el contenido del vídeo cuando un usuario pausa la reproducción del contenido.
- Pantalla de inicio: anuncio que aparece en la pantalla de inicio de un dispositivo CTV o de una aplicación OTT. Esto incluye las implementaciones de masthead, banner y tile en una pantalla de inicio.
- Imagen en imagen: anuncio de vídeo in-stream que se reproduce en un reproductor de vídeo de anuncio independiente junto al contenido de vídeo. Por lo general, se requiere comprimir el contenido del vídeo y cargar un segundo reproductor de vídeo.
- L-banner: anuncio de display in-stream que comprime el contenido de vídeo y crea un anuncio alrededor del vídeo. Normalmente, aunque no se limita a ello, un recuadro de contenido publicitario en forma de L.
- Superposición: cualquier formato de anuncio in-stream que aparezca encima del contenido de vídeo, pero que no ocupe toda la pantalla. Puede ser un anuncio de display o de vídeo.
Ejemplos de uso
Formatos admitidos y sus valores correspondientes:
Pausa:
ott_placement=1
Pantalla de inicio:
ott_placement=2
Imagen en imagen:
ott_placement=3
L-banner:
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, aplicaciones móviles y TV conectada en el caso de los editores que moneticen emplazamientos no estándar en entornos de streaming OTT.
Descripción
En el caso de las integraciones que usan la biblioteca de acceso programático (PAL), el parámetro de nonce de vídeo acepta un valor de cadena variable.
El nonce es seguro para las URLs, por lo que no es necesario codificarlo como URL.
Nota: Si ya ha proporcionado un nonce con el parámetro antiguo paln, le recomendamos que migre al parámetro givn y deje de enviar paln. No incluya ambos parámetros.
Ejemplos de uso
Puede consultar más información sobre el valor que se envía a este parámetro en las guías para empezar a usar PAL.
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, se recomienda para la monetización programática en web, aplicaciones móviles, televisión conectada, audio y medios digitales exteriores.
Descripción
El parámetro de número máximo de anuncios del pod (pmad) acepta un valor variable que indica el número máximo de anuncios en un pod de anuncios.
Este parámetro limita el número total de anuncios de un pod de anuncios optimizado, que es una función disponible para los editores que tienen un paquete de vídeo avanzado.
Este parámetro no debería usarse con VMAP si contiene ad_rule=1.
Ejemplos de uso
pmad=4
Descripción
El parámetro de duración mínima del grupo de anuncios (pmnd) y el parámetro de duración máxima del grupo de anuncios (pmxd) aceptan valores variables que, en conjunto, especifican en milisegundos el intervalo de duración al que se debe adaptar un grupo de anuncios.
Estos parámetros se utilizan para solicitar varios anuncios en un pod de anuncios optimizado, que es una función disponible para los editores que tienen un paquete de vídeo avanzado. Cuando se usan reglas de anuncios, Google Ad Manager añade automáticamente esta información.
Este parámetro no debería usarse con VMAP si contiene ad_rule=1.
Ejemplos de uso
pmnd=0&pmxd=60000
Descripción
El parámetro de duración mínima del grupo de anuncios (pmnd) y el parámetro de duración máxima del grupo de anuncios (pmxd) aceptan valores variables que, en conjunto, especifican en milisegundos el intervalo de duración al que se debe adaptar un grupo de anuncios.
Estos parámetros se utilizan para solicitar varios anuncios en un pod de anuncios optimizado, que es una función disponible para los editores que tienen un paquete de vídeo avanzado. Cuando se usan reglas de anuncios, Google Ad Manager añade automáticamente esta información.
Este parámetro no debería usarse con VMAP si contiene ad_rule=1.
Ejemplos de uso
pmnd=0&pmxd=60000
Descripción
El parámetro de tiempo máximo de visualización forzada del pod de anuncios (pmxfwt) acepta un valor variable que especifica la duración máxima no saltable de un pod de anuncios en milisegundos.
Si admite pods de anuncios con una combinación de anuncios de vídeo saltables y no saltables y quiere limitar la cantidad de tiempo que los usuarios ven anuncios, utilice este parámetro para definir el tiempo máximo de anuncio no saltable que un usuario debe ver.
Nota: El parámetro de duración máxima del pod de anuncios (pmxd) reemplaza a este parámetro a la hora de definir la duración total máxima del pod de anuncios (incluida la duración completa de los anuncios saltables).
Ejemplo de uso
pmxfwt=30000
Descripción
El parámetro número de pods de anuncios (pod) acepta un valor variable que representa el número ordinal del pod de anuncios en un vídeo (por ejemplo, pod de anuncios 1, pod de anuncios 2, etc.).
Ejemplos de uso
pod=3
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación o tipo de transacción específicos, es necesario para permitir que el mismo anuncio se sirva en diferentes pods de anuncios y para usar correctamente las exclusiones de competencia, la limitación de frecuencia y otras funciones relacionadas.
Descripción
El parámetro de perfil de creatividad (pp) acepta un valor variable que controla qué creatividades pueden servirse en función de la configuración definida en un perfil de creatividad de vídeo y audio.
Ejemplos de uso
pp=creative_profile
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación específica, es necesario para restringir los archivos multimedia de las creatividades alojadas en Google Ad Manager que tengan perfiles de creatividades de vídeo y de audio. En el caso de las redirecciones o los anuncios programáticos, se utiliza para comprobar que el requisito está disponible, pero no restringe los archivos multimedia a los seleccionados en el perfil de creatividad.
Descripción
El parámetro de tratamiento de privacidad del editor (ppt) acepta un valor constante que se utiliza para indicar si se debe desactivar la personalización de anuncios en la solicitud de anuncio.
Este parámetro permite aplicar anuncios no personalizados que pueden ser diferentes de npa=1 y rdp=1. Afecta tanto a las reservas como a la demanda programática.
Consulta más información sobre el tratamiento de privacidad del editor.
Ejemplos de uso
Desactivar la personalización de anuncios:
ppt=1
Descripción
El parámetro de identificador proporcionado por el editor (ppid) acepta un valor variable del identificador que se utiliza en la limitación de frecuencia, la orientación y segmentación de audiencia, la rotación de anuncios secuenciales y otros controles de publicación de anuncios basados en la audiencia a través de los dispositivos.
Más información sobre los identificadores proporcionados por el editor
Ejemplos de uso
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ningún tipo de implementación o transacción específico, se debe usar un identificador coherente y que no dependa de la plataforma. Se puede usar cuando no haya otros identificadores y se pueda proporcionar a los compradores.
Descripción
El parámetro de posición en el pod de anuncios (ppos) acepta un valor variable que representa la posición dentro de un pod de anuncios (por ejemplo, posición 1, posición 2, etc.).
Este parámetro solo se utiliza en grupos de anuncios estándar y es necesario para que se rellenen automáticamente con anuncios complementarios. Cuando se usan reglas de anuncios, Google Ad Manager añade automáticamente esta información.
Ejemplos de uso
ppos=2
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ningún tipo de implementación o transacción específicos, es necesario para los pods de anuncios estándar cuando se necesita la segmentación por posición, así como para las previsiones y los informes sobre pods de anuncios estándar. También es necesario para usar correctamente las exclusiones de competencia, la limitación de frecuencia y otras funciones relacionadas.
Descripción
El parámetro JSON de señales proporcionadas por el editor (ppsj) acepta un valor variable, que es un objeto JSON codificado en base64 que contiene datos de audiencia y contextuales proporcionados por el editor para mejorar la monetización programática.
Este parámetro se puede usar para enviar determinadas señales a los compradores o postores.
Consulte más información sobre las señales proporcionadas por el editor y las taxonomías admitidas.
Ejemplos de uso
Objeto JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Aplicar valor codificado en base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Consulte información detallada sobre los pares clave-valor JSON válidos en el
ejemplo del SDK de IMA para HTML5.
Descripción
El parámetro de ID de plantilla de pausa publicitaria (ptpl) y el parámetro de nombre (ptpln) aceptan valores variables que se utilizan para indicar qué plantilla de pausa publicitaria se debe aplicar a la solicitud de pod de anuncios optimizado.
Las plantillas de pausa publicitaria le permiten configurar qué espacios publicitarios, personalizados o no, deberían incluirse en una pausa publicitaria y en qué orden deben servirse.
Solo se necesita uno de estos parámetros para solicitar una plantilla de pausa publicitaria.
Requisitos y recomendaciones
Estos parámetros solo son obligatorios si solicita directamente una plantilla de pausa publicitaria.
Descripción
El parámetro de ID de plantilla de pausa publicitaria (ptpl) y el parámetro de nombre (ptpln) aceptan valores variables que se utilizan para indicar qué plantilla de pausa publicitaria se debe aplicar a la solicitud de pod de anuncios optimizado.
Las plantillas de pausa publicitaria le permiten configurar qué espacios publicitarios, personalizados o no, deberían incluirse en una pausa publicitaria y en qué orden deben servirse.
Solo se necesita uno de estos parámetros para solicitar una plantilla de pausa publicitaria.
Requisitos y recomendaciones
Estos parámetros solo son obligatorios si solicita directamente una plantilla de pausa publicitaria.
Descripción
El parámetro de precio mínimo público de Ad Exchange (pubf) y el parámetro de precio mínimo privado de Ad Exchange (pvtf) aceptan valores de variable que se usan para añadir precios mínimos a etiquetas de Ad Exchange.
Estos parámetros son el equivalente de google_ad_public_floor y google_ad_private_floor.
Ejemplos de uso
Precio mínimo público:
pubf=123
Precio mínimo privado:
pvtf=123
Requisitos y recomendaciones
Estos parámetros solo están disponibles para los editores del Espacio Económico Europeo (EEE) o Suiza que tengan la aprobación para usar la función "Precio mínimo".
Consulte cómo enviar una solicitud.
Descripción
El parámetro de ID de conjunto de aplicaciones (pvid) acepta un valor variable que es el ID de conjunto de aplicaciones Android, mientras que el parámetro de alcance de conjunto de aplicaciones (pvid_s) acepta un valor constante que representa el alcance del ID de conjunto de aplicaciones (scope_app o scope_developer).
Consulte la documentación de Android sobre cómo obtener el ID del conjunto de aplicaciones.
Ejemplos de uso
pvid=[AppSetID_value]
pvid_s=scope_app
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación específica, se recomienda para la monetización programática en aplicaciones móviles en dispositivos Android.
Uso del SDK
Aunque el SDK de IMA/PAL transmite automáticamente este campo, los editores que tienen implementaciones que no sean de SDK deben llamar al SDK del conjunto de aplicaciones y transferir estos parámetros manualmente en la solicitud de anuncio.
Descripción
El parámetro de ID de conjunto de aplicaciones (pvid) acepta un valor variable que es el ID de conjunto de aplicaciones Android, mientras que el parámetro de alcance de conjunto de aplicaciones (pvid_s) acepta un valor constante que representa el alcance del ID de conjunto de aplicaciones (scope_app o scope_developer).
Consulte la documentación de Android sobre cómo obtener el ID del conjunto de aplicaciones.
Ejemplos de uso
pvid=[AppSetID_value]
pvid_s=scope_app
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios en ninguna implementación específica, se recomienda para la monetización programática en aplicaciones móviles en dispositivos Android.
Uso del SDK
Aunque el SDK de IMA/PAL transmite automáticamente este campo, los editores que tienen implementaciones que no sean de SDK deben llamar al SDK del conjunto de aplicaciones y transferir estos parámetros manualmente en la solicitud de anuncio.
Descripción
El parámetro de precio mínimo público de Ad Exchange (pubf) y el parámetro de precio mínimo privado de Ad Exchange (pvtf) aceptan valores de variable que se usan para añadir precios mínimos a etiquetas de Ad Exchange.
Estos parámetros son el equivalente de google_ad_public_floor y google_ad_private_floor.
Ejemplos de uso
Precio mínimo público:
pubf=123
Precio mínimo privado:
pvtf=123
Requisitos y recomendaciones
Estos parámetros solo están disponibles para los editores del Espacio Económico Europeo (EEE) o Suiza que tengan la aprobación para usar la función "Precio mínimo".
Consulte cómo enviar una solicitud.
Descripción
El parámetro de restricción del tratamiento de datos (rdp) acepta un valor constante para indicar que la solicitud de anuncio debe restringir el tratamiento de datos.
Para restringir el tratamiento de datos a nivel de red, habilite la opción Restringir el tratamiento de datos en la configuración de la red.
Ejemplos de uso
Restringir el tratamiento de datos:
rdp=1 o rdp (sin asignarle ningún valor)
No restringir el tratamiento de datos:
rdp=0
Descripción
El parámetro de cadena de suministro (schain) acepta un valor variable que debe ser un objeto SupplyChain serializado. Cuando se incluye este parámetro, Google agrega un nodo a los objetos schain recibidos antes de enviarlos a los compradores.
Consulte la documentación completa de IAB para comunicar la información de SupplyChain a través de una etiqueta (en lugar de OpenRTB).
.Según la documentación de IAB, a continuación se define la serialización del objeto SupplyChain:
- Las propiedades de
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjectySupplyChainNodeestán delimitadas por comas, de modo que pueden omitirse los campos opcionales y excluirse opcionalmente los separadores por comas. - Cada elemento
SupplyChainNodeestá separado por un "!". - Si el valor de una propiedad contiene caracteres que requieren codificación de URL (por ejemplo,
,o!), el valor debe estar codificado como URL antes de la serialización.
Orden de serialización
Las propiedades de SupplyChainObject se serializan en este orden:
ver,complete
Las propiedades de SupplyChainNode se serializan en este orden:
asi,sid,hp,rid,name,domain,ext
ext es específico de cada exchange. Google Ad Manager no analiza esta propiedad.Ejemplos de cómo serializar el objeto SupplyChain
A continuación se muestran dos ejemplos de cómo serializar el objeto SupplyChain anterior:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Ejemplos de uso
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Si el valor de asi fuera exchange,1, la serialización con caracteres escape sería la siguiente:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específico, sí lo es para los editores que utilicen intermediarios de pagos antes de la solicitud a Google Ad Manager. Esto incluye a los editores que utilizan tecnología de servidores de anuncios externos.
Descripción
El parámetro de correlacionador de emisión (scor) acepta un valor variable que debe ser un número entero generado para cada stream de vídeo.
No es necesario que los parámetros score y correlator tengan el mismo valor entero. Sin embargo, deben conservar sus respectivos valores durante cada reproducción de stream de vídeo para identificar una sesión de visualización única.
Ejemplos de uso
scor=17
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específicos, se recomienda para el servicio de anuncios en la Web, las aplicaciones móviles, las televisiones conectadas, el audio y la publicidad digital exterior.
Este parámetro se utiliza para exclusiones de competencia, limitación de frecuencia y funciones relacionadas cuando un usuario está viendo varios vídeos en la misma página.
Descripción
El parámetro de framework de la API del SDK (sdk_apis) acepta una lista separada por comas de valores enteros constantes, que indican todos los frameworks de la API compatibles con el reproductor.
Requisitos y recomendaciones
Uso de SDK
Este parámetro lo utilizan los editores que usan la biblioteca de acceso programático (PAL). Si intenta asignar valores a este parámetro mientras usa el SDK de IMA, los valores se sustituirán por los que admite el SDK de IMA.
Descripción
El parámetro de duración máxima de anuncio saltable (sdmax) acepta un valor variable que permite a los editores elegir la duración máxima que quieran para los anuncios saltables.
Obtiene la duración en milisegundos que representa el límite superior que se debe permitir para las creatividades de vídeo y audio saltables de esa solicitud de anuncio concreta.
Utilice sdmax de manera independiente para los anuncios saltables o en combinación con el parámetro max_ad_duration que ya tenga para proporcionar duraciones máximas diferentes para anuncios saltables y no saltables.
Ejemplos de uso
Con la siguiente configuración:
max_ad_duration= 15000 (15 segundos)sdmax= 45000 (45 segundos)
Para las siguientes creatividades:
- Creatividad A: no saltable; 30 s
- Creatividad B: saltable; 30 s
Resultados:
- Se excluirá la creatividad A porque no se puede saltar y su duración supera el máximo permitido para anuncios no saltables.
- La creatividad B no se excluirá porque, aunque su duración supere el valor de
max_ad_duration, se puede saltar y su duración no supera el valor máximo de anuncios saltables.
Descripción
El parámetro de fuente de unión del lado del servidor (ssss) acepta un valor constante, que debe ser un valor reconocido y proporcionado por Google correspondiente al proveedor de tecnología de unión de vídeo que utilice.
Los proveedores de tecnología de unión de vídeo que han integrado sus servidores con los de Google reciben este valor directamente de Google, por lo que pueden facilitárselo. Si tiene alguna pregunta sobre el valor que darle a este parámetro, póngase en contacto con su gestor de cuentas de Google.
Ejemplos de uso
ssss=mystitcher
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para servir anuncios a ninguna implementación o tipo de transacción específico, es necesario para usar implementaciones del lado del servidor.
Descripción
El parámetro de contenido dirigido a niños (tfcd) acepta un valor constante que indica que la solicitud debe tratarse como contenido dirigido a niños.
Ejemplos de uso
tfcd=1
Descripción
El parámetro de tipo de tráfico (trt) acepta un valor constante que funciona para solicitar tráfico orgánico o comprado.
Ejemplos de uso
Solicitud de tráfico comprado:
trt=1
Solicitud de tráfico orgánico:
trt=2
Requisitos y recomendaciones
Uso de SDK
El SDK de IMA no rellena un valor predeterminado si falta ese parámetro en una solicitud. En estos casos, el servidor proporciona el valor predeterminado 0 (tráfico sin definir).
Descripción
IAB ha dejado de admitir la cadenaus_national para utilizar GPP. Sin embargo, Ad Manager sigue leyendo y respetando la cadena si se transfiere para mantener la compatibilidad con versiones anteriores. Se recomienda que los editores revisen el GPP u otros controles de privacidad y migren de us_national.
Descripción
El parámetro de tipo de anuncio de vídeo (vad_type) acepta un valor constante que indica si se debe devolver un anuncio lineal o no lineal.
Ejemplos de uso
Devolver un anuncio lineal:
vad_type=linear
Devolver un anuncio no lineal:
vad_type=nonlinear
Descripción
Los parámetros de ID de fuente de contenido (cmsid) y de ID de vídeo (vid) aceptan valores variables.
Para orientar anuncios a contenido de vídeo, su etiqueta maestra de vídeo debe incluir ambos parámetros.
- El
cmsides el número único de una fuente de contenido. Puede verlo en Ad Manager si hace clic en Vídeo, luego en Fuentes de contenido y, a continuación, en el nombre de la fuente. - El parámetro
vides una cadena o un número que identifica un determinado vídeo. El CMS que aloja su contenido asigna este ID. Puede verlo en Ad Manager si hace clic en Vídeo, luego en Contenido y, a continuación, en el contenido de vídeo concreto.
Ejemplos de uso
cmsid=[value]&vid=[value]
Si va a crear una etiqueta para utilizarla en la inserción dinámica de anuncios con vídeos bajo demanda, debe utilizar las macros que insertan dinámicamente la fuente del contenido y el ID de vídeo correctos.
Por ejemplo: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisitos y recomendaciones
Aunque estos parámetros no son obligatorios para publicar anuncios en ninguna implementación o tipo de transacción específicos, sí son necesarios para usar la segmentación por contenido de vídeo.
Descripción
El parámetro de lista de reproducción de vídeo insertada (vpi) acepta un valor constante que indica si se sirve VMAP insertado (se devuelve VAST dentro de VMAP).
Este parámetro se puede utilizar para reducir la latencia y que se respeten los límites de frecuencia y las exclusiones de competencia en un stream de vídeo.
Ejemplos de uso
Devolver VAST:
vpi=1
Devolver redirecciones:
vpi=0