Cómo agregar parámetros de orientación a su transmisión

Tiene la opción de agregar cualquiera de los siguientes parámetros de orientación.

Cuando creas o configuras una fuente del contenido para video on demand (VOD) o configuras una transmisión en vivo para DAI, debes especificar una etiqueta de anuncio de video predeterminada. Todas las transmisiones de DAI usan esa etiqueta de anuncio y sus parámetros de forma predeterminada. Los parámetros de la etiqueta de anuncio se aplican a los anuncios durante el video y previos al video. Si deseas que tu reproductor solicite algo único para una transmisión determinada, a continuación se mencionan las opciones disponibles.

Parámetros de etiquetas de anuncios de Ad Manager que se pueden anular

favorito Ir a un parámetro específico:

addtl_consent
an
ciu_szs
cust_params
description_url
gdpr
gdpr_consent
givn|paln
idtype
is_lat
iu

iu
is_lat
ltd
mpt
mpv
npa
omid_p
ppid
ptpl
ptpln
rdid

rdp
sdk_apis
sid
sz
tfat
tfcd
trt
vconp
vpa
vpmute
wta

Anula la etiqueta de anuncio predeterminada

Cuando el reproductor de video solicita una transmisión, la etiqueta de anuncio predeterminada se usa exactamente como lo especificaste en la interfaz. Sin embargo, puede anular ciertos parámetros de esa etiqueta en la solicitud de transmisión. A continuación se indican los únicos parámetros que se pueden anular.

Obtenga información para anular la etiqueta de anuncio predeterminada con el SDK de IMA o con SSB.

Parámetro Descripción Valor de ejemplo

iu

Es la unidad de anuncios actual.

_{Debe seguir este formato:}
_{/network_id/directory/ad_unit}

iu=/6062/video/example_unit

cust_params

Pares clave-valor que se deben usar para la segmentación de campaña de Ad Manager. Algunas plataformas requieren codificación de URL.

El requisito de codificación de URLs no se aplica cuando se utiliza el SDK de DAI de IMA para HTML5, ya que el valor se codifica automáticamente. Este parámetro no funcionará si ya está codificado en HTML5.

Ejemplos con varios pares clave-valor:

section=sports
page=golf,tennis

Transmisiones de SSB: Codifique y concatene todo el valor de cust_params, pero no lo codifique dos veces.

cust_params= "section%3Dsports %26page%3Dgolf%2Ctennis"

Chromecast:
Codifica únicamente los valores.

streamRequest. adTagParameters = { "cust_params": "section=sports& multi=golf%2Ctennis"};

Roku: Codifique y concatene todo el valor de cust_params, pero no lo codifique dos veces.

request.adTagParameters = "cust_params= section%3Dsports %26page%3Dgolf%2Ctennis"

iOS y tvOS: No codifique nada.

request.adTagParameters = @{ @"cust_params" : @"section=sports& multi=golf,tennis"};

Android: No codifiques nada.

Map<String, String> adTagParams = new HashMap<>(); adTagParams.put( "cust_params", "ge=0&gr=2");

sz

Anula el parámetro sz de su etiqueta de anuncio predeterminada, lo cual le permite hacer cambios de forma dinámica para diferentes dispositivos.

No incluyas la "v" después del tamaño.

sz=400x300

tfat

Etiqueta una solicitud para que se aplique el tratamiento según la edad.

Cuando una solicitud de DAI incluye tfat=1, se quita cualquier valor asignado a los parámetros rdid, idtype o is_lat para cumplir con la ley COPPA.

tfat=1 indica tratamiento de contenido para niños y niñas

tfat=2 indica tratamiento de contenido para adolescentes

tfat=0 indica que no se especificó ningún tratamiento según la edad

tfat=1

tfat=2

tfat=0

tfcd^(obsoleto)

Etiquete una solicitud para que se considere como contenido dirigido a niños.

Cuando una solicitud de DAI incluye tfcd=1, se quita cualquier valor asignado a los parámetros rdid, idtype o is_lat para cumplir con la ley COPPA.

