In the following lists, you can find all the macros supported in Bucksense console.

CLICK URL

Click URL Macros are special variables that can be added, when you create a new offer, into the click URL of an ad that is running on Bucksense console.
Every time an user clicks on your ad, our server replaces the macro with dynamic informations about the click, before redirect the user to the URL where you want your clicks to arrive (your landing page URL).

Bucksense IDs for Device Information*  Macro
IP of the Client {device_ip}
Device Type ID (i.e. Desktop, Smartphone) {device_type_id}
Device Make ID {device_make_id}
Device Model ID {device_model_id}
Device OS ID {device_os_id}
Device OS Version ID {device_osv_id}
Device Browser ID {device_browser_id}
Device Browser Version ID {device_browser_version_id}
Device Carrier ID {device_carrier_id}
Bucksense IDs for Supply Information* Macro
Supply ID (i.e. App or Site) {supply_type}
Exchange ID {exchange_id}
Publisher ID {pub_id}
Placement ID {place_id}
Campaign ID {campaign_id}
Creative ID {creative_id}
Bucksense Transaction IDs Macro
Impression ID* {session_bid_id}
Click ID {transaction_id}
Device Identifiers for iOS* Macro
IDFA (Only available for In-App inventory) {device_ios_ifa}
Hardware ID hashed SHA1 {device_ios_didsha1}
Hardware ID hashed MD5 {device_ios_didmd5}
Platform ID hashed SHA1 {device_ios_dpidsha1}
Platform ID hashed MD5 {device_ios_dpidmd5}
Bucksense ID for Location Information* Macro
Country of device {device_country}
Region ID {device_region_id}
City ID {device_city_id}
Bucksense Click Macros Macro
Offer ID {offer_id}
Publisher ID {publisher_id}
Data passed in ts1 or publisher_src1 parameter {publisher_src1}
Data passed in ts2 or publisher_src2 parameter {publisher_src2}
Data passed in ts3 or publisher_src3 parameter {publisher_src3}
Data passed in ts4 or publisher_src4 parameter {publisher_src4}
Data passed in ts5 or publisher_src5 parameter {publisher_src5}
Data passed in ts6 or publisher_src parameter {publisher_src6}
Device Identifiers for Android* Macro
Google AID (Only available for In-App inventory) {device_android_ifa}
Hardware ID hashed SHA1 (e.g. IMEI) {device_android_didsha1}
Hardware ID hashed MD5 (e.g. IMEI) {device_android_didmd5}
Platform ID hashed SHA1 (e.g. Android ID) {device_android_dpidsha1}
Platform ID hashed MD5 (e.g. Android ID) {device_android_dpidmd5}
Mac Address for iOS or Android* Macro
Hashed SHA1 {device_macsha1}
Hashed MD5 {device_macmd5}

Note: Items or sections marked with an asterisk (*) denote that the macro is only available for traffic generated by Bucksense’s RTB platform.

IMPRESSION TRACKING MACROS

Impression Tracking Macros can be added in your impression tracking url, for creatives campaign types, in order to get additional informations.
The macros string will be replaced with a value when the ad is served to the user.

Bucksense IDs for Device Information Macro
Entire url Encoded %%PAGE_URL_ENC%%
App Name Encoded %%APP_NAME_ENC%%
App Bundle Encoded %%APP_BUNDLE_ENC%%
App Store Url Encoded %%APP_STORE_URL_ENC%%
App Version Encoded %%APP_VERSION_ENC%%
Device Geo position Latitude %%DEVICE_LAT%%
Device Geo position Longitude %%DEVICE_LON%%
Campaign ID %%CAMPAIGN_ID%%
Bid Transaction ID %%SESSION_BID_ID%%
Supply Site or App %%SUPPLY_TYPE%%
Exchange ID %%EXCHANGE_ID%%
Publisher ID %%PUB_ID%%
Placement ID %%PLACE_ID%%
Domain Name Encoded %%DOMAIN_ENC%%
Android Identifier for Advertiser (Only available for In-App inventory) %%DEVICE_ANDROID_IFA%%
IOS Identifier for Advertiser (Only available for In-App inventory) %%DEVICE_IOS_IFA%%

