Macros enable advertisers to collect more information from click or impressions trackers of their campaign. For example device ID, publisher ID, country code, etc. Macros are a string of text that can be included in any code that’s processed by the GeoSpot Media platform (third-party HTML tags, VAST tags, click-through URLs, impression pixels, etc.) and are dynamically replaced with their corresponding values.
When a Macro is implemented, it will be replaced by a value that is generated each time a bid takes place for an impression or click.
Macro to track Unique Click Id or Bid Id
{CONVERSION_ID} – Mandatory Macro required to track unique bid ID. This Macro is used to track your App/website events.
Example: Coversion_ID can be 2167783501-152389708-822-1-3-130-jdezs-a2c0ee2d104b48a9ba102cd3abe1665c-34-143684-50257831.
Sample click URL: https://geospot.media/signup?bid_id={CONVERSION_ID}
Sample impression URL: https://geospot.media/impression/signup?bid_id={CONVERSION_ID}
Other Supported Macros on GeoSpot Media Platform
Macro |
Value or Parameter Passed |
Example |
| {CAMPAIGN_NAME} | Campaign_Name provided by advertisers. | Amazon-US-App_CPM |
| {CREATIVE_NAME} | Creative_Name provided by advertisers. | Amazon_320x50 |
| {CAMPAIGN_ID} | Numeric internally generated | 210115 |
| {CREATIVE_ID} | Numeric internally generated | 5012938845 |
| {ORDER_ID} | Numeric internally generated | 107549 |
| {ADVERTISER_ID} | Numeric internally generated | 12345 |
| {EXCHANGE_NAME} | Exchange name | Mopub |
| {EXCHANGE_ID} | Geo Spot Internal Exchange Id | 23 |
| {PUBLISHER_ID} | Exchange specific alphanumeric ID for publishers. Example: Publisher_ID can be c475b45495a57e2e3a242542a98e249b |
c475b45495a57e2e3a242542a98e249b |
| {APP_NAME} | Publisher’s app name that is present in the bid request. (including special characters) | Amazon Shopping (for mobile app) or Amazon.com (for mobile site) |
| {APP_ID} | Exchange specific unique ID corresponding to the publisher app. | 3b3614b0d8814fceaad20 |
| {APP_DOMAIN} | The domain of the publisher site/app. | App_Domain can be vrtcl.com |
| {APP_BUNDLE} | Publisher app bundle. | iOS App Bundle: 234672221 and Android App Bundle: com.whatsapp |
| {APP_NAME_ALPHANUM} | Publisher’s app name after removing all the non-alphanumeric characters. | App_Name_alphanum can be “Color by number Coloring Book |
| {DEVICE_OS_NAME} | Operating System of the user’s device. | Example: Device_OS_Name can be Android or iOS. |
| {MANUFACTURER_NAME} | Device Manufacturer’s Name. | Manufacturer_Name can be Samsung |
| {MODEL_NAME} | Device Model Name. Example: |
Model_Name can be Galaxy M01. |
| {CARRIER_NAME} | Carrier Name of the user’s network. Example: |
Carrier_Name can be Vodafone |
| {USER_IP} | User’s IP Address for the impression or click. Example: |
User_IP can be 45.51.3.76 |
| {DEVICE_ID} | Device 15 digit IMEI number. Example: |
Device_ID can be 123456789009876 |
| {DEVICE_RAW_ID} | OS-specific Advertising ID of the Devicein RAW format if it is available in the RAW format in the bid request. Example: Device_Raw_ID can be 7e9547bd-3459-4ad1-870d-0c40a51f57bc |
7e9547bd-3459-4ad1-870d-0c40a51f57bc |
| {DEVICE_SHA1_ID} | OS-specific Advertising ID of the Device in SHA1 format if it is available in the SHA1 format in the bid request | 7b23aeac50a2cc97b7e5c0afdaf1a6045080ba0 |
| {DEVICE_PLATFORM_ID} | Unique OS-specific Advertising ID of the Device (For e.g, iOS it will be IOS_IDFA and for Android, it will be GAID). This Macro might fetch you the advertising ID in RAW, SHA1 or MD5 format depending on what is received in the bid request | raw_id:93ab398f-bcaf-4be9-9e88-55ffcef01728 |
| {COUNTRY_CODE} | User’s Country Code as defined by ISO-3166-1 alpha 3 standard | USA ( for the United States of America) |
| {STATE_NAME} | User’s State name | California |
| {STATE_CODE} | State Code as defined by ISO-3166-2 standard of all countries coded in ISO 3166-1 | US-CA (California state of the United State of America) |
| {CITY_NAME} | User’s City name | San Francisco. |
| {ZIP_CODE} | User’s Zipcode | 94105 (San Francisco Zipcode) |
| {GPS_LAT} | Latitude coordinates of the user’s device | 52.521802 |
| {GPS_LON} | Longitude coordinates of the user’s device | 23.898763 |
| {TIMESTAMP} | Unix TimeStamp of the click or impression served. | 1,59,35,61,601 |
| {DNT} | Do not track the value of a request (TRUE/FALSE). | TRUE or FALSE |
| {CACHEBUSTER} | Random number in the URL that is used to limit caching. | 3468392872 |
Note:
You can combine multiple Macros for tracking. For e.g., {EXCHANGE_ID}-{APP_ID}. This combination is particularly useful to WhiteList or BlackList based on placement ids.
HTML Creative Macro for Click Tracking
Macro |
Description |
| {CLICK_URL} | This macro is prefixed before the advertiser click URL. It is replaced by GeoSpot Click URL. |
| {CLICK_URL_ESC} | This Macro is added in the advertiser click URL. It is replaced by encoded escaped GeoSpot click URL. |
In case of any questions regarding the implementation of the macros, please write to support@geospotmedia.com or contact your account manager.