Conversion links are generated directly in TUNE, and there are many ways to tailor one to your needs. You can add parameters that help track certain campaigns or store values from an advertiser’s tracking system.
Below, we’ll introduce additional parameters you can use to customize a conversion link. We introduced parameters, values, macros, and how they fit into your workflow in our article on Parameters & Macros in TUNE.
This article is part of our Platform Basics series.
Depending on which tracking protocol your offer uses, its conversion link may include the transaction ID or offer ID parameter to attribute conversions. TUNE receives enough information to keep track of conversions for your offer with the parameters generated by default.
However, there are many instances where you or your advertiser may want to keep track of additional information. In those cases, you can add the following parameters to your conversion link for your advertiser to provide more data:
Advertiser Sub IDs
Advertisers can use advertiser sub IDs to pass values from their tracking systems on conversion. Sub IDs are typically used to help you and the advertiser quickly cross-reference conversion data to tailor a campaign. Advertisers use sub IDs to include information like:
- Order numbers from an e-commerce cart, so the conversion can be directly tracked
- SKU numbers of a produce ordered, to see trends with multiple products sold
- User email addresses, in the case of lead generation conversion
- Session IDs or transaction IDs of their tracking system
You can use up to five advertiser sub ID parameters:
You can group by these parameters in the stats and conversion reports. Not only that, but these parameters are also stored by TUNE and can be returned in partner conversion URLs via TUNE macros.
By default, advertiser sub ID values are invisible to your publishers. This is to protect advertisers who may want to share sensitive information with networks but not publishers. However, you can change this setting on the advertiser’s page.
Many e-commerce and similar advertisers establish offers based on percentage of sale. For TUNE to determine the correct rate for offers using cost-per-sale and revenue-per-sale options, that advertiser must pass the sale amount in the conversion pixel code or postback URL.
If you want this information, append the following parameter to your conversion link:
Your advertiser can then provide the desired information as a value in that parameter. For details on implementing this feature and viewing sale amount in reports, see our article about Recording Sale Amount on Conversion.
Customer List Values
When using our customer lists feature, parameters are automatically added to your conversion link. Your advertiser can use provide values like customer information, name, email address, and postal code in those parameters.
Note: Each data point in your customer list is passed as a separate custom parameter.
Unique Conversion ID
In some cases, you may need to reject conversions based on a value that isn’t the transaction ID.
For example, you can prevent a user from converting on an offer by rejecting the conversion based on IP address, mobile device ID, or e-commerce order number. To do so, use the following parameter:
Important: When enabled, this feature becomes the sole method of conversion de-duplication. Conversions with different unique IDs and the same transaction ID are not rejected as duplicates.
For details on enabling and implementing this feature, see our Limit Conversions by Unique ID article.
Payout & Revenue on Conversion
In some cases, you may want to dynamically communicate the payout that the publisher receives or the revenue that the advertiser provides. To enable this feature, go to Company > Customize Application > Settings > Tracking. On that page, set Specify amounts on conversion to “Enabled” and click Save once you’re finished.
Then you’ll be able to use the following parameters:
Specified amounts override all other payout and revenue settings. This includes the default offer payout, default offer revenue, tiered payout, tiered revenue, specific partner payout for the offer, and specific revenue for the offer.
Warning: This setting can be prone to abuse and should only be used for internal campaigns. There is no way to stop advertisers from adding values for your revenue or payout on conversion using these parameters.
Advertiser Security Token
The advertiser security token is a feature that authenticates each conversion with a token string unique to an offer’s advertiser. To use this feature, append the following parameter to your conversion link:
Have your advertiser pass their security token in the above parameter. Using this feature, you can expect to have another level of security from any potential fraud by publisher attempting to force-fire postback URLs. This feature is available only to enterprise accounts.
Status on Conversion
When this feature is enabled in the network tracking settings, conversion notifications can set the status of conversions using the following parameter:
A conversion status specified using this parameter overrides statuses determined through other conversion settings like fraud detection. Valid values for this parameter are: “approved”, “pending”, and “rejected”.
This feature is best used when the advertiser has their own fraud prevention system and wants to report fraudulent conversions as rejected. Additionally, this feature can be used to override a default “pending” conversion status for offers with the Conversion Approval tracking setting enabled.
Goal Reference ID
If you’re integrating TUNE with another measurement system, you may need to uniquely identify certain offer goals across systems. To do so, first identify them in TUNE using the goals’ reference ID field.
Then to measure conversions for a goal identified by a goal reference ID, replace the goal_id parameter of a conversion link with goal_ref.
Important: Goal reference IDs must be unique in your network to correctly attribute clicks and conversions. Using the same goal reference ID on multiple offers can lead to unexpected results in attribution.
Table of Parameters
The following TUNE parameters can be used in your conversion links:
|adv_sub||Advertiser sub ID 1|
|adv_sub2||Advertiser sub ID 2|
|adv_sub3||Advertiser sub ID 3|
|adv_sub4||Advertiser sub ID 4|
|adv_sub5||Advertiser sub ID 5|
|aff_id||ID of partner promoting the offer|
|amount||Amount of a generated sale (on conversion)|
|conversion_unique_id||Non-expiring unique IDs|
|goal_id||ID of goal for the offer|
|goal_ref||Reference ID of goal for the offer; only affects attribution and only when no goal ID is provided.|
|offer_id||Offer’s ID in TUNE|
|payout||Specified offer payout to publisher|
|revenue||Specified offer revenue from advertiser|
|security_token||Advertiser’s unique token string for conversion authentication|
|status||Conversion status as one of: “approved”, “rejected”, or “pending”|
|transaction_id||TUNE transaction ID|
Mobile Tracking Parameters
When you want to support mobile device attribution, you can use our mobile tracking parameters in your conversion links:
|google_aid||Google Android advertising identifier used to attribute clicks to installs for apps in the Google Play store|
|google_aid_sha1||SHA1 hash of the Google Android advertising ID|
|ios_ifa||Apple iOS advertising identifier (iOS 6+)|
|ios_ifa_sha1||SHA1 hash of iOS device’s IFA ID|
|ios_ifv||Apple iOS vendor identifier (iOS 6+)|
|unid||Catch-all for unknown mobile device identifiers|
|user_id||Application-specific user ID (generated by app developer)|
|windows_aid||Windows device advertising identifier|
|window_aid_sha1||SHA1 hash of the Windows advertising ID|