Passing Information via Offer URL

Offer URLs carry information about clicks from you to your advertiser through a combination of parameters, values, and macros. You can pass values like transaction IDs, partner sub IDs, and various mobile device identifiers through to the landing page.

In this article, we go over how to set up your offer URLs to pass information into your advertiser’s parameters. At the bottom, we also include reference tables of all the macros you can use in an offer URL.

This article is part of our Platform Basics series.

Inserting Macros in Offer URLs

If your advertiser wants a value stored by TUNE, insert the macro for that data in the corresponding parameter. Work with your advertiser to ensure that any data you insert using macros matches up with their expectations for each parameter of the offer URL.

Some values stored by TUNE come from external sources. When using macros for these values, the values must also be requested from your publisher via parameters in the partner tracking link. Common values requested and stored include partner sub-IDs, Apple advertising IDs, and Google advertising IDs.

Example: Mobile Tracking Macros

Your advertiser wants to internally validate mobile attribution data based on using Google advertising IDs. The advertiser needs to track in real-time, so they request the data from you via parameters in the offer URL.

Because the Google advertising ID comes from the publisher, it needs to be requested via the partner tracking link. To do this, you append the appropriate parameter (google_aid) to the partner tracking link. You also give it a placeholder value (like “GOOGLEAID”) so your publisher knows where to provide the value:

http://demo.go2cloud.org/aff_c?offer_id=1001&aff_id=2002&google_aid=GOOGLEAID

Now to forward the data, you set up the offer URL. Let’s say you receive the following offer URL from your advertiser:

http://www.advertisersite.com/landing?offerid=OFFERID&trans=TRANSACTIONID&googleaid=GOOGLEAID

In the above link, the two bolded placeholder values come from TUNE, so you replace them with the corresponding TUNE macros {offer_id} and {transaction_id}:

http://www.advertisersite.com/landing?offerid={offer_id}&trans={transaction_id}&googleaid=GOOGLEAID

The third value being requested in the link is a user’s Google advertising ID. To include this information, you insert the TUNE macro corresponding to that advertising ID ({google_aid}) as the value for your advertiser’s parameter:

http://www.advertisersite.com/landing?offerid={offer_id}&trans={transaction_id}&googleaid={google_aid}

At this point, you can insert the offer URL into your offer. Then when a click happens, TUNE replaces macros in the above offer URL with their respective values before sending data to your advertiser’s tracking system.

Table of Macros

The following TUNE macros can be used in offer URLs:

Mobile Tracking Macros

When you want to store additional information about the attribution of mobile app installs or events, you can do so using our mobile tracking parameters. The TUNE mobile tracking macros correspond to those parameters and are often used to communicate unique identifiers to another tracking system for attribution validation.

In your offer URLs, you can support mobile device attribution using the following mobile tracking macros: