Note: This page lists tracking URL macros for Liftoff Direct campaigns. If you run campaigns through Liftoff Accelerate, please refer to the Accelerate Tracking URL Macros page instead. If you’re not sure which applies to you, please reach out to your Liftoff Account Team for support.
This page lists the macros that Liftoff can send to third-party tracking providers for Direct campaigns. The parameters labelled *required are necessary in your postback to attribute correctly.
Liftoff Direct Macros
| Macro | Description |
|---|---|
{{{aaid}}} *required
|
Google's Play Services identifier for advertisers, lowercase version of the device AAID (if available) |
{{{ad_tracking_disabled}}} |
If 'do not track' is enabled |
{{{ad_tracking_enabled}}} |
If 'do not track' is disabled |
{{{ad_type}}} |
Type of ad (for example, rewarded, interstitial, banner, mrec) |
{{{age}}} |
Device user age |
{{{app_id}}} *required
|
Liftoff Advertiser mongo id (not required for adjust) |
{{{bid_currency}}} |
Always 'USD' |
{{{bid_price}}} |
Bid price (for example, 0.60) |
{{{bid_type}}} |
Campaign rate type (view/install/complete) |
{{{browser_user_agent}}} |
Device browser User Agent |
{{{campaign_id}}} |
The delivery campaign ID for this request |
{{{campaign_name}}} |
The delivery campaign name for this request |
{{{carrier_name}}} |
Carrier at the time of request |
{{{city}}} |
Device city |
{{{connection_type}}} |
Connection type (wifi, mobile) |
{{{country}}} |
2-letter country code |
{{{country_name}}} |
Standard country name |
{{{creative}}} |
The delivery creative name for this request |
{{{creative_id}}} |
The delivery creative ID for this request |
{{{custom_creative}}} |
Customer-designed Creative Name (as opposed to the long, cryptic Creative Name assigned by Liftoff) |
{{{device_amazon}}} |
One of [phone, tablet] based on device make/model and dimensions |
{{{device_android}}} |
One of [phone, tablet] based on device make/model and dimensions |
{{{device_id}}} |
Lowercase version of the device ID |
{{{device_ios}}} |
One of [iphone, ipad, ipod] based on device OS and model |
{{{device_model}}} |
Device model (for example, Galaxy S1) |
{{{device_platform}}} |
Device OS (iOS, Windows, Android) |
{{{device_windows}}} |
One of [phone, tablet] based on device make/model and dimensions |
{{{eid}}} |
Event ID on the ad server/bidder side |
{{{gender}}} |
Device user gender |
{{{id}}} *required
|
Same as eid
|
{{{ifa}}} *required
|
Lowercase version of the device IFA (if available) |
{{{ip}}} |
Device IP |
{{{is_coppa_compliant}}} |
If publisher is set to be COPPA-compliant |
{{{isu}}} |
Lowercase version of the device ISU (if available) |
{{{language}}} |
Device language in ISO 639-1 format |
{{{latitude}}} |
Device latitude |
{{{longitude}}} |
Device longitude |
{{{max_duration}}} |
Publisher-requested maximum video duration |
{{{min_duration}}} |
Publisher-requested minimum video duration |
{{{os_version}}} |
Device OS version (for example, 10.0.1/9.2.0) |
{{{placement_id}}} |
Identifier for publisher-side placement |
{{{pub_app_market_id}}} |
Market ID of the publisher on the app store |
{{{pub_app_name}}} |
Publisher app name |
{{{pub_app_store_category}}} |
Publisher app category (from dashboard) |
{{{pub_app_store_url}}} |
Publisher app store URL |
{{{region}}} |
Device region |
{{{screen_height}}} |
Device screen height |
{{{screen_orientation}}} |
Based on width/height, one of [landscape, portrait] |
{{{screen_width}}} |
Device screen width |
{{{site_id}}} |
Liftoff internal publisher app ID |
{{{site_name}}} |
Publisher app name |
{{{sk_campaign_id}}} |
SK Campaign ID used for this ad |
{{{sound_enabled}}} |
Whether device is muted (true/false) |
{{{timezone}}} |
Standard device timezone name |
{{{trackable_device_id}}} |
Lowercase version of device ID, if 'do not track' is not enabled |
{{{user_agent}}} |
Liftoff SDK user agent (for example, LiftoffDroid/2.0.1) |
{{{video_filename}}} |
Video file name of the delivered ad |
{{{volume}}} |
Device volume at the time of request (a float between 0-1) |
Macro Helpers
boolean_number |
|
boolean_string |
|
lowercase |
For example: {{{lowercase device_id}}}{{{lowercase aaid}}}
|
md5 |
|
sha1 |
|
uppercase |
For example: {{{uppercase device_id}}}{{{uppercase ifa}}}
|
For additional parameters or assistance, contact tech-support@vungle.com