Hoja de trucos de Reach Extension VAST Tag

Anterior Siguiente

As an inventory owner, you must customize the VAST response from the Triton Digital ad server. You do this by replacing the macros in the VAST tag template that your reseller has provided to you.

Example VAST Tag Template

Here is an example of a VAST tag template that your reseller provides. Los módulos contract-id, contract-secrety placement-id parameters are only examples. The actual values from your reseller will be different.

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}

Example of a VAST Tag Template for a Podcast

In this example for a podcast episode, an inventory owner has further customized the URL by appending extra parameters about the podcast to the end of the template. For details, see Other Supported Parameters.

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

These extra parameters:

  • &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

Customize a VAST Tag Template

  1. Do not modify contract-id, contract-secrety placement-id. These parameters are required and pre-populated by Triton Digital.

  2. Replace the required position macro with preroll, midroll,o  postroll. For example, to specify a pre-roll ad insertion, you replace ${position} with preroll. The position parameter in your VAST request would then be position=preroll.

  3. Replace the macros of other parameters as needed. If you do not know a parameter's value, or it's not applicable, leave the macro unchanged. Example: If you do not know the language, then use content-language=${content-language}.

  4. Append other parameters, as needed. See Other Supported Parameters.

VAST Tag Parameters

Parámetro

Macro

Descripción

Formato

placement-id

NC

Obligatorio.

ID of the placement, historically known as the "station ID". It is the numerical ID of the station as assigned by Triton Digital.

Its value is pre-populated in the VAST template and must not be altered.

contract-id

NC

Obligatorio.

Its value is pre-populated in the VAST template and must not be altered.

contract-secret

NC

Obligatorio.

Its value is pre-populated in the VAST template and must not be altered.

position

${position}

Obligatorio.

The ad position.

Secuencia.

Valores válidos: 

  • preroll

  • midroll

  • postroll

lsid

${listenerId}

Recommended. 

Important for TAP Programmatic to enrich the profile. 

Listener ID is the main user identifier for Triton Digital to use as the basis for measurements and frequency capping. For details, see Listener ID Management.

Secuencia.

Caracteres alfanuméricos, incluida la siguiente lista de caracteres especiales: 

_=*+.[]{}()~- 

ip

HTTP Header: 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 

For IPv6: Colon-separated hexadecimal characters conforming to IPv6 format. Ejemplo: 2001:db8:0000:1111:2222:3333:4444:5555 

deviceId

${deviceId} 

Identifies the device. 

String that starts with app: followed by 10 to 40 alphanumeric characters.

Ejemplo: app:EBE52E703EE455AB3

timestamp

${timestamp}

Marca de tiempo Unix en segundos. 

ua 

HTTP Header: X-Device-ua 

${ua}

User-Agent full. Corresponds to the listener ID attribute.  

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).

See GDPR

Entero.

Value values:

  • 0: GDPR does not apply 

  • 1: GDPR applies

gpp

HTTP Header: 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.

URL-safe base64-encoded GPP string. 

gpp_sid

HTTP Header: X-gpp-sid 

${gpp_sid}

Section ID to indicate which legislation is considered “in force”. 

Entero.

us_privacy 

${us_privacy}

U.S. Privacy String that signals whether the U.S. Privacy Regulations apply to the consumer, if an “explicit notice” legal disclosure has been established with a consumer, and if the consumer has chosen to opt out of the sale of their personal data. 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 = COPPA restrictions do not apply 

1 = COPPA restrictions apply 

bundle-id

${bundle-id}

Important for Programmatic. 

Only used for inventory on mobile apps and similar devices such as smart speakers, where it is required. 

Identificados de la aplicación creado para ser exclusivo de la aplicación e independiente de la tienda de aplicaciones que la distribuye. 

For related details, see Android Bundle ID.

Secuencia.

Ejemplos:

  • iOS: bundle-id=com.companyname.appname

  • Android: bundle-id=com.companyname.app

  • Alexa Skill: bundle-id=amzn1.ask.skill.your-skill-guid-here

store-url

${store-url}

Important for Programmatic. 

Only for inventory on mobile apps and similar devices such as smart speakers. 

URL de la tienda de aplicaciones donde se obtuvo la aplicación para solicitar el anuncio/conectarse al stream. 

Required by programmatic buyers to verify Triton Digital is allowed to sell your inventory using the app-ads.txt framework.  

URL encoded string of a URL. 

Ejemplo: 

https%3A%2F%2Fexample.com%2Fstore%2Fapps%2Fdetails%3F1d%3Dcom.tritondigital.tritonradio 

