Customizing a Conversion Link

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.

Conversion Link Parameters

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:

  • adv_sub
  • adv_sub2
  • adv_sub3
  • adv_sub4
  • adv_sub5

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.

Sale Amount

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:

  • amount

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:

  • conversion_unique_id

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:

  • payout
  • revenue

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:

  • security_token

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:

  • status

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:

Parameter Description
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:

Parameter Description
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