Hoja de trucos de Reach Extension VAST Tag

Como propietario de un inventario, debe personalizar la respuesta VAST del ad server de Triton Digital. Para ello, reemplace las macros de la plantilla de etiqueta VAST que le haya proporcionado su distribuidor.

Ejemplo de plantilla de etiqueta VAST

Este es un ejemplo de una plantilla de etiqueta VAST que proporciona su distribuidor. Los módulos contract-id, contract-secrety placement-id Los parámetros son solo ejemplos. Los valores reales de su distribuidor serán diferentes.

Ejemplo de una plantilla de etiqueta VAST para un podcast

En este ejemplo para un episodio de podcast, el propietario de un inventario ha personalizado aún más la URL al agregar parámetros adicionales sobre el podcast al final de la plantilla. Para obtener más información, consulte Otros parámetros admitidos.

https://resell-ad-server.example.com/resell/vast?contract-id=10001&contract-secret=1382169h-02ns-6a83-04gl-zeu158201ivq&placement-id=123456&lsid=${listenerId}&position=${position}&ip=${ip}&deviceid=${deviceId}&timestamp=${timestamp}&ua=${ua}&gdpr=${gdpr}&gpp_string=${gpp_string}&gpp_sid=${gpp_sid}&us_privacy=${us_privacy}&coppa=${coppa}&bundle-id=${bundle-id}&store-url=${store-url}&iab-v2-cat=${iab-v2-cat}&feed-type=${feed-type}&content-language=${content-language}&store-id=${store-id}&site-url=${site-url}&series-title=My Series Title&episode-season=3&episode-number=4&episode-title=My Episode Title&episode-url=https%3A%2F%2Fwww.example.com%2Fpodcasts%2FPodcastName%3Fepisode%3D1&episode-duration=1800&guid=6B29FC40-CA47-1067-B31D-00DD010662DA

Estos parámetros adicionales:

&series-title=My%20Series%20Title
&episode-season=3
&episode-number=4
&episode-title=My%20Episode%20Title
&episode-url=https%3A%2F%2Fwww.example.com%2Fpodcasts%2FPodcastName%3Fepisode%3D1
&episode-duration=1800
&guid=6B29FC40-CA47-1067-B31D-00DD010662DA

Personalizar una plantilla de etiqueta VAST

No modificar contract-id, contract-secrety placement-id. Estos parámetros son obligatorios y rellenados previamente por Triton Digital.
Reemplace el requerido position macro con preroll, midroll,o postroll. Por ejemplo, para especificar una inserción de anuncio antes del podcast, reemplace ${position} con preroll. El parámetro de posición en su solicitud VAST sería entonces position=preroll.
Reemplace las macros de otros parámetros según sea necesario. Si no conoce el valor de un parámetro, o no es aplicable, deje la macro sin cambios. Ejemplo: Si no conoce el idioma, use content-language=${content-language}.
Anexe otros parámetros, según sea necesario. Consulte Otros parámetros admitidos.

Parámetros de la etiqueta VAST

