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 quieres obtener más información sobre un parámetro específico.
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
- Otros parámetros
Listas de parámetros por tipo de implementación
Si usas una implementación específica, puedes usar listas de parámetros personalizados que describan el uso y los requisitos de esa implementación. Usa la lista de parámetros personalizados para lo siguiente:
Web Aplicación para dispositivos móviles TV conectada Audio Publicidad exterior digital
Todos los parámetros
Parámetros obligatorios para la publicación de anuncios
En general, estos parámetros son obligatorios para la publicación de anuncios en la mayoría de las implementaciones. Sin embargo, es posible que haya casos en los que no sean obligatorios. Para obtener la lista más precisa, usa la lista de parámetros para tu tipo de implementación específico.
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.
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 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 tipo de lugar (venuetype) se usa para indicar el tipo de lugar de espacios públicos. Los valores elegibles son los IDs de enumeración de enteros compatibles con la taxonomía 1.1 de tipo de lugar de OpenOOH de IAB.
Ejemplos de uso
Habitaciones de hotel:
venuetype=80703
Tablet en el asiento trasero 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 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).
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
Los parámetros de ID de la aplicación (msid) y de nombre de la aplicación (an) admiten valores variables que se deben aplicar a las solicitudes que se envían desde aplicaciones para dispositivos móviles y dispositivos de TV conectada, ya que son necesarios para la mayoría de los anuncios programáticos de video.
Si bien el nombre de la app debe ser legible por humanos, en iOS y tvOS, el SDK no puede acceder al ID de la app. En estos casos, no se envía el parámetro msid, y el SDK envía el paquete de aplicación con el parámetro an.
Ejemplos de uso
msid=com.package.publisher&an=sample%20app
Los IDs de apps tienen distintos nombres y formatos en función de las diferentes tiendas de aplicaciones. Consulta los lineamientos de la IAB para la identificación de apps o ejemplos de identificadores únicos comunes.
En el caso de las plataformas en las que no exista una tienda de aplicaciones, la IAB recomienda a los publicadores usar el siguiente formato para los IDs de tiendas: com.publisher.deviceplatform.
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 apps para dispositivos móviles, TV conectadas, audio y publicidad digital exterior.
Para garantizar la seguridad de la marca y ofrecer más transparencia a los compradores, se recomienda incluir la información de la app.
Uso del SDK
El SDK de IMA los propagará automáticamente, pero deben especificarse de forma manual en entornos que no pertenezcan al SDK, incluidas las llamadas directas de VAST, o cuando se use la Biblioteca de acceso programático (PAL) o el Inventario autenticado por el publicador (PAI).
Nota: Si se usa el SDK de IMA para HTML5, no se usa la información de la app.
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
Los parámetros de ID de la aplicación (msid) y de nombre de la aplicación (an) admiten valores variables que se deben aplicar a las solicitudes que se envían desde aplicaciones para dispositivos móviles y dispositivos de TV conectada, ya que son necesarios para la mayoría de los anuncios programáticos de video.
Si bien el nombre de la app debe ser legible por humanos, en iOS y tvOS, el SDK no puede acceder al ID de la app. En estos casos, no se envía el parámetro msid, y el SDK envía el paquete de aplicación con el parámetro an.
Ejemplos de uso
msid=com.package.publisher&an=sample%20app
Los IDs de apps tienen distintos nombres y formatos en función de las diferentes tiendas de aplicaciones. Consulta los lineamientos de la IAB para la identificación de apps o ejemplos de identificadores únicos comunes.
En el caso de las plataformas en las que no exista una tienda de aplicaciones, la IAB recomienda a los publicadores usar el siguiente formato para los IDs de tiendas: com.publisher.deviceplatform.
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 apps para dispositivos móviles, TV conectadas, audio y publicidad digital exterior.
Para garantizar la seguridad de la marca y ofrecer más transparencia a los compradores, se recomienda incluir la información de la app.
Uso del SDK
El SDK de IMA los propagará automáticamente, pero deben especificarse de forma manual en entornos que no pertenezcan al SDK, incluidas las llamadas directas de VAST, o cuando se use la Biblioteca de acceso programático (PAL) o el Inventario autenticado por el publicador (PAI).
Nota: Si se usa el SDK de IMA para HTML5, no se usa la información de la app.
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
Los parámetros de identificadores de dispositivos que se pueden restablecer (rdid, idtype, is_lat) admiten valores variables, también conocidos como identificadores de publicidad (IFA).
En el caso de las apps para dispositivos móviles que usan el SDK de IMA para Android o iOS, el SDK de IMA pasa a tus solicitudes de transmisión identificadores de dispositivos que se pueden restablecer para la segmentación de usuarios con los parámetros rdid, idtype y is_lat.
Cuando no se utiliza el SDK de IMA o cuando se hace uso de píxeles contadores del servidor (SSB), debes pasar estos valores como parámetros explícitos. Obtén más información acerca de los identificadores de dispositivos.
Casi todos los anuncios de la publicidad programática de video requieren que estos valores estén presentes.
|
A partir de iOS 14.5, Apple dio de baja el indicador |
Ejemplos de uso
Mira ejemplos detallados de identificadores de dispositivos que se pueden restablecer.
Requisitos y recomendaciones
Si bien estos parámetros no son obligatorios para publicar anuncios en ninguna implementación específica, son necesarios para la monetización programática en apps para dispositivos móviles, TVs conectadas, audio y publicidad digital exterior.
En las implementaciones web, no se usan identificadores de dispositivos que se pueden restablecer.
Uso del SDK
Si bien el SDK de IMA pasa este campo de manera automática, los publicadores pasan los parámetros en cuestión de forma manual cuando usan el SDK de PAL.
Descripción
El parámetro de ID de sesión (sid) admite un valor variable; es un identificador de publicidad que preserva la privacidad y se puede usar solo con fines de limitación de frecuencia.
El ID de sesión es compatible con las solicitudes de video in-stream de TVs conectadas y se admite en el inventario de video in-stream de dispositivos con apps para dispositivos móviles. Por el momento, no es compatible con el formato web.
Para inhabilitar la opción de pasar el ID de sesión, establece sid=0.
Ejemplos de uso
sid=123e4567-e89b-12d3-a456-426614174000
Según los lineamientos de IFA de IAB, este parámetro debe completarse en formato UUID. Obtén más información acerca de los identificadores de dispositivos que se pueden restablecer para la segmentación de usuarios.
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, es necesario para la monetización programática en publicidad digital exterior.
Se recomienda este parámetro para la monetización programática en apps para dispositivos móviles, TVs conectadas y audio.
Uso del SDK
El SDK de IMA envía este parámetro 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.Otros parámetros
En general, estos parámetros no son obligatorios de forma explícita para publicar anuncios, pero pueden ser necesarios para usar ciertas funciones o para determinados tipos de implementación.
Descripción
El parámetro de regla de anuncios (ad_rule) admite un valor constante que indica si se debe mostrar una creatividad de VAST o una respuesta de reglas de anuncios.
La configuración predeterminada de las reglas de anuncios depende de un parámetro de configuración 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 establecer ad_rule en la etiqueta del anuncio. Si deseas inhabilitar la función por solicitud de anuncio, puedes pasar ad_rule=0 para anular la configuración de red. Además, si no tienes las reglas de anuncios activadas de forma predeterminada, puedes habilitarlas o inhabilitarlas pasando ad_rule=1 y ad_rule=0, respectivamente.
Ejemplos de uso
Si la configuración de reglas de anuncios está inhabilitada, ocurrirá lo siguiente:
- Solicitud de creatividad de VAST:
ad_rule=0o no configurarla
Si el parámetro de configuración de reglas de anuncios está habilitado, haz lo siguiente:
- Solicitud de creatividad de VAST:
ad_rule=0 - Solicitud de reglas de anuncios (VMAP):
ad_rule=1o no configurarla
Si decides no utilizar reglas de anuncios, puedes usar los parámetros de la etiqueta de anuncio para indicar la duración de la pausa publicitaria y del grupo de anuncios de tus etiquetas de VAST con pmnd, pmxd y pmad.
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios para ningún tipo de implementación específica, es necesario para usar correctamente las reglas de anuncios de video.
Descripción
El parámetro de consentimiento adicional (addtl_consent) acepta valores variables, y lo utilizan los publicadores que desean realizar la integración con el MTC v2.0 de IAB y usar un proveedor que aún no esté registrado en la Lista de proveedores globales de IAB Europe, pero que sí figure en la lista de proveedores de tecnología publicitaria (ATP) de Google.
Puede obtener más información sobre los valores que se pasan a este parámetro en la especificación técnica del Modo de consentimiento adicional.
Ejemplo de uso
addtl_consent=1~1.35.41.101
Descripción
Se debe usar el parámetro de prueba (adtest) de anuncios para garantizar que las consultas que se utilizan para probar el inventario de reabastecimiento (no garantizado) no se identifiquen como tráfico no válido y no tengan un impacto en los ingresos.
Cuando pruebes el reabastecimiento, establece este parámetro en on para asegurarte de que ningún anuncio registre impresiones ni clics para su uso durante las pruebas. Se establece como off en entornos que no son de prueba para facturar de forma normal. Si no se configura, el valor predeterminado de este parámetro es off.
Nota: Cuando pruebes las líneas de pedido de venta directa, debes usar líneas de pedido de prueba sin un impacto en 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 anuncios que se deben devolver para la solicitud.
Cuando ad_type se establece en audio o audio_video, el parámetro vpmute se debe configurar en 0
Ejemplos de uso
Solo permite anuncios de audio:
ad_type=audio
Permite anuncios de video que se pueden y que no se pueden omitir:
ad_type=video
Permite anuncios de audio y de video:
ad_type=audio_video
Este valor de
audio_videopermite que compitan ambos formatos, pero solo se publica uno. Su finalidad es usarse solo para publicar creatividades de video en contenido de audio compatible con la reproducción de anuncios de video o creatividades de audio en reproductores de video in-stream para contenido que, por su naturaleza, "se puede escuchar", como transmisiones deportivas, videocasts, noticias, etc. Obtén información sobre el contenido de audio en video.
Solo permite anuncios de video que se pueden omitir:
ad_type=skippablevideo
Solo permite anuncios de video que no se pueden omitir:
ad_type=standardvideo
Requisitos y recomendaciones
- Si tu app tiene contenido de video, establece este parámetro en
video,audio_videoo déjalo sin definir. - Si tu app solo tiene contenido de audio (por ejemplo, una app de radio o de voz), debes establecer este parámetro como
audio. Si no lo estableces, no se mostrarán anuncios de audio.
Descripción
El parámetro de tamaños de anuncios no lineales (afvsz) admite valores constantes presentados en una lista separada por comas de tamaños de anuncios no lineales que se puedan mostrar en el espacio publicitario de anuncios de video.
Estos tamaños deben ser cualquiera de los siguientes:
200 x 200250 x 250300 x 250336 x 280450 x 50468 x 60480 x 90729 x 90
Cuando se usa el SDK de IMA, este campo se reemplaza y propaga con todos los tamaños compatibles que se encuentran dentro de los valores de nonLinearAdSlotWidth y nonLinearAdSlotHeight.
Este parámetro puede omitirse o quedar vacío si no se admiten tamaños no lineales.
Ejemplos de uso
Se admiten todos los tamaños:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
El ancho máximo es de 250:
afvsz=200x200,250x250
La altura máxima es de 60:
afvsz=450x50,468x60
El ancho máximo es de 100:
//empty; no values supported
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específica, es obligatorio para publicar anuncios de video no lineales cuando no se usa el SDK de IMA.
Descripción
El parámetro de todos los puntos de inserción (allcues) acepta valores variables que son una lista separada por comas de puntos de inserción, en milisegundos. Para cada valor, Google Ad Manager muestra una pausa publicitaria.
- Los parámetros
vid_dyallcuesse usan para publicar anuncios durante el video sin transferencia de contenido. - También se requieren reglas de anuncios para mostrar anuncios durante el video. Si se usan inserciones basadas en el tiempo en las reglas de anuncios (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
Puntos de inserción a los 10 y 20 segundos:
allcues=10000,20000
Descripción
El parámetro de tamaños complementarios (ciu_szs) acepta valores variables que son una lista de tamaños complementarios separados por comas.
Los valores separados por barras verticales (|) indican 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 del ID de la fuente del contenido (cmsid) y del ID de video (vid) aceptan valores variables.
Si deseas segmentar anuncios para contenido de video, tu etiqueta de video principal debe incluir ambos parámetros.
- El valor
cmsides un número único para cada fuente del contenido. Para encontrar esto en Google Ad Manager, haz clic en Video, luego, en Fuentes de contenido y, luego, en el nombre de la fuente. - El valor
vides una string o un número que identifica un video específico. El CMS que aloja su contenido asigna este ID. Para encontrar esto en Google Ad Manager, haz clic en Video, luego en Contenido y, luego, en el contenido de video específico.
Ejemplos de uso
cmsid=[value]&vid=[value]
Si quieres crear una etiqueta para video on demand con la inserción de anuncios dinámicos, debes usar las macros que insertarán de forma dinámica el ID de video y la fuente del contenido correctos.
Por ejemplo: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisitos y recomendaciones
Si bien estos parámetros no son obligatorios para publicar anuncios en ninguna implementación o tipo de transacción específica, sí lo son para usar la segmentación por contenido de video.
Descripción
Los parámetros personalizados (cust_params) admiten valores variables presentados como pares clave-valor que te permiten establecer una segmentación específica, como datos demográficos, ciertas posiciones en una página, o bien una o varias páginas específicas.
Ejemplos de uso
Consulte ejemplos de cómo agregar pares clave-valor.
Descripción
El parámetro de categoría de exclusión (excl_cat) acepta valores variables y se usa para bloquear cualquier línea de pedido que contenga la etiqueta de exclusión en la solicitud de anuncio. Usa el parámetro cust_params para establecer la categoría y las etiquetas de exclusión.
Ejemplos de uso
Para establecer la categoría de exclusión para dos etiquetas de exclusión (airline_excl_label y train_excl_label), usa una barra vertical (|) para separar las etiquetas:
excl_cat=airline_excl_label%7Ctrain_excl_label
Luego, aplica la codificación de URL y usa la cadena codificada en cust_params:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
Descripción
El parámetro del RGPD (gdpr) acepta valores constantes, y lo utilizan los publicadores que desean realizar la integración con el MTC v2.0 de IAB. Las solicitudes directas de VAST no leen los valores automáticamente, pero los aceptan cuando se agregan a etiquetas de anuncios.
Los únicos valores válidos para este parámetro son el 0 y el 1, donde el 0 significa que no se aplica el RGPD y el 1 significa que sí se aplica. Si se aplica el RGPD, también debes proporcionar una cadena de TC válida con el parámetro gdpr_consent.
Puede obtener más información sobre los valores que se pasan a este parámetro en la guía general para implementar el marco de trabajo o en la sección String de TC de la especificación del MTC v2.0 de IAB.
Ejemplos de uso
Se aplica el RGPD:
gdpr=1
No se aplica el RGPD:
gdpr=0
Descripción
El parámetro de consentimiento según el RGPD (gdpr_consent) acepta valores variables, y lo utilizan los publicadores que desean realizar la integración con el MTC v2.0 de IAB. Las solicitudes directas de VAST no leen los valores automáticamente, pero los aceptan cuando se agregan a etiquetas de anuncios.
Puede obtener más información sobre los valores que se pasan a este parámetro en la guía general para implementar el marco de trabajo o en la sección String de TC de la especificación del MTC v2.0 de IAB.
Ejemplos de uso
gdpr_consent=GDPR_CONSENT_123
Descripción
El parámetro de URL de exclusión de la IAB (iabexcl) acepta valores variables, que son una lista de categorías separadas por comas.
Ejemplos de uso
iabexcl=3,14,527 no incluye "Camiones comerciales", "Vehículos todoterreno" ni "Rugby".
Puedes descargar una lista de las categorías de la taxonomía de contenido de IAB y sus IDs.
Descripción
Los parámetros de identificadores de dispositivos que se pueden restablecer (rdid, idtype, is_lat) admiten valores variables, también conocidos como identificadores de publicidad (IFA).
En el caso de las apps para dispositivos móviles que usan el SDK de IMA para Android o iOS, el SDK de IMA pasa a tus solicitudes de transmisión identificadores de dispositivos que se pueden restablecer para la segmentación de usuarios con los parámetros rdid, idtype y is_lat.
Cuando no se utiliza el SDK de IMA o cuando se hace uso de píxeles contadores del servidor (SSB), debes pasar estos valores como parámetros explícitos. Obtén más información acerca de los identificadores de dispositivos.
Casi todos los anuncios de la publicidad programática de video requieren que estos valores estén presentes.
|
A partir de iOS 14.5, Apple dio de baja el indicador |
Ejemplos de uso
Mira ejemplos detallados de identificadores de dispositivos que se pueden restablecer.
Requisitos y recomendaciones
Si bien estos parámetros no son obligatorios para publicar anuncios en ninguna implementación específica, son necesarios para la monetización programática en apps para dispositivos móviles, TVs conectadas, audio y publicidad digital exterior.
En las implementaciones web, no se usan identificadores de dispositivos que se pueden restablecer.
Uso del SDK
Si bien el SDK de IMA pasa este campo de manera automática, los publicadores pasan los parámetros en cuestión de forma manual cuando usan el SDK de PAL.
Descripción
El parámetro de dominio del socio de inventario (ipd) admite valores variables que se deben configurar en las declaraciones inventorypartnerdomain del archivo app-ads.txt (o ads.txt) del publicador.
El parámetro inventorypartnerdomain es una especificación de la IAB que permite a los publicadores designar un dominio de un socio de uso compartido del inventario para fines de la validación de ads.txt/app-ads.txt.
La declaración de IPD es especialmente importante en los casos de uso compartido del inventario en los que el inventario de anuncios en el que se origina una solicitud puede ser propiedad de otro socio (el socio de uso compartido del inventario).
Obtén más información sobre los archivos ads.txt/app-ads.txt y los socios de uso compartido de inventario.
Ejemplos de uso
El parámetroinventorypartnerdomain se encuentra en el archivo app-ads.txt que apunta al archivo .txt del socio 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 publicadores que monetizan inventario que no les pertenece.
Descripción
El parámetro de entidad de pings (ipe) de impresiones admite un valor constante que se usa para indicar conversiones y pings de impresiones que se originan en el servidor, no en el cliente.
La entidad de ping de impresiones se usa cuando un servidor envía pings o píxeles contadores de impresiones desde el servidor.
Ejemplos de uso
Píxeles contadores del servidor (SSB):
ipe=ssb
Descripción
Los parámetros de identificadores de dispositivos que se pueden restablecer (rdid, idtype, is_lat) admiten valores variables, también conocidos como identificadores de publicidad (IFA).
En el caso de las apps para dispositivos móviles que usan el SDK de IMA para Android o iOS, el SDK de IMA pasa a tus solicitudes de transmisión identificadores de dispositivos que se pueden restablecer para la segmentación de usuarios con los parámetros rdid, idtype y is_lat.
Cuando no se utiliza el SDK de IMA o cuando se hace uso de píxeles contadores del servidor (SSB), debes pasar estos valores como parámetros explícitos. Obtén más información acerca de los identificadores de dispositivos.
Casi todos los anuncios de la publicidad programática de video requieren que estos valores estén presentes.
|
A partir de iOS 14.5, Apple dio de baja el indicador |
Ejemplos de uso
Mira ejemplos detallados de identificadores de dispositivos que se pueden restablecer.
Requisitos y recomendaciones
Si bien estos parámetros no son obligatorios para publicar anuncios en ninguna implementación específica, son necesarios para la monetización programática en apps para dispositivos móviles, TVs conectadas, audio y publicidad digital exterior.
En las implementaciones web, no se usan identificadores de dispositivos que se pueden restablecer.
Uso del SDK
Si bien el SDK de IMA pasa este campo de manera automática, los publicadores pasan los parámetros en cuestión de forma manual cuando usan el SDK de PAL.
Descripción
El parámetro de última posición en el grupo de anuncios (lip) admite un valor constante para indicar una solicitud en la última posición dentro de un grupo de anuncios para fines de segmentación o generación de informes.
Nota: Este parámetro no se aplica a los grupos de anuncios optimizados y se ignora si se usa.
Ejemplos de uso
lip=1
Descripción
El parámetro de anuncios limitados (ltd) admite un valor constante que indica si se deben o no publicar anuncios de forma limitada sin recibir consentimiento para el uso de cookies y otros identificadores locales.
Este parámetro se usa para indicar una solicitud de anuncios limitada y es diferente del parámetro is_lat. Inhabilita la personalización y el uso de identificadores para esos fines.
ltd=1 cambia el comportamiento del SDK de IMA para tratar la solicitud como sin ID y para rechazar 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) admiten valores variables que, en conjunto, especifican el rango de duración con el que debe coincidir un anuncio, en milésimas de segundos.
Este parámetro se puede usar para restringir las creatividades a una duración requerida en la etiqueta de anuncio para anuncios individuales o en solicitudes de grupos 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) admiten valores variables que, en conjunto, especifican el rango de duración con el que debe coincidir un anuncio, en milésimas de segundos.
Este parámetro se puede usar para restringir las creatividades a una duración requerida en la etiqueta de anuncio para anuncios individuales o en solicitudes de grupos de anuncios optimizados.
Ejemplos de uso
min_ad_duration=15000&max_ad_duration=30000
Descripción
El parámetro de número de anuncio durante el video (mridx) admite un valor variable que indica el número ordinal del anuncio durante el video (por ejemplo, anuncio durante el video 1, anuncio durante el video 2, etcétera).
Ejemplos de uso
mridx=2
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específicos, es necesario para segmentar un anuncio durante el video específico, generar informes sobre él y realizar previsiones sobre él.
Descripción
El parámetro sin resguardo (nofb) admite un valor constante para indicar que la solicitud de anuncio no debe mostrar una playlist de anuncios de resguardo de video.
Ejemplos de uso
Resguardo inhabilitado:
nofb=1
Se puede pasar nofb=1 para inhabilitar el resguardo de anuncios individuales y el buffet de anuncios de grupos de anuncios optimizados por solicitud de anuncio.
Descripción
El parámetro de anuncios no personalizados (npa) admite un valor constante para indicar que la solicitud de anuncio se debe tratar como no personalizada.
Debe establecer específicamente npa=1 o solo incluir npa (sin un valor establecido) para etiquetar la solicitud como no personalizada. Las solicitudes de anuncios sin este parámetro o definidas con un valor de npa=0 se establecen de manera predeterminada como 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 publicadores deben asegurarse de representar el estado exacto del usuario cuando lo controlan.
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
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 cantidad máxima de anuncios del grupo de anuncios (pmad) admite un valor variable que indica la cantidad máxima de anuncios en un grupo.
Este parámetro limita la cantidad total de anuncios en un grupo de anuncios optimizado, que es una función disponible para los publicadores que cuentan con un paquete de video avanzado.
No se debe usar este parámetro para VMAP (cuando 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) admiten valores variables que, en conjunto, especifican el rango de duración con el que debe coincidir un grupo de anuncios, en milésimas de segundo.
Estos parámetros se usan para solicitar varios anuncios en un grupo de anuncios optimizado, que es una función disponible para los publicadores que tienen un paquete de video avanzado. Cuando se usan las reglas de anuncios, Google Ad Manager agrega automáticamente esta información.
Este parámetro no se debe usar para VMAP (cuando 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) admiten valores variables que, en conjunto, especifican el rango de duración con el que debe coincidir un grupo de anuncios, en milésimas de segundo.
Estos parámetros se usan para solicitar varios anuncios en un grupo de anuncios optimizado, que es una función disponible para los publicadores que tienen un paquete de video avanzado. Cuando se usan las reglas de anuncios, Google Ad Manager agrega automáticamente esta información.
Este parámetro no se debe usar para VMAP (cuando ad_rule=1).
Ejemplos de uso
pmnd=0&pmxd=60000
Descripción
El parámetro de tiempo de reproducción forzado máximo del grupo de anuncios (pmxfwt) acepta un valor variable que especifica la duración máxima de un grupo de anuncios que no se puede omitir, en milisegundos.
Si admites grupos de anuncios con una combinación de anuncios de video que se pueden omitir y que no se pueden omitir, y deseas limitar para los usuarios la cantidad de tiempo que duran los anuncios, usa este parámetro para definir el tiempo máximo que los usuarios deben ver de los anuncios que no se pueden omitir.
Nota: El parámetro de duración máxima del grupo de anuncios (pmxd) reemplaza este parámetro para definir la duración total máxima del grupo de anuncios (incluida la duración total de los anuncios que se pueden omitir).
Ejemplo de uso
pmxfwt=30000
Descripción
El parámetro de número de grupo de anuncios (pod) admite un valor variable que representa el número ordinal del grupo de anuncios en un video (por ejemplo, grupo de anuncios 1, grupo de anuncios 2, etcétera).
Ejemplos de uso
pod=3
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específicos, es necesario para permitir que el mismo anuncio se publique en diferentes grupos de anuncios y para usar correctamente las exclusiones competitivas, la limitación de frecuencia y funciones relacionadas.
Descripción
El parámetro de perfil de creatividades (pp) admite un valor variable que controla las creatividades aptas para publicarse según la configuración definida en un perfil de creatividades de audio y video.
Ejemplos de uso
pp=creative_profile
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación específica, es necesario para restringir los archivos multimedia para las creatividades alojadas en Google Ad Manager con perfiles de creatividades de audio y video. En el caso de los redireccionamientos o los anuncios programáticos, se usa para garantizar que el requisito esté disponible, pero no restringe los archivos multimedia a los seleccionados en el perfil de la creatividad.
Descripción
El parámetro de Tratamiento de Privacidad del Publicador (ppt) admite un valor constante que se usa para indicar si se debe desactivar la personalización de anuncios para la solicitud de anuncio.
Este parámetro proporciona una forma de aplicar anuncios no personalizados de manera forzosa que puede diferir de npa=1 y rdp=1. Afecta tanto a las reservaciones como a la demanda programática.
Obtén más información sobre el Tratamiento de Privacidad del Publicador.
Ejemplos de uso
Desactivar la personalización de anuncios:
ppt=1
Descripción
El parámetro de identificador proporcionado por el publicador (ppid) admite un valor variable y se usa en la limitación de frecuencia, la definición de segmentos y la segmentación por público, la rotación secuencial de anuncios y otros controles de publicación de anuncios basados en el público en todos los dispositivos.
Obtén más información sobre los identificadores proporcionados por el publicador.
Ejemplos de uso
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específicos, es necesario usar un identificador coherente que no dependa de la plataforma. Se puede usar cuando no hay otros identificadores y se puede proporcionar a los compradores.
Descripción
El parámetro de posición en el grupo de anuncios (ppos) admite un valor variable que representa la posición dentro de un grupo de anuncios (por ejemplo, posición 1, posición 2, etcétera).
Este parámetro solo se aplica a grupos de anuncios estándar y es necesario para la opción de autocompletar anuncios complementarios. Cuando se usan reglas de anuncios, Google Ad Manager agrega automáticamente esta información.
Ejemplos de uso
ppos=2
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específicos, es necesario para los grupos de anuncios estándares cuando se necesita realizar la segmentación por posición y para la previsión y la generación de informes sobre los grupos de anuncios estándares. También es necesario para usar correctamente las exclusiones competitivas, la limitación de frecuencia y funciones relacionadas.
Descripción
El parámetro JSON de los indicadores proporcionados por el publicador (ppsj) admite un valor variable que es un objeto JSON codificado en base64 que contiene datos contextuales y de público proporcionados por el publicador para mejorar la monetización programática.
Este parámetro se puede usar para enviar ciertos indicadores a los compradores u ofertantes.
Obtén más información sobre los indicadores proporcionados por el publicador y las taxonomías admitidas.
Ejemplos de uso
Objeto JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Aplicar el valor codificado en base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Consulta los detalles de los pares clave-valor de JSON válidos en la
muestra 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) admiten valores variables que se usan para indicar qué plantilla de pausa publicitaria se debe aplicar a la solicitud de grupo de anuncios optimizado.
Las plantillas de pausa publicitaria le permiten configurar qué espacios publicitarios o espacios publicitarios personalizados deben incluirse en una pausa publicitaria y en qué orden deben publicarse.
Solo se necesita uno de estos parámetros para solicitar una plantilla de pausa publicitaria.
Ejemplos de uso
Obtén más información para configurar y solicitar plantillas de pausas publicitarias.
Requisitos y recomendaciones
Estos parámetros solo son obligatorios si solicitas 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) admiten valores variables que se usan para indicar qué plantilla de pausa publicitaria se debe aplicar a la solicitud de grupo de anuncios optimizado.
Las plantillas de pausa publicitaria le permiten configurar qué espacios publicitarios o espacios publicitarios personalizados deben incluirse en una pausa publicitaria y en qué orden deben publicarse.
Solo se necesita uno de estos parámetros para solicitar una plantilla de pausa publicitaria.
Ejemplos de uso
Obtén más información para configurar y solicitar plantillas de pausas publicitarias.
Requisitos y recomendaciones
Estos parámetros solo son obligatorios si solicitas directamente una plantilla de pausa publicitaria.
Descripción
El parámetro de precio mínimo público para Ad Exchange (pubf) y el parámetro de precio mínimo privado para Ad Exchange (pvtf) admiten valores variables que se usan para agregar precios mínimos a las etiquetas de Ad Exchange.
Estos parámetros son equivalentes a 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 publicadores del Espacio Económico Europeo ("EEE") o Suiza que hayan recibido la aprobación para usar la función "Precio mínimo".
Obtén más información para enviar una solicitud.
Descripción
El parámetro de ID del conjunto de aplicaciones (pvid) admite un valor variable que se establece en el ID del conjunto de aplicaciones para Android, y el parámetro de alcance del conjunto de aplicaciones (pvid_s) admite un valor constante que representa el alcance del ID del conjunto de aplicaciones (scope_app o scope_developer).
Consulte la documentación de Android sobre cómo recuperar el ID del conjunto de aplicaciones.
Ejemplos de uso
pvid=[AppSetID_value]
pvid_s=scope_app
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 apps para dispositivos móviles en dispositivos Android.
Uso del SDK
Si bien el SDK de IMA/PAL pasa este campo automáticamente, los publicadores con implementaciones que no pertenecen al SDK deben llamar al SDK del conjunto de aplicaciones y pasar estos parámetros de forma manual en la solicitud de anuncio.
Descripción
El parámetro de ID del conjunto de aplicaciones (pvid) admite un valor variable que se establece en el ID del conjunto de aplicaciones para Android, y el parámetro de alcance del conjunto de aplicaciones (pvid_s) admite un valor constante que representa el alcance del ID del conjunto de aplicaciones (scope_app o scope_developer).
Consulte la documentación de Android sobre cómo recuperar el ID del conjunto de aplicaciones.
Ejemplos de uso
pvid=[AppSetID_value]
pvid_s=scope_app
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 apps para dispositivos móviles en dispositivos Android.
Uso del SDK
Si bien el SDK de IMA/PAL pasa este campo automáticamente, los publicadores con implementaciones que no pertenecen al SDK deben llamar al SDK del conjunto de aplicaciones y pasar estos parámetros de forma manual en la solicitud de anuncio.
Descripción
El parámetro de precio mínimo público para Ad Exchange (pubf) y el parámetro de precio mínimo privado para Ad Exchange (pvtf) admiten valores variables que se usan para agregar precios mínimos a las etiquetas de Ad Exchange.
Estos parámetros son equivalentes a 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 publicadores del Espacio Económico Europeo ("EEE") o Suiza que hayan recibido la aprobación para usar la función "Precio mínimo".
Obtén más información para enviar una solicitud.
Descripción
El parámetro de restricción del procesamiento de datos (rdp) admite un valor constante para indicar que la solicitud de anuncio debe restringir el procesamiento de datos.
Para restringir el procesamiento de datos a nivel de la red, habilita el parámetro de configuración de red Restringir el procesamiento de datos.
Ejemplos de uso
Restringir el procesamiento de datos:
rdp=1 o rdp (sin valor establecido)
No restringir el procesamiento de datos:
rdp=0
Descripción
El parámetro de cadena de suministro (schain) admite un valor variable que debe serializarse con un objeto SupplyChain. Cuando se incluye este parámetro, Google agrega un nodo a cualquier objeto schain recibido antes de enviarlo a los compradores.
Consulta la documentación completa de IAB para comunicar información de SupplyChain a través de una etiqueta (en lugar de OpenRTB).
Según la documentación de IAB, lo siguiente define la serialización del objeto SupplyChain:
- Las propiedades
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjectySupplyChainNodeestán delimitadas por comas, de modo que se pueden omitir los campos opcionales y los separadores de comas se pueden excluir de forma opcional. - Cada elemento
SupplyChainNodeestá separado por un "!". - Si el valor de alguna propiedad contiene caracteres que requieren codificación de URL (por ejemplo, "
," o "!"), deberá tener codificación de URL antes de la serialización.
Orden de serialización
Las propiedades SupplyChainObject se serializan en este orden:
ver,complete
Las propiedades SupplyChainNode se serializan en este orden:
asi,sid,hp,rid,name,domain,ext
ext es específico de cada intercambio. Google Ad Manager no analiza esta propiedad.Ejemplos de cómo serializar el objeto SupplyChain
A continuación, se muestran dos ejemplos de formas de 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 de escape se vería de la siguiente manera:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específicos, es obligatorio para los publicadores que utilizan intermediarios de pagos en dirección upstream con respecto a la solicitud a Google Ad Manager. Esto incluye a los publicadores que usan tecnología de servidores de anuncios de terceros.
Descripción
El parámetro de correlator de transmisión (scor) admite un valor variable que debe ser un número entero generado para cada transmisión de video por Internet.
No es necesario que los parámetros scor y correlator tengan el mismo valor entero. Sin embargo, deben conservar sus respectivos valores durante cada reproducción de transmisión de video por Internet para identificar una sesión de visualización única.
Ejemplos de uso
scor=17
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específicos, se recomienda para 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 se usa para las exclusiones de la competencia, la limitación de frecuencia y funciones relacionadas cuando un usuario mira varios videos en la misma página.
Descripción
El parámetro de frameworks de APIs del SDK (sdk_apis) admite una lista separada por comas de valores enteros constantes que indican todos los frameworks de APIs que admite el reproductor.
Requisitos y recomendaciones
Uso del SDK
Los publicadores que usan la biblioteca de acceso programático (PAL) utilizan este parámetro. Si intentas establecer valores para este parámetro mientras usas el SDK de IMA, los valores se anularán y se reemplazarán con los valores admitidos por el SDK de IMA.
Descripción
El parámetro de duración máxima de anuncios que se pueden omitir (sdmax) admite un valor variable que permite a los publicadores especificar la duración máxima deseada para los anuncios que se pueden omitir.
Se mide en milisegundos y representa el límite superior que se debe permitir para la duración de las creatividades de audio o video que se pueden omitir para esa solicitud de anuncio en particular.
Usa sdmax de forma independiente para los anuncios que se pueden omitir o en combinación con el parámetro max_ad_duration existente para proporcionar diferentes duraciones máximas para los anuncios que se pueden omitir y que no se pueden omitir.
Ejemplos de uso
Con la siguiente configuración:
max_ad_duration= 15,000 (15 segundos)sdmax= 45,000 (45 segundos)
Para las siguientes creatividades:
- Creatividad A: No se puede omitir; 30 s
- Creatividad B: Se puede omitir; 30 s
Resultados:
- Se filtrará la creatividad A porque no se puede omitir y su duración supera el máximo para ese tipo de creatividad.
- No se filtrará la creatividad B porque, si bien su duración supera el valor de
max_ad_duration, se puede omitir y su duración no supera el máximo para ese tipo de creatividad.
Descripción
El parámetro de fuente de unión del servidor (ssss) admite un valor constante que debe establecerse en un valor reconocido proporcionado por Google para tu proveedor de tecnología de unión de videos.
Los proveedores de tecnología de unión de videos que usan integraciones de servidor a servidor con Google reciben este valor de parte de Google y pueden enviártelo. Si tienes preguntas sobre el valor que debes establecer en este parámetro, puedes comunicarte con tu administrador de cuentas de Google.
Ejemplos de uso
ssss=mystitcher
Requisitos y recomendaciones
Si bien este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específicos, es necesario para usar implementaciones del servidor.
Descripción
El parámetro de tratamiento como contenido dirigido a niños (tfcd) admite un valor constante que indica que la solicitud se debe tratar como contenido dirigido a niños.
Ejemplos de uso
tfcd=1
Descripción
El parámetro de tipo de tráfico (trt) admite 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 del SDK
El SDK de IMA no propaga un valor predeterminado si falta el parámetro de tipo de tráfico en una solicitud. En esos casos, el servidor proporciona un valor predeterminado de 0 (tráfico no definido).
Descripción
IAB dio de baja la cadenaus_national y la reemplazó por GPP. Sin embargo, para garantizar la retrocompatibilidad, Ad Manager sigue leyendo y respetando la cadena si esta se pasa. Se recomienda que los publicadores revisen GPP o cualquier otro control de privacidad y migren de us_national.
Descripción
El parámetro de tipo de anuncio de video (vad_type) admite un valor constante que indica si se debe mostrar un anuncio lineal o no lineal.
Ejemplos de uso
Mostrar un anuncio lineal:
vad_type=linear
Mostrar un anuncio no lineal:
vad_type=nonlinear
Descripción
Los parámetros del ID de la fuente del contenido (cmsid) y del ID de video (vid) aceptan valores variables.
Si deseas segmentar anuncios para contenido de video, tu etiqueta de video principal debe incluir ambos parámetros.
- El valor
cmsides un número único para cada fuente del contenido. Para encontrar esto en Google Ad Manager, haz clic en Video, luego, en Fuentes de contenido y, luego, en el nombre de la fuente. - El valor
vides una string o un número que identifica un video específico. El CMS que aloja su contenido asigna este ID. Para encontrar esto en Google Ad Manager, haz clic en Video, luego en Contenido y, luego, en el contenido de video específico.
Ejemplos de uso
cmsid=[value]&vid=[value]
Si quieres crear una etiqueta para video on demand con la inserción de anuncios dinámicos, debes usar las macros que insertarán de forma dinámica el ID de video y la fuente del contenido correctos.
Por ejemplo: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisitos y recomendaciones
Si bien estos parámetros no son obligatorios para publicar anuncios en ninguna implementación o tipo de transacción específica, sí lo son para usar la segmentación por contenido de video.
Descripción
El parámetro de intercalado interno de la lista de reproducción de video (vpi) admite un valor constante que indica si se debe publicar la VMAP intercalada (devolver VAST dentro de VMAP).
Este parámetro se puede usar para reducir la latencia y garantizar limitaciones de frecuencia y exclusiones de la competencia en una transmisión de video por Internet.
Ejemplos de uso
Se devuelve VAST:
vpi=1
Se devuelven redireccionamientos:
vpi=0