tfcd=1

description_url

El valor debe describir el video que se reproduce en la página. Por lo general, es la página que contiene el reproductor de video, pero también puede ser una página con texto que describa el video.

Siempre debe realizar la codificación del parámetro description_url en formato de URL en las transmisiones de SSB y cuando use el SDK de DAI de IMA para Roku. Este requisito no se aplica cuando se utiliza el SDK de DAI de IMA para HTML5, ya que el valor se codifica automáticamente. Este parámetro no funcionará si ya está codificado en HTML5.

El SDK de IMA no configura este parámetro automáticamente, por lo que debe hacerse de forma manual.

Este campo es obligatorio si usa Ad Exchange. Más información

Ejemplo codificado en formato URL:
description_url= https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttp%2Fwww.sample.com %2Fgolf.html

Ejemplo no codificado:
description_url= http://www.sample.com/ golf.html

ppid El identificador proporcionado por el publicador (PPID) permite que los publicadores envíen un identificador para su uso en la limitación de frecuencia, la segmentación y orientació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. Más información ppid= 12JD92J...

ciu_szs

Lista separada por comas de tamaños de anuncios complementarios.

_{Los anuncios complementarios solo se admiten con DAI cuando usas el SDK HTML5.}

ciu_szs=728x90,300x250

mpt

Indica el nombre del reproductor del socio. Este sería usado principalmente por socios como JWPlayer o Brightcove, que se integran con el SDK.

mpt=JWPlayer

mpv

Indica la versión del reproductor del socio. Solo debe configurarse si también se establece mpt, y representa la versión del reproductor del socio que se integra con el SDK.

mpv=2.1

ptpl

Es el ID de la plantilla de pausa publicitaria.

Puede encontrar este ID en la URL de Ad Manager al ver la configuración de la plantilla de pausa en la interfaz de Ad Manager. Aparece como el valor para el parámetro break_template_id.

ptpl=1234

ptpln

Es el nombre de la plantilla de pausa publicitaria. Corresponde al campo "Nombre" en Ad Manager, no al nombre comercial.

ptpln=my_break_template

an

El parámetro an es el nombre de la app,

y debe aplicarse a las solicitudes que se envíen desde aplicaciones para dispositivos móviles y dispositivos de TV conectada, ya que la mayoría de los anuncios de publicidad programática de video lo requieren.*

El SDK de IMA lo propagará automáticamente, pero debe especificarse de forma manual cuando se usa con el SSB y la API de DAI (entornos que no pertenecen al SDK).

_{* Si bien el nombre de la app debe ser legible por humanos, en iOS y tvOS, el SDK no puede acceder al ID de App Store de 9 dígitos. En estos casos, el SDK envía el paquete de aplicación a través del parámetro an (con el formato com.package.publisher).}

an=sample%20app

ltd Indica si se pueden publicar anuncios de forma limitada sin recibir consentimiento para el uso de cookies y otros identificadores locales. Más información ltd=1

rdid

      idtype

      is_lat

Con las aplicaciones nativas (no en la Web ni en la Web móvil), el SDK pasa identificadores de dispositivos que se pueden restablecer para la segmentación de usuarios a sus solicitudes de transmisión con los parámetros para idtype, is_lat y rdid. En las transmisiones de SSB, debes pasar estos parámetros como explícitos, del mismo modo que lo harías en una solicitud de anuncios de Soluciones de video del cliente.

A partir de iOS 14.5, Apple dio de baja el indicador LAT. En cambio, Google se basa en la presencia de un IDFA distinto de cero para indicar que el usuario dio su consentimiento para el seguimiento de versiones de iOS compatibles con la Transparencia en el Seguimiento de Aplicaciones. Por lo tanto, se requerirá un UserAgent válido que indique la versión correcta del SO.

Vea ejemplos detallados de identificadores de dispositivos que se pueden restablecer.

trt

Designa el tráfico como comprado o de otra manera.

Tipo de tráfico no definido:
trt=0