Parámetro	Macro	Descripción	Formato
`placement-id`	NC	Obligatorio. ID de la colocación, históricamente conocida como la "ID de estación". Es la ID numérica de la estación asignada por Triton Digital. Su valor se rellena previamente en la plantilla VAST y no debe modificarse.
`contract-id`	NC	Obligatorio. Su valor se rellena previamente en la plantilla VAST y no debe modificarse.
`contract-secret`	NC	Obligatorio. Su valor se rellena previamente en la plantilla VAST y no debe modificarse.
`position`	`${position}`	Obligatorio. La posición del anuncio.	Secuencia. Valores válidos: `preroll` `midroll` `postroll`
`lsid`	`${listenerId}`	Recomendado. Importante para TAP programático para enriquecer el perfil. La ID del oyente es el identificador de usuario principal que Triton Digital debe utilizar como base para las mediciones y la limitación de frecuencia. Para obtener más información, consulte Administración de ID de oyentes.	Secuencia. Caracteres alfanuméricos, incluida la siguiente lista de caracteres especiales: `_=*+.[]{}()~-`
`ip` Encabezado HTTP: `X-Device-IP`	`${ip}`	Necesario para integraciones de servidor a servidor. Dirección IP del reproductor/dispositivo del oyente.	Para IPv4: formato decimal con puntos. Ejemplo: `192.0.2.254` Para IPv6: caracteres hexadecimales separados por dos puntos que se ajustan al formato IPv6. Ejemplo: `2001:db8:0000:1111:2222:3333:4444:5555`
`deviceId`	`${deviceId}`	Identifica el dispositivo.	Cadena que comienza con `app:` seguido de 10 a 40 caracteres alfanuméricos. Ejemplo: `app:EBE52E703EE455AB3`
`timestamp`	`${timestamp}`	Marca de tiempo Unix en segundos.
`ua` Encabezado HTTP: `X-Device-ua`	`${ua}`	User-Agent completo. Corresponde al atributo ID del oyente.	Secuencia. Ejemplo: `Mozilla/5.0 android-user-agent`
`gdpr`	`${gdpr}`	Aviso que indica si rigen las normas de la Regulación General de Protección de Datos (GDPR). Consulte GDPR.	Entero. Valores de valor: `0`: GDPR no se aplica `1`: GDPR se aplica
`gpp` Encabezado HTTP: `X-gpp`	`${gpp_string}`	Cadena GPP que permite la transmisión de señales de privacidad, consentimiento y elección del consumidor. La cadena debe cumplir con la especificación de la plataforma de privacidad global de IAB Tech Lab.	Secuencia. Cadena GPP codificada en base64 segura para URL.
`gpp_sid` Encabezado HTTP: `X-gpp-sid`	`${gpp_sid}`	ID de sección para indicar qué legislación se considera "en vigor".	Entero.
`us_privacy`	`${us_privacy}`	Cadena de privacidad de EE. UU. que indica si las Regulaciones de privacidad de EE. UU. se aplican al consumidor, si se ha establecido una divulgación legal de "aviso explícito" con un consumidor y si el consumidor ha optado por excluirse de la venta de sus datos personales. La versión 1 solo admite señales relacionadas con la Ley de Privacidad del Consumidor de California (CCPA). La secuencia debe cumplir con el formato de U.S. Privacy String (Secuencia de Privacidad en los EE. UU.)	Secuencia.
`coppa`	`${coppa}`	Aviso que indica si rigen las normas de la Ley de Protección de la Privacidad de los Niños En Línea (COPPA). COPPA fue promulgada por la Comisión Federal de Comercio de los EE. UU.	0 = No se aplican las restricciones de COPPA 1 = Se aplican restricciones de COPPA
`bundle-id`	`${bundle-id}`	Importante para programático. Solo se usa para el inventario en aplicaciones móviles y dispositivos similares, como altavoces inteligentes, donde se requiera. Identificados de la aplicación creado para ser exclusivo de la aplicación e independiente de la tienda de aplicaciones que la distribuye. Para obtener detalles relacionados, consulte ID de paquete de Android.	Secuencia. Ejemplos: iOS: `bundle-id=com.companyname.appname` Androide: `bundle-id=com.companyname.app` Habilidad de Alexa: `bundle-id=amzn1.ask.skill.your-skill-guid-here`
`store-url`	`${store-url}`	Importante para programático. Solo para inventario en aplicaciones móviles y dispositivos similares, como altavoces inteligentes. URL de la tienda de aplicaciones donde se obtuvo la aplicación para solicitar el anuncio/conectarse al stream. Requerido por los compradores programáticos para verificar que Triton Digital tiene permiso para vender su inventario utilizando el marco de app-ads.txt.	URL codificada cadena de una URL. Ejemplo: `https%3A%2F%2Fexample.com%2Fstore%2Fapps%2Fdetails%3F1d%3Dcom.tritondigital.tritonradio`
`iab-v2-cat`	`${iab-v2-cat}`	Recomendado para contenido de audio personalizado (p. ej., servicios de música) donde el género es dinámico y se basa en la elección del oyente. Categoría del contenido según lo definido por la taxonomía de contenido de IAB Tech Lab. La primera categoría de la lista será considerada como la categoría principal. Triton RefData API Requiere token JWT Bearer.	Lista separada por comas de valores enteros, cada uno dentro del rango de 1-698. Consulte IAB notas de uso de categorías.
`feed-type`	`${feed-type}`	Requerido para el caso de uso específico en el que el inventario se ofrece a publicidad programática y los anuncios solicitados a través de on demand se unen a un podcast. También se puede utilizar para la transmisión en vivo. Ver también `delivery-method`.	Secuencia. Valores válidos: `podcast` `music` `radio` `game` `pureplay` `Replay` `txt2speech`
`content-language`	`${content-language}`	El idioma del contenido donde se reproducirán los anuncios. Esto se puede usar en el direccionamiento de campañas o para definir una regla específica en el intercambio de anuncios.	Secuencia. Código de dos letras que corresponde a los códigos de idioma ISO 639-1.
`store-id`	`${store-id}`	Importante para programático. Requerido por los compradores programáticos para verificar que Triton Digital tiene permiso para vender su inventario utilizando el marco app-ads.txt. Solo para inventario en aplicaciones móviles y dispositivos similares, como altavoces inteligentes. Identificador de la tienda de aplicaciones donde se obtuvo una aplicación instalada. Se usa para ubicar la aplicación dentro de la tienda correspondiente.	Secuencia. Ejemplo para iTunes: `726533955` Ejemplo para Google Play: `com.tritondigital.tritonradio`
`site-url`	`${site-url}`	URL of the website where the ad will be heard. Los compradores programáticos usan esto para identificar el inventario por el que pujan. También se utiliza para verificar si Triton Digital puede vender su inventario utilizando el marco ads.txt. Si no reemplaza esta macro con un valor, Triton Digital utiliza el valor configurado para esta colocación. Para obtener más información, consulte Vendedores digitales autorizados (ads.txt).	URL codificada cadena de una URL, que debe incluir el protocolo como http o https. Ejemplo: `https%3A%2F%2Fwww.blork. example%2Fradio%2Fhits%2F`

