All Collections
Conversion Pixels, Tracking, and Reporting
Tracking Push performance data in third-party tracking software
Tracking Push performance data in third-party tracking software
RTX Platform Support avatar
Written by RTX Platform Support
Updated over a week ago

Track Push performance data in your tracking platform by appending our tracking macros to your creative URLs.

You can find performance data for your campaigns anytime in RTX Platform reporting, however, if you're using a third party tracking platform such as Voluum or Cake, you can pass performance data from RTX Platform to your tracker.

What are tracking macros?

If you use a third party platform to track campaign performance, you can append macros to your creative URL that enable cross-platform campaign tracking. When a user lands on your creative URL, your macros dynamically populate the appropriate data and pass it to your tracking platform.

TIP: You can use content macros to generate dynamic content on your creatives. Learn more.

The following macros are available for third party tracking for Push campaigns:

  • {BID_PRICE} (Push Only) - The CPC you paid when a user clicked your creative

  • {CAMPAIGN_ID} - The ID of the campaign that received the click

  • {CAMPAIGN_NAME} - The name of the campaign that received the click

  • {ADGROUP_ID} - The ID of the ad group that received the click

  • {ADGROUP_NAME} - The name of the ad group that received the click

  • {CREATIVE_ID} - The ID of the creative that received the click

  • {CREATIVE_NAME} - The the name of the creative that received the click

  • {COUNTRY} - The country of the user who clicked the creative

  • {REGION} - The region of the user who clicked the creative

  • {STATE} - The state of the user who clicked the creative

  • {CITY} - The city of the user who clicked the creative

  • {DEVICE_TYPE} - The device type the click came from (Desktop, Mobile, Tablet, or Other)

  • {DEVICE_MAKE} - The make of the device the click came from (i.e., Apple, Samsung, etc.)

  • {DEVICE_MODEL} - The device model the click came from (i.e., Generic Android, Acer, Apple, etc.)

  • {BROWSER} - The browser the click came from (i.e., Chrome, Firefox, Edge, IE, Safari, Opera, or Other)

  • {OS} - The operating system the click came from (Mac OS, Windows, iOS, Android, or Other)

  • {CONNECTION} - The type of connection that the user was using when the click occurred (Cable/DSL, Cellular, Corporate, Dial-Up, or Unknown)

  • {CARRIER} - The mobile carrier of the user who clicked the creative, if a mobile impression (i.e., AT&T, Sprint, Verizon Fios, etc.)

  • {SUBSCRIPTION_AGE} (Push only) - The number of days the user who clicked the creative has been subscribed to Push Notifications. NOTE: Certain traffic sources do not pass subscription age. When the subscription age is not passed, you will see a blank value.

  • {IP} - The IP address of the user who clicked the creative

  • {CHANNEL} - The channel that served the impression for the creative that was clicked

  • {TARGET_TYPE} - The source that the click occurred on (Site or App)

  • {TARGET_VALUE} - The site or app that served the impression for the creative that was clicked

  • {PUBLISHER} - The publisher that served the impression for the creative that was clicked

  • {CLICK_ID} - The unique identifier for each click, required when a server-to-server conversion pixel is being used. Can also be used to track click IDs when uploading conversions. NOTE: To use a server-to-server pixel, you must append {click_id} to your creative URL. Your tracking system must extract the click id and then pass it back via the "b" parameter in the server-to-server call upon conversion. Learn more about installing server-to-server pixels.

NOTE: Macros are not case sensitive.

TIP: When you're appending tracking macros to your creative URLs, be sure to pass back the {CAMPAIGN_NAME} and/or {CAMPAIGN_ID} macro(s) in addition to the {ADGROUP_NAME} and/or {ADGROUP_ID} macro(s) in case you have the same or similar names for ad groups across multiple campaigns.

How should I structure my creative/tracking URL?

Tracking URLs have multiple parts. The first part of the tracking URL is the URL of your landing page, followed by a question mark (?) as the first parameter's prefix, then the first parameter, an equal sign (=), and the macro that corresponds with the preceding parameter. Here's an example of how a URL might look if you're tracking a campaign's ID:

In the example above, "campaign" is the parameter and "{campaign_id}" is the macro being passed through the parameter.

NOTE: The parameters you use to append each macro will vary depending on your tracking platform. For example, some platforms may require {country} to be passed into the "country" parameter (i.e. country={country}), while others may use "geo" as the parameter (i.e. geo={country}). Consult your tracking platform to find the correct parameters to use with our macros.

You can append multiple parameters and macros by prepending an ampersand (&) to each additional parameter. For example:

NOTE: Some tracking platforms require multiple macros to be passed into a single parameter. For example, you may append "campaigncountry={campaign_id}-{country}" or "campaigncountry={campaign_id}|{country}" to track the ID of the campaign that received the click and the country of the user who clicked the creative. Consult your tracking platform to verify the correct structure for tracking multiple macros.

When a user lands on a URL containing macros, each macro will be replaced by the appropriate data. This data is called a value. For example, if a campaign with the ID 1234 matches on the site example.com, and a user in the United States clicks on your creative, your tracking URL would change from this:

...to this:

Your tracking platform will then capture the values populated by each macro in the URL, which is how it collects the data for your reports.

TIP: You can also bulk append or remove URL parameters + macros across multiple creatives on any page where you can view Push creatives. Just check the boxes of the creatives you want to edit, select "Edit" and then "Add URL Parameter" or "Remove URL Parameter" from the dropdown.

NOTE: If you edit your creative/tracking URL at any time, the creative will revert to a "pending" approval status until it is reviewed by our compliance team.

__________________________________________________________________

Tracking conversion data outside RTX Platform

If you'd like to track conversion data in RTX Platform and your third-party tracker or affiliate network, you'll need to install a conversion pixel. We've created documentation for tracking conversion data both in RTX Platform as well as several popular tracking platforms and networks:

Did this answer your question?