URL Macro Variables Guide
Utilize these predefined macro variables for dynamic URL customization. Below is a breakdown of each variable and its typical replacement value.
Macro Variables
[vx_cache_buster]
A unique string to prevent caching of content.
Randomly generated string
[vx_width]
The width of the video in pixels.
1920
[vx_height]
The height of the video in pixels.
1080
[vx_gdpr]
GDPR compliance information. (Usually empty if GDPR is not applicable)
1
or 0
[vx_cookie_consent]
Indicates whether the user has consented to cookies.
1
or 0
[vx_appname]
The name of your application/site as configured.
MyAppName
[vx_app_id]
A unique identifier for your application, typically combining platform name and the app's name.
web.myappname.vodlix
[vx_latitude]
The latitude coordinate from the user's IP location.
52.5200
[vx_longitude]
The longitude coordinate from the user's IP location.
13.4050
[vx_timestamp]
A timestamp variable, often used for cache busting or tracking.
1609459200
(Unix Epoch)
[vx_device_type]
The type of device used, determined by checking if the device is mobile or not.
mobile
or desktop
[vx_device_os]
The operating system of the device.
iOS
, Android
, Windows
[vx_ip]
User's IP address, used for geotargeting and compliance with regional ad regulations.
127.0.0.1
[vx_app_bundle]
A unique identifier for your application, typically combining platform name and the app's name.
web.myappname.vodlix
[vx_app_store_url]
URL of the app on the app store, used in certain promotional campaigns.
https://example.com
[vx_device_id]
A unique identifier of the user's device, important for frequency capping and targeting.
f10a3034bb452013
[vx_us_privacy]
Indicates compliance with US privacy laws, essential for advertisers in the United States.
1
or 0
[vx_user_agent]
Indicates the browser or device user agent string of the user. Essential for identifying user environment.
The user agent string from the HTTP request, or 'unknown'
if not available.
[vx_lmt]
Indicates the tracking status of user, where 1 signifies the tracking is disabled.
1
or 0
[vx_ifa]
Represents the Identifier for Advertising (IFA), a unique identifier used for tracking and advertising purposes on mobile devices.
Advertising ID for Android and iOS
Session-based UUID for other cases
[vx_ifa_type]
Indicates the type of Identifier for Advertising (IFA) being used.
'aaid'
for Android
'idfa'
for iOS
'sessionid'
for other cases
[vx_iab_category]
Classifies content according to IAB content ta.
E.g., 'IAB1' for Arts & Entertainment, 'IAB2' for Automotive.
[vx_url]
This will only be accessible when viewed in a browser; it will not be available on the app
https://yoursite.com
[vx_content_url]
It will display the content URL, or you can also refer to it as the watch video URL
https://yoursite.com/watch/{content_id}/{content_title}
[
vx_av_url]
Watch video link or live link based on content type
https://vodlix.com/watch/video123
[
vx_session_app_name]
App name from session
ios_app
[
vx_content_id]
Video/content ID
123
[
vx_content_title]
URL encoded content title
The%20Great%20Movie
[
vx_content_episode]
Boolean - true if content is an episode
true
[
vx_content_season]
Season ID if content is an episode
2
[
vx_content_series]
Series ID if content is an episode
456
[
vx_content_cat]
Content type label (Movie, Series, etc.)
Movie
[
vx_content_keywords]
URL encoded content tags
action%2Cthriller%2Cadventure
[
vx_content_genre]
URL encoded genre from categories
Action%2CThriller
[
vx_s_source]
Video source URL
https://cdn.vodlix.com/videos/video123.mp4
[
vx_content_length]
Duration in seconds
7200
[
vx_content_language]
Content language
en
[
vx_content_rating]
MPAA rating
PG-13
[
vx_content_channel]
True if content type is 4 (live channel)
false
[
vx_content_context]
'Live' or 'VOD' based on content type
VOD
[
vx_network]
Network information
Netflix
[
vx_session]
Session ID
fda7v4up8u0fg7o6809g8r4jcj
Implementation
These macros are implemented within URLs in requests. They dynamically replace with relevant data.
Notes
It's important to ensure that these macros are correctly implemented to maintain the effectiveness and legal compliance of the ad delivery system.
Some macros might be optional or used only in specific scenarios based on the campaign requirements and regulations.
Last updated
Was this helpful?