All Collections
Manage your Creatives
Macros support for Tracking Links
Macros support for Tracking Links
Team IQM avatar
Written by Team IQM
Updated over a week ago

IQM, a Demand Side Platform (DSP), supports various macros that advertisers can use when creating tracking links. Tracking links are special URLs designed to monitor and measure the performance of advertising campaigns. These macros act as placeholders within the tracking links, allowing for dynamic insertion of relevant information at runtime. These macros provide valuable insights into campaign engagement, targeting, and user behavior for advertisers.

In this article, we will explore how each macro can be used and provide examples that show how they can be used to customize tracking links and capture specific data points related to ad interactions, user devices, campaign details, and more. Let's dive into the details of each macro and how you can leverage them more effectively in your tracking links..

Macros

Macros

Explanation

{BIDDER_CREATIVE_CLICK_URL}

Click URL of the bidder's creative.

{IAA_AD_PLATFORM}

Ad platform being used.

{IAA_ADVERTISER_ID}

Unique identifier of the advertiser.

{IAA_APP_BUNDLE_ID}

Bundle ID of the mobile application.

{IAA_APP_ID}

Unique identifier of the mobile application.

{IAA_APP_NAME}

Name of the mobile application.

{IAA_BID_PRICE}

Bid price for the impression.

{IAA_CACHE_BUSTER}

Cache-busting value to ensure fresh ad serving.

{IAA_CAMP_BID}

Bid value for the campaign.

{IAA_CAMP_TYPE}

Type of campaign, such as display or video.

{IAA_CAMPAIGN_ID}

Unique identifier of the campaign.

{IAA_CAMPAIGN}

Name or description of the campaign.

{IAA_CARRIER_NAME}

Name of the mobile carrier.

{IAA_CLICK_URL}

Click URL for tracking purposes.

{IAA_CONTENT_LENGTH}

Length of the content.

{IAA_CONVERSION_ID}

Unique identifier for conversions.

{IAA_COUNTRY_CODE}

Country code of the user's location.

{IAA_CREATIVE_ID}

Unique identifier of the creative.

{IAA_CREATIVE_SIZE}

Size specifications of the creative.

{IAA_DEVICE_ID}

Unique identifier of the user's device.

{IAA_DEVICE_LAT}

Latitude of the user's device location.

{IAA_DEVICE_LON}

Longitude of the user's device location.

{IAA_DEVICE_OS_NAME}

Name of the user's device operating system.

{IAA_DEVICE_PLATFORM_ID}

Platform ID of the user's device.

{IAA_DEVICE_UA}

User-Agent string of the user's device.

{IAA_EXCH_REQ_ID}

Exchange-specific request identifier.

{IAA_EXCHANGE_NAME}

Name of the exchange.

{IAA_GEO_REGION}

Geographical region of the user's location.

{IAA_GOTV_MAP_URL}

URL for the map related to the user's location.

{IAA_GPS_LAT}

GPS latitude of the user's device location.

{IAA_GPS_LON}

GPS longitude of the user's device location.

{IAA_GPS_SOURCE_LAT}

Source latitude of the user's device location.

{IAA_GPS_SOURCE_LON}

Source longitude of the user's device location.

{IAA_IMPRESSION_ID}

Unique identifier of the impression.

{IAA_ISP_CELLULAR}

Indicates if the ISP is cellular.

{IAA_LOCATION_RADIUS}

Radius of the user's location.

{IAA_MANUFACTURER_NAME}

Name of the device manufacturer.

{IAA_MAP_API_KEY}

API key for mapping services.

{IAA_MODEL_NAME}

Name of the device model.

{IAA_MRAID_VERSION}

Version of the MRAID (Mobile Rich Media Ad Interface Definitions).

{IAA_OS_CLASS}

Classification of the device operating system.

{IAA_PAGE_URL}

URL of the page where the ad is displayed.

{IAA_PUBLISHER_ID}

Unique identifier of the publisher.

{IAA_SELLER_ID}

Unique identifier of the seller.

{IAA_SITE_ID}

Unique identifier of the site.

{IAA_SITE_PLATFORM}

Platform of the site.

{IAA_SSAI_INTEGRATION}

Indicates if SSAI (Server-Side Ad Insertion) integration is used.

{IAA_STATE_NAME}

Name of the state or province.

{IAA_SUPPLY_TYPE}

Type of supply, such as app or website.

{IAA_TICKER_URL}

URL for ticker-related information.

{IAA_TIMESTAMP}

Timestamp of the event.

{IAA_TRACKING_CLICK_URL_ESC}

Escaped version of the tracking click URL. This macro should be used for 3rd party click trackers. This is the encoded version.

{IAA_TRACKING_CLICK_URL}

Tracking click URL for measurement purposes. This macro should be used for 3rd party click trackers.

{IAA_UNIX_TIMESTAMP}

Unix timestamp of the event.

{IAA_USER_ID}

Unique identifier of the user.

{IAA_USER_IP}

IP address of the user.

{IAA_WIN_URL}

URL for winning impressions.

{US_PRIVACY}

Placeholder for privacy-related information (specific to US privacy regulations).

Example

To better understand the usage of macros, let's consider a hypothetical scenario where an advertiser is running a mobile advertising campaign with the following details:

Campaign Name: "Summer Sale 2023" Creative ID: 12345678 Device ID: ABC123DEF456

Using the macros in the tracking links, here's how the respective macros would be populated:

  • {IAA_CAMPAIGN}: Summer Sale 2023

  • {IAA_CREATIVE_ID}: 12345678

  • {IAA_DEVICE_ID}: ABC123DEF456

For instance, if the tracking link includes the macro {IAA_CAMPAIGN} and is clicked by a user on a device with the ID ABC123DEF456, the macro will be replaced with the actual campaign name, resulting in a personalized tracking link like:

By incorporating these macros into your tracking links, you can effectively capture and analyze campaign-specific information, creative identifiers, and device identifiers to gain valuable insights into the performance and engagement of your advertising efforts.

Leveraging macros in tracking links allows advertisers to effectively track and measure the performance of their campaigns on the IQM DSP. Experiment with these macros to tailor your tracking links and gain valuable insights into campaign engagement, targeting, and user behavior.

For further assistance or inquiries, please reach out to our support team at support@iqm.com

Did this answer your question?