Otros parámetros admitidos

Triton Digital lo alienta a informar al propietario del inventario que puede personalizar el VAST generado que usted comparte con él al crear el contrato. Esto garantiza que los servidores de anuncios y el DSP (proveedor del lado de la demanda) puedan procesar mejor la selección de anuncios y la solicitud de oferta en el inventario dado.

Para agregar otro parámetro de esta tabla, use este formato: &parametername=value

Por ejemplo, para pasar el maxAds parámetro con un valor de 5, agregaría esto a la etiqueta VAST:

&maxAds=5

Categoría	Parámetro	Descripción	Formato
Contenido (Content)	`maxAds`	Número máximo de anuncios.	Valor entre 1 y 10 inclusive.
Oyente	`device-language` Encabezado HTTP: `X-Device-Accept-Language` o `accept-language`	Recomendado para integraciones de servidor a servidor. Cabecera HTTP del reproductor/dispositivo del oyente. Indica para qué idiomas está configurado el cliente y la variante local preferida. Somos compatibles con ambos: cadena de consulta y/o cabecera HTTP.	Secuencia. Código de dos letras que corresponde a los códigos de idioma ISO-639-1 .
Contenido (Content)	`iab-categories-to-exclude`	Lista de categorías de anuncios NO permitidas para el anuncio solicitado. Las categorías se definen en la especificación IAB DAAST y se enumeran con códigos en OpenRTB. Aunque la especificación DAAST está obsoleta, sus categorías de anuncios todavía se usan regularmente. Triton se actualizará a la taxonomía de productos publicitarios de IAB una vez que haya alcanzado un nivel aceptable de uso. El bloqueo de una categoría de nivel 1 no bloquea el nivel 2 bajo ella (por ejemplo, el bloqueo de IAB1 no bloquea IAB1-1 a IAB1-7). Para bloquear el nivel 2 de una categoría, cada categoría de nivel 2 debe bloquearse individualmente.	Lista de códigos separados por comas (cadenas).
Contenido (Content)	`delivery-method`	Obligatorio si se descarga el contenido en el que aparecerá el anuncio y se ofrece inventario de anuncios a compradores programáticos. La forma en la que se enviará el contenido de audio al oyente. Consulte Notas sobre el método de entrega.	Secuencia. Valores válidos: `streaming` `progressive` `download`
Contenido, podcast	`series-title`	Importante para programático, solo si es para podcast. Título de la serie (contenido en podcast).	Secuencia.
Contenido, podcast	`episode-season`	Importante para programático, solo si es para podcast. Número de temporada (contenido en podcast).	Secuencia.
Contenido, podcast	`episode-number`	Importante para programático, solo si es para podcast. Número de episodio (contenido en podcast).	Cadena. Contenido, podcast
Contenido, podcast	`episode-title`	Importante para programático, solo si es para podcast. Título del episodio (contenido en podcast).	Secuencia.
Contenido, podcast	`episode-url`	Importante para programático, solo si es para podcast. URL de origen del episodio (contenido en podcast).	Codificado mediante URL si se envía como cadena de consulta.
Contenido, podcast	`episode-duration`	Importante para programático, solo si es para podcast. Duración del episodio, en segundos.	Entero.
Contenido, podcast	`guid`	Importante para programático, solo si es para podcast. ID de episodio	Cadena en el formato de UUID (identificador único universal). Consulte RFC 9562.
Oyente	`age`	Edad del oyente, con base en la información obtenida a través del registro de oyentes.	Entero. Desde `1` a `125`.
Oyente	`gender`	Género del oyente, con base en la información obtenida a través del registro de oyentes.	Secuencia. Distingue entre mayúsculas y minúsculas. Valores válidos: `m`:masculino `f`: femenino `o`:Otro
Regulador	`gdpr_consent` Encabezado HTTP: `X-gdpr-consent`	Secuencia de consentimiento y transparencia de conformidad con la GDPR que encapsula los detalles relevantes sobre cómo se establcen la transparencia y el consentimiento. La cadena debe cumplir con las especificaciones del marco de transparencia y consentimiento de IAB.	Secuencia de consentimiento GDPR codificada en base64 y URL segura del formulario `GDPR_CONSENT_XXXXX` donde XXXXX es el identificador numérico del proveedor de seguimiento donde se utiliza la macro.