iab-v2-cat

${iab-v2-cat}

Recommended for personalized audio content (e.g., music services) where genre is dynamic and based on listener's choice.

Category of the content as defined by the IAB Tech Lab Content Taxonomy. La primera categoría de la lista será considerada como la categoría principal. 

Triton RefData API

Requires JWT Bearer token.

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.

See also 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.

Two-letter code that corresponds to ISO 639-1 language codes.

store-id

${store-id}

Important for Programmatic.

Required by programmatic buyers to verify Triton Digital is allowed to sell your inventory using the app-ads.txt framework.

Only for inventory on mobile apps and similar devices such as smart speakers.

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. Programmatic buyers use this to identify the inventory they bid on. It is also used to verify if Triton Digital is allowed to sell your inventory using the ads.txt framework. 

If you do not replace this macro with a value, Triton Digital uses the value configured for this placement. Para obtener más información, consulte Vendedores digitales autorizados (ads.txt)

URL encoded string of a URL, which must include the protocol such as http or https. 

Ejemplo: 

https%3A%2F%2Fwww.blork. example%2Fradio%2Fhits%2F

Other Supported Parameters

Triton Digital encourages you to inform the Inventory Owner that they can personalize the generated VAST that you share with them upon the contract creation. This ensures that the ad servers and DSP (demand side provider) can better process the ad selection and bid request on the given inventory. 

To add another parameter from this table, use this format: &parametername=value

For example to pass the maxAds parameter with a value of 5, you would append this to the VAST tag:

&maxAds=5 

Categoría

Parámetro

Descripción

Formato

Contenido (Content) 

maxAds

Maximum number of ads.

Value between 1 and 10 inclusively.

Oyente 

device-language 

HTTP Header: X-Device-Accept-Languageaccept-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.

Blocking a tier-1 category does not block tier-2 under it (e.g., blocking IAB1 does not block IAB1-1 to 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

Required if the content in which the ad will appear is downloaded, and ad inventory is offered to programmatic buyers.

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  

 

Content, podcast 

series-title

Important for Programmatic, only if it is for podcast. 

Título de la serie (contenido en podcast). 

Secuencia.

Content, podcast 

episode-season

Important for Programmatic, only if it is for podcast. 

Número de temporada (contenido en podcast). 

Secuencia.

Content, podcast 

episode-number

Important for Programmatic, only if it is for podcast. 

Número de episodio (contenido en podcast). 

String. Content, podcast 

Content, podcast 

episode-title

Important for Programmatic, only if it is for podcast. 

Título del episodio (contenido en podcast). 

Secuencia. 

 

Content, podcast 

episode-url

Important for Programmatic, only if it is for podcast. 

URL de origen del episodio (contenido en podcast). 

Codificado mediante URL si se envía como cadena de consulta. 

Content, podcast 

episode-duration 

Important for Programmatic, only if it is for podcast. 

Episode duration, in seconds. 

Entero.

Content, podcast 

guid

Important for Programmatic, only if it is for podcast. 

ID de episodio 

String in the format of a UUID (universally unique identifier).

See 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.

Case-sensitive.

Valores válidos: 

  • m: male

  • f: female

  • o: other

Regulador 

gdpr_consent

HTTP Header: 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. The string must comply with the IAB Transparency and Consent Framework specifications.

URL-safe base64-encoded GDPR consent string of the form

GDPR_CONSENT_XXXXX 

where XXXXX is the tracking vendor’s numeric ID where the macro is being used.

Notas sobre el método de entrega

Below are the definitions of the delivery-method valores.

  • streaming: Endless flow of content, such as live radio. The user session ends only when the device closes the connection. El contenido se recupera a medida que se consume. Esto también se aplica a los servicios de música bajo demanda. For "live" on-demand performances, where new content is constantly added to the playlist as current content is consumed, the value of delivery-method should be empty.

  • download: Pre-recorded or finite single content, such as a podcast. The user session ends once the content is downloaded or before, if the user disconnects midway. 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: Also called progressive download, is for the same type of pre-recorded or finite content as the download delivery method but the content is retrieved as it is consumed. 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 conforms to the General Data Protection Regulation (GDPR). La GDPR fue promulgada por el Parlamento Europeo y el Consejo de la Unión Europea.

Triton Digital is a registered and approved vendor under the Global Vendor List (GVL) TCF v2.0. maintained by the Interactive Advertising Bureau Europe (IAB Europe). El ID de proveedor de Triton Digital en la GVL es 239.

© 2026 Triton Digital. Todos los derechos reservados.