VAST Ad Tag Tokens

You can add tokens to your VAST ad tag. Each time your app requests an ad, Bamboo replaces the token with the real value.

In this article:

  1. How to use tokens: replace values in your ad tag
  2. Supported tokens: the full list

How to use tokens

Find the parameter in your ad tag, by its short form, and put the matching token after the =. For example, w= becomes w=[PLAYER_WIDTH].

Add your tag in Monetization → Ads, as your Mobile Ad Tag or TV Ad Tag. Using the app store tokens? Fill in your store details under Ad Token Requirements.

Supported tokens

Name Short form Token
Player width w, width [PLAYER_WIDTH]
Player height h, height [PLAYER_HEIGHT]
Media ID content_id, video_id [MEDIA_ID]
Media title content_title, video_title [MEDIA_TITLE]
Media description video_description [MEDIA_DESCRIPTION]
Media duration content_length, video_duration [MEDIA_DURATION]
Media URL content_url, video_url [MEDIA_URL]
Content genre content_genre [GENRE]
Content category content_cat, content_categories [CATEGORY]
Content season content_season [CONTENT_SEASON]
Live stream content_livestream [CONTENT_LIVESTREAM]
Content producer name content_producer_name [CONTENT_PRODUCER_NAME]
Rating rating, content_rating [RATING]
Channel name channel_name [CHANNEL_NAME]
Device ID did, device.ifa [DEVICE_IDENTIFIER]
IFA ifa, idfa, adid [UUID]
IFA type ifa_type [IFA_TYPE]
Device model dmo, device_model [DEVICE_MODEL]
Platform os, device_make, device_os [DEVICE_PLATFORM]
IP ip, uip [DEVICE_IP_ADDRESS]
User agent ua [DEVICE_USER_AGENT]
Country mcc [DEVICE_MOBILE_COUNTRY_CODE]
Mobile network mnc [DEVICE_MOBILE_NETWORK_CODE]
Time zone
[DEVICE_TIME_ZONE]
Device locale lang [DEVICE_LOCALE]
Device language
[DEVICE_LANGUAGE]
User latitude lat, geo_lat, AV_LATITUDE [LAT]
User longitude lon, geo_lon, AV_LONGITUDE [LON]
App name app_name, an [APPLICATION_NAME]
App version app_version, av [APPLICATION_VERSION]
App bundle ID b, app_bundle [APPLICATION_BUNDLE]
App ID msid, app_id [APPLICATION_ID]
App Store URL app_store_url, aurl [APP_STORE_URL]
Do not track is_lat, lmt [DEVICE_DO_NOT_TRACK_FLAG]
CCPA ccpa, us_privacy [CCPA]
GDPR gdpr [GDPR]
GDPR consent consent [CONSENT]
COPPA coppa [COPPA]
Supply chain schain [SCHAIN]
Cache buster cb, cachebuster [CACHEBUSTER]
Timestamp ts [TIMESTAMP]
Page URL (web) URL, site_full_url [URL]

Learn more: Monetization: Ads, Pay-Per-View & Giving · Content Settings

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.