Video Events TRACKING MACROS

These Macros allow you to get additional informations in your Video Events Tracking URLs.

Bucksense IDs for Device Information Macro
Random ID for cache prevent %%CACHE_BUSTER%%
Placement ID %%PLACE_ID%%
IOS Identifier for Advertiser (Only available for In-App inventory) %%DEVICE_IOS_IFA%%
Android Identifier for Advertiser (Only available for In-App inventory) %%DEVICE_ANDROID_IFA%%
Url to notify viewability %%VIEWABILITY_URL%%
Device IP address %%DEVICE_IP%%
Carrier ID* %%CARRIER_ID%%
Campaign ID %%CAMPAIGN_ID%%
Creative ID %%CREATIVE_ID%%
Bid Transaction ID %%SESSION_BID_ID%%

*Find here the Carrier ID list for all countries

VAST Tag MACROS

VAST Tag Macros are used to dynamically replace values in the VAST URL to pass informations about impressions to your AdServer.

Bucksense IDs for Transaction and Supply information Macro
Page url Encoded %%PAGE_URL_ENC%%
App Name Encoded %%APP_NAME_ENC%%
App Bundle Encoded %%APP_BUNDLE_ENC%%
App Store Url Encoded %%APP_STORE_URL_ENC%%
App Version Encoded %%APP_VERSION_ENC%%
Device Latitude %%DEVICE_LAT%%
Device Longitude %%DEVICE_LON%%
Campaign ID %%CAMPAIGN_ID%%
Session Bid ID %%SESSION_BID_ID%%
Supply Type %%SUPPLY_TYPE%%
Exchange ID %%EXCHANGE_ID%%
Publisher ID %%PUB_ID%%
Placement ID %%PLACE_ID%%
Domain Encoded %%DOMAIN_ENC%%
Video min duration %%V_MINDUR%%
Video max duration %%V_MAXDUR%%
Video heigth %%V_HEIGHT%%
Video width %%V_WIDTH%%

AD TAG MACROS

In case of Ad Tag campaigns you can add the macros in the code to pass traffic data to our system.

To set up Bucksense tracking, simply insert the provided Bucksense click tracking (%%CLICK_URL%%) and cache busting (%%CACHE_BUSTER%%) macros, to let our system know if your campaigns are being served correctly and performing.

Bucksense IDs for Transaction and Supply information Macro
Click URL %%CLICK_URL%%
Click URL Encoded %%CLICK_URL_ENC%%
Click Tracker Encoded %%CLICK_TRACKER_ENC%%
Click Tracker %%CLICK_TRACKER%%
Cache Buster %%CACHE_BUSTER%%
Device Longitude %%DEVICE_LON%%
App Bundle Encoded %%APP_BUNDLE_ENC%%
App Store Url Encoded %%APP_STORE_URL_ENC%%
App Version Encoded %%APP_VERSION_ENC%%
Device IOS (Only available for In-App inventory) %%DEVICE_IOS_IFA%%
Device IP %%DEVICE_IP%%
Placement ID %%PLACE_ID%%
Domain Encoded %%DOMAIN_ENC%%
Page url Encoded %%PAGE_URL_ENC%%
App Name Encoded %%APP_NAME_ENC%%
Device Latitude %%DEVICE_LAT%%
Viewability URL %%VIEWABILITY_URL%%
Carrier ID* %%CARRIER_ID%%
Campaign ID %%CAMPAIGN_ID%%
Session Bid ID %%SESSION_BID_ID%%
Supply Type %%SUPPLY_TYPE%%
Exchange ID %%EXCHANGE_ID%%
Publisher ID %%PUB_ID%%
Device ID (Only available for In-App inventory) %%DEVICE_ANDROID_IFA%%
Creative ID %%CREATIVE_ID%%

*Find here the Carrier ID list for all countries