Tráfico comprado:
trt=1

Tráfico orgánico:
trt=2

vconp

Recomendado según los MRC Lineamientos de medición de video

Indica si el reproductor está configurado para reproducir continuamente los videos de contenido uno tras otro, de manera similar a una transmisión de TV.

Los valores posibles son 2 si la reproducción continua está ACTIVADA y 1 si está DESACTIVADA.

Este parámetro debe dejarse sin configurar si se desconoce.

Reproducción continua ACTIVADA:
vconp=2

Reproducción continua DESACTIVADA:
vconp=1

vpa

Recomendado según los MRC Lineamientos de medición de video

Indica si el anuncio se inicia mediante reproducción automática o al hacer 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 debe dejarse sin configurar si se desconoce.

Reproducción automática:
vpa=auto

Clic:
vpa=click

vpmute

Recomendado según los MRC Lineamientos de medición de video

Indica si la reproducción del anuncio comienza mientras el reproductor de video está silenciado.

Los valores posibles son 1 para silenciado y 0 para no silenciado.

Este parámetro debe dejarse sin configurar si se desconoce.

Silenciado:
vpmute=1

No silenciado:
vpmute=0

npa

Es la configuración de personalización para las solicitudes de anuncios. Debes especificar el parámetro al principio de la etiqueta para evitar cualquier riesgo de que se trunque.

Especifique npa=1 para marcar la solicitud de anuncio como no personalizada. Si se omite este parámetro, la opción predeterminada es anuncios personalizados.

npa=1

omid_p

El parámetro de nombre del socio de OMID acepta un valor variable que indica el nombre del socio que integra la medición de OMID, junto con la versión del socio.

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). No se debe usar cuando se utiliza el SDK de IMA, ya que se configura automáticamente.

Para indicar la compatibilidad con OMID cuando se usa la biblioteca de acceso programático (PAL), es necesario usar las APIs de omidPartnerName y omidPartnerVersion para configurar el nombre y la versión del socio. Cuando no usas la PAL ni IMA, debes configurar los parámetros omid_p y sdk_apis (las APIs admitidas, que también podrían incluir otras APIs separadas por comas).

Cuando usas la PAL:

request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0'
Cuando no usas la PAL: omid_p=examplepartnername/1.0.0.0&sdk_apis=7

gdpr
gdpr_consent

Estos campos se usan a fin de pasar la información de consentimiento del MTC v2.0 para las solicitudes de sincronización de cookies de entrada y de salida.

Consulte las especificaciones del GDPR.

givn|paln

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 antes proporcionaste un nonce con el parámetro paln heredado, te recomendamos que migres al parámetro givn y dejes de enviar paln. No incluyas ambos parámetros.

Puedes leer las guías de introducción de PAL para obtener más información sobre el valor que se pasa a este parámetro.

addtl_consent

Se trata de una lista de proveedores de tecnología publicitaria de Google que cuentan con el consentimiento de los usuarios y que no están registrados en la IAB.

Consulte las especificaciones del Consentimiento adicional.

rdp

Para restringir el procesamiento de datos, debe establecer específicamente rdp=1 o solo incluir rdp (sin un valor establecido). No se restringirán las solicitudes de anuncios que no tengan este parámetro o que estén configuradas en rdp=0, a menos que se habilite la configuración de red Restringir procesamiento de datos.

rdp=1

sdk_apis

El parámetro de framework de las API del SDK acepta una lista separada por comas de valores enteros constantes que indican todos los frameworks de las API que admite el reproductor.

Consulta una lista de posibles valores de frameworks de APIs.

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.

sdk_apis=2,7,9

sid

Es un tipo de identificador de publicidad que preserva la privacidad y se puede usar solo con fines de limitación de frecuencia. Este parámetro debe completarse en formato UUID. Más información

Para inhabilitar la opción de pasar el ID de sesión, establece sid=0.

sid=123e4567-e89b-12d3 -a456-426614174000

wta

Indica la compatibilidad del reproductor de video para renderizar "¿Por qué este anuncio?".

