Parámetros obligatorios y recomendados para la programática

Implementar una solución de vídeo para la demanda de Ad Exchange basada en etiquetas sin utilizar el SDK de IMA es una función beta y puede que no esté disponible en su red. Puede pedir más información a su gestor de cuentas.

A continuación, se muestra un subconjunto de los parámetros de URLs de etiquetas de anuncio de VAST. Estos parámetros son para soluciones de vídeo basadas en etiquetas para la programática cuando no se integran con el SDK de IMA.

Consulte la lista de parámetros obligatorios y recomendados para la Web o los parámetros obligatorios para aplicaciones.

 Ir a un parámetro concreto de la lista

an description_url dth hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Parámetro	Detalles
hl (Idioma)	El parámetro "language" 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. 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. Ejemplo de uso hl=it Requisito Recomendado en la monetización programática
description_url (URL de descripción)	El parámetro "description URL" acepta un valor variable que debe describir el vídeo que se reproduce en la página. Describa la página con uno o tres párrafos que describan el contenido. Por ejemplo, puede unir el contenido de la página description_url de forma dinámica a partir de bloques predefinidos. Más información sobre cómo proporcionar una URL de descripción distinta El valor description_url debe estar codificado como URL si se usa en reproductores de páginas web o en dispositivos CTV u OTT. Si se utiliza en reproductores de vídeo incluidos en aplicaciones móviles, no debe estar codificado como URL. El SDK de IMA no da un valor a este parámetro automáticamente, sino que debe hacerse manualmente. Ejemplo de uso Codificado como URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Sin codificar: description_url= https://www.sample.com/golf.html Obligatoriedad Obligatorio en la Web, las aplicaciones y Ad Exchange Recomendado en la monetización programática
dth (Indicación sobre el tipo de dispositivo)	El parámetro de indicación del tipo de dispositivo 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 Requisito Recomendado para la monetización programática en televisiones conectadas. 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.
msid (ID de la aplicación) an (Nombre de la aplicación)	Los parámetros "app ID" y "app name" 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. El SDK de IMA rellenará automáticamente ambos parámetros, pero deberán especificarse manualmente en las solicitudes de VAST directas de entornos que no sean de SDK. 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. Ejemplo 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 Requisito Ambos parámetros son obligatorios para la aplicación Recomendado en la monetización programática
plcmt (Emplazamiento)	El parámetro de emplazamiento acepta un valor constante que se utiliza para indicar si el inventario in-stream se declara in-stream o complementario según las directrices de las especificaciones de IAB. En las solicitudes in-stream, este campo se rellena automáticamente para los compradores basándose en el formato de inventario declarado, y su valor anulará cualquier declaración de contenido in-stream o complementario. Ejemplo de uso Solicitud in-stream: plcmt=1 Solicitud de contenido complementario: plcmt=2 Requisito   Obligatorio para la Web y la monetización programática
pp (Perfil de creatividad)	El parámetro "creative profile" 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. Ejemplo de uso pp=creative_profile Requisito Recomendado en la monetización programática
rdid idtype is_lat (Identificadores de dispositivos que se pueden cambiar)	Los identificadores de dispositivos que se pueden cambiar aceptan valores variables. En las aplicaciones integradas (no en la Web ni en la Web móvil), el SDK transfiere los identificadores de dispositivos (que los usuarios pueden cambiar para poder orientar la publicidad) en sus solicitudes de emisión mediante los parámetros rdid, idtype e is_lat. En las emisiones de señalización de servidor (SSB) debe transferir estos parámetros de forma explícita, tal como lo haría en las solicitudes de anuncios de un cliente. 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 LAT. En su lugar, Google se basa en la presencia de un IDFA que no sea cero para indicar que el usuario ha aceptado el seguimiento en versiones de iOS compatibles con la transparencia en el rastreo de aplicaciones. Por tanto, se necesita un valor UserAgent válido que indique la versión de sistema operativo correcta. Ejemplo de uso Ver ejemplos detallados de los identificadores de dispositivos que los usuarios pueden cambiar. Requisito Obligatorio para aplicaciones Recomendado en la monetización programática
sid (ID de sesión)	El parámetro "session ID" acepta un valor variable que es un identificador de publicidad que preserva 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. Según las directrices sobre el identificador de publicidad de IAB, este parámetro debe rellenarse en formato UUID. Más información sobre los identificadores de dispositivo modificables para emplearlos en la segmentación de usuarios Para inhabilitar la transferencia del ID de sesión, indique el valor sid=0. Ejemplo de uso 123e4567-e89b-12d3-a456-426614174000 Requisito Recomendado en la monetización programática
url (URL)	El parámetro de URL acepta un valor variable, que debe ser 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 una página web, esta es la URL de la página que muestra el reproductor de vídeo. 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. En una aplicación (ya sea móvil o de CTV), este valor debe ser la URL que mejor represente el inventario de vídeo o de audio que se quiere monetizar. 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.* El valor de este parámetro debería codificarse. Ejemplo de uso url=https%3A%2F%2Fwww.anunciodevideo.com%2Fgolf.html * En el caso de las aplicaciones, si no es posible dar a este parámetro un valor de URL variable, le recomendamos que le dé un valor que siga este patrón: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Requisito Obligatorio para la Web y las aplicaciones Recomendado en la monetización programática
vpa (Reproducción del vídeo automática)	Recomendado según las directrices de medición de vídeos del MRC. El parámetro "video play automatic" 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 debe definirse si no se sabe qué valor tiene. Ejemplo de uso Reproducción automática: vpa=auto Reproducción mediante clic: vpa=click Requisito Recomendado en la monetización programática
vpmute (Reproducción del vídeo en silencio)	Recomendado según las directrices de medición de vídeos del MRC. El parámetro "muted video" acepta un valor constante que indica si el anuncio empieza a reproducirse mientras el reproductor de vídeo está silenciado. Ejemplo de uso Silenciado: vpmute=1 No silenciado: vpmute=0 Requisito   Obligatorio para la Web y la monetización programática
vpos (Posición del vídeo)	El parámetro "video position" 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. Ejemplo de uso Pre-roll: vpos=preroll Mid-roll: vpos=midroll Post-roll: vpos=postroll Requisito Recomendado en la monetización programática
wta (Por qué este anuncio)	El parámetro "¿Por qué este anuncio?" acepta un valor constante que indica la compatibilidad del reproductor de vídeo con el procesamiento de insignias de anuncios. Si no se envía ningún parámetro &wta, el valor predeterminado es &wta=1. 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 con Icon y IconClickFallbackImage de VAST, tal como se indica en el estándar de VAST de IAB. Los editores deben enviar &wta=0 si no van a renderizar el icono de Gestión de anuncios, tal como se proporciona en la respuesta de VAST. Se entiende que una solicitud de anuncio con el parámetro &wta=1 o sin un parámetro &wta indica que el editor renderizará la información proporcionada por Gestión de anuncios. Las solicitudes de anuncios de audio pueden enviar wta=1 si el icono de Gestión de anuncios, tal como se proporciona en la respuesta de VAST, se va a renderizar en anuncios complementarios o se va a proporcionar al usuario de cualquier otra forma. En el caso del tráfico del EEE, las solicitudes con &wta=0 no serán aptas para las creatividades de reserva en las que la insignia de Google esté habilitada. 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 correspondiente. Ejemplo de uso Compatible: wta=1 o ningún parámetro wta No compatible con: wta=0 Requisito Obligatorio para Ad Exchange Obligatorio para el tráfico del EEE en sitios web y aplicaciones Recomendado en la monetización programática