Notas sobre el método de entrega

A continuación se presentan las definiciones de la delivery-method valores.

streaming: flujo interminable de contenido, como radio en vivo. La sesión del usuario finaliza solo cuando el dispositivo cierra la conexión. El contenido se recupera a medida que se consume. Esto también se aplica a los servicios de música bajo demanda. Para actuaciones "en vivo" bajo demanda, donde constantemente se agrega contenido nuevo a la lista de reproducción a medida que se consume contenido actual, el valor de delivery-method debe estar vacío.
download: contenido único pregrabado o finito, como un podcast. La sesión del usuario finaliza una vez que se descarga el contenido o antes, si el usuario se desconecta a mitad de camino. Por lo general, la recuperación y el consumo de contenido son independientes; un ejemplo es el caso de un oyente que descarga un podcast y lo escucha más tarde, incluso quizá cuando el dispositivo está fuera de línea. Por lo tanto, las impresiones se activan por la descarga, no por el consumo.
progressive: También llamada descarga progresiva, es para el mismo tipo de contenido pregrabado o finito que el download Pero el contenido se recupera a medida que se consume. Esto debe ser aplicado por el reproductor en el dispositivo del usuario. Es una implementación de cliente, por lo que las implementaciones del lado del servidor que aceleran la velocidad de descarga no califican una sesión como descarga progresiva.

GDPR

Triton Digital cumple con el Reglamento General de Protección de Datos (GDPR). La GDPR fue promulgada por el Parlamento Europeo y el Consejo de la Unión Europea.

Triton Digital es un proveedor registrado y aprobado según la Lista Global de Proveedores (GVL) TCF v2.0. mantenido por el Interactive Advertising Bureau Europe (IAB Europe). El ID de proveedor de Triton Digital en la GVL es 239.