Esto se admite automáticamente cuando se usa el SDK de IMA. Cuando no se usa el SDK de IMA, los reproductores de video deben implementar la compatibilidad con Icon y IconClickFallbackImage de VAST, como se indica en esta guía sobre la API de DAI.*

WTA no se admite para el SSB.

Este campo es obligatorio si usas Ad Exchange. Más información

_{* No se requiere compatibilidad con IconClickFallbackImage, excepto con dispositivos de CTV.}

Compatible:
wta=1

No compatible:
wta=0

Anula la etiqueta de anuncio predeterminada con el SDK de IMA

Cuando un reproductor de video usa el SDK de IMA para solicitar una transmisión de DAI, puede pasar un campo llamado "adTagParameters". Esta estructura similar a un diccionario se puede establecer con pares clave-valor en los que las claves pueden ser los parámetros de etiqueta de anuncio de Ad Manager que se indican en la tabla anterior.

Puedes usar esta misma estructura para personalizar la transmisión y pasar parámetros que no estén relacionados con la solicitud de anuncio de Ad Manager. Obtén información sobre cómo solicitar variantes de transmisión específicas y cómo configurar un descanso de anuncios.

La implementación del campo adTagParameters es ligeramente diferente según la plataforma o el lenguaje de programación específicos. Consulte la documentación de desarrollo de iOS, Android, tvOS, Chromecast y HTML5 o la documentación adicional en el reproductor DAI y en la guía de desarrollo de aplicaciones.

Cómo configurar adTagParameters mediante el SDK

Cuando configura cust_params o description_url mediante el SDK en aplicaciones para iOS, tvOS y Android, no debe codificar las strings en formato de URL. Puede pasar cust_params como una string única que concatena los pares clave-valor con el símbolo "&".

Por ejemplo, si desea configurar cust_params con el valor de sport=football&city=newyork:

La estructura adTagParams con valores no codificados sería la siguiente:

{

    "tfat": 1,

    "iu": "/987654321/path/to/adunit",

    "cust_params": "sport=football&city=newyork",

    "description_url": "http://www.sample.com/golf.html",

    "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"

  }

La estructura de adTagParameters con valores codificados para las solicitudes de transmisión HTML5 sería la siguiente:

{

    "tfat": 1,

    "iu": "/987654321/path/to/adunit",

    "cust_params": "sport%3Dfootball%26city%3Dnewyork",

    "description_url": "https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttp%2Fwww.sample.com%2Fgolf.html",

    "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"

  }

La estructura de adTagParams con valores codificados para las solicitudes de transmisión de Roku sería la siguiente:

request.adTagParams="tfat=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttp%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"

Anula la etiqueta de anuncio predeterminada con la API de DAI ^(Beta)

Cuando un reproductor de video solicita una transmisión de DAI mediante la API de DAI, puede pasar pares clave-valor de manera opcional, donde las claves pueden ser los parámetros de etiqueta de anuncio de Ad Manager que se indican en la tabla anterior.

Estos parámetros deben enviarse como parte del cuerpo de la solicitud POST de HTTP, del tipo de formulario application/x‑www‑form‑urlencoded para lineal/en vivo y VOD.

Puedes usar esta misma estructura para personalizar la transmisión y pasar parámetros que no estén relacionados con la solicitud de anuncio de Ad Manager. Obtenga información para solicitar parámetros de variantes de transmisión específicos y la autenticación HMAC.

Consulte una implementación de muestra de la API de DAI.

Anule la etiqueta de anuncio predeterminada con SSB

A continuación, se proporcionan ejemplos de cómo modificar una etiqueta de anuncio de VOD predeterminada de SSB. Los parámetros anulados que pasa el reproductor o la aplicación se muestran destacados.

Ejemplos de video on demand

	Ejemplo
