Reach Extension VAST Tag Cheat Sheet

placement-id

n/a

Required.

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

n/a

Required.

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

contract-secret

n/a

Required.

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

position

${position}

Required.

The ad position.

String.

Valid values: 

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

String.

Alpha-numeric characters, including the following list of special characters: 

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

ip

HTTP Header: X-Device-IP

${ip}

Required for server-to-server integrations.

IP address of the player/listener device.

For IPv4: Dotted decimal format. Example: 192.0.2.254 

For IPv6: Colon-separated hexadecimal characters conforming to IPv6 format. Example: 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.

Example: app:EBE52E703EE455AB3

timestamp

${timestamp}

Unix timestamp in seconds. 

ua 

HTTP Header: X-Device-ua 

${ua}

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

String.

Example: Mozilla/5.0 android-user-agent 

gdpr

${gdpr}

Flag indicating if General Data Protection Regulation (GDPR) regulations apply.

See GDPR. 

Integer.

Value values:

• 0: GDPR does not apply 

• 1: GDPR applies

gpp

HTTP Header: X-gpp 

${gpp_string}

GPP string allowing the transmission of privacy, consent, and consumer choice signals. The string must comply with the IAB Tech Lab Global Privacy Platform specification.

String.

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

Integer.

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. Version 1 only supports signals pertaining to the California Consumer Privacy Act (CCPA). The string must comply with the U.S. Privacy String format. 

String.

coppa 

${coppa} 

Flag indicating if Children's Online Privacy Protection Act (COPPA) regulations apply. COPPA was established by the U.S. Federal Trade Commission. 

0 = COPPA restrictions do not apply 

1 = COPPA restrictions apply 

bundle-id

${bundle-id}

Important for Programmatic. 

Only used for mobile app inventory, where it is required. 

Application identifier intended to be unique to the app and independent of the app store where it was distributed. 

String.

On Android and iOS, this should be a package name. Example: com.tritondigital.tritonradio

store-url

${store-url}

Important for Programmatic. 

Only for mobile app inventory. 

App store URL for an installed app making the ad request/stream connection. 

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. 

Example: 

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. The first category in the list will be considered as the main category. 

Triton RefData API

Requires JWT Bearer token.

Comma-separated list of integer values, each in the 1-698 range.  See IAB Category Usage Notes.

feed-type

${feed-type}

Required for the specific use-case where the inventory is offered to programmatic and ads requested through on-demand are stitched into a podcast. Can also be used for live stream.

See also delivery-method. 

String.

Valid values: 

• podcast 

• music 

• radio 

• game 

• pureplay 

• Replay 

• txt2speech 

content-language

${content-language}

The language of the content where ads will be played. This can be used in campaign targeting or to define a specific rule on the ad exchange. 

String.

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 mobile app inventory.

App store identifier for an installed app, used to locate the app within the specific store.

String.

Example for iTunes: 726533955 

Example for 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. For more information, see Authorized Digital Sellers (ads.txt). 

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

Example: 

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