URL de transmisión de VOD base	`http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8`
(con una unidad de anuncios especificada)	`http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?iu=/9876/ path/to/adunit`
(con pares clave-valor anulados)	`http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8? cust_params=sport%3Dgolf%26section%3Dblog %26anotherKey%3Dvalue1%2Cvalue2`
(con una declaración de contenido con tratamiento de contenido según la edad)	Ejemplo de tratamiento de contenido para niños y niñas: `http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfat=1` Ejemplo de tratamiento de contenido para adolescentes: `http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfat=2` Ejemplo de tratamiento de contenido para ninguna edad específica: `http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfat=0`
(con una unidad de anuncios anulada Y pares clave-valor Y un valor personalizado de `description_url` Y una declaración de contenido con tratamiento según la edad)	Ejemplo de tratamiento de contenido para niños y niñas: `http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=1` Ejemplo de tratamiento de contenido para adolescentes: `http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=2` Ejemplo de tratamiento de contenido para ninguna edad específica: `http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=0`

Ejemplos de transmisión lineal en vivo

	Ejemplo
URL de transmisión lineal en vivo base	`https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8`
(con una unidad de anuncios especificada)	`https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?iu=/9876/path/to/adunit`
(con pares clave-valor anulados)	`https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?cust_params=sport%3Dgolf%26section %3Dblog%26otherKey%3Dvalue1%2Cvalue2`
(con una declaración de contenido con tratamiento según la edad)	Ejemplo de tratamiento de contenido para niños y niñas: `https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfat=1` Ejemplo de tratamiento de contenido para adolescentes: `https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfat=2` Ejemplo de tratamiento de contenido para ninguna edad específica: `https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfat=0`
(con una unidad de anuncios anulada Y pares clave-valor Y un valor personalizado de `description_url` Y una declaración de contenido con tratamiento según la edad)	Ejemplo de tratamiento de contenido para niños y niñas `https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=1` Ejemplo de tratamiento de contenido para adolescentes `https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=2` Ejemplo de tratamiento de contenido para ninguna edad específica `https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=0`

Actualiza los parámetros de segmentación de forma dinámica durante una transmisión en vivo específica

Puedes actualizar de forma dinámica los datos de segmentación para un usuario específico mientras mira la transmisión mediante el método replaceAdTagParameters en el SDK de DAI de IMA.

Si tienes problemas relacionados con la solución de problemas o las interrupciones de la DAI, comunícate con el equipo de asistencia para publicadores.

Es posible que esta página incluya contenido traducido con tecnología de IA. Las traducciones realizadas con IA pueden contener errores.

¿Te resultó útil esto?

¿Cómo podemos mejorarla?

Cómo agregar parámetros de orientación a su transmisión

Parámetros de etiquetas de anuncios de Ad Manager que se pueden anular

Anula la etiqueta de anuncio predeterminada

Anula la etiqueta de anuncio predeterminada con el SDK de IMA

Cómo configurar adTagParameters mediante el SDK

Anula la etiqueta de anuncio predeterminada con la API de DAI ^(Beta)

Anule la etiqueta de anuncio predeterminada con SSB

Ejemplos de video on demand

Ejemplos de transmisión lineal en vivo

Actualiza los parámetros de segmentación de forma dinámica durante una transmisión en vivo específica

¿Te resultó útil esto?

¿Necesitas más ayuda?

Prueba estos próximos pasos:

Cómo agregar parámetros de orientación a su transmisión

Parámetros de etiquetas de anuncios de Ad Manager que se pueden anular

Anula la etiqueta de anuncio predeterminada

Anula la etiqueta de anuncio predeterminada con el SDK de IMA

Cómo configurar adTagParameters mediante el SDK

Anula la etiqueta de anuncio predeterminada con la API de DAI (Beta)

Anule la etiqueta de anuncio predeterminada con SSB

Ejemplos de video on demand

Ejemplos de transmisión lineal en vivo

Actualiza los parámetros de segmentación de forma dinámica durante una transmisión en vivo específica

¿Te resultó útil esto?

¿Necesitas más ayuda?

Prueba estos próximos pasos:

Anula la etiqueta de anuncio predeterminada con la API de DAI ^(Beta)