Skip to main content
Getting Started with Tune
Updated over a week ago

In order to start using the integration in Tagger, please go to Integrations and enable TUNE.

After enabling the integration, you will need to perform certain steps on your website in order to be able to successfully track conversions. The next step you have to make is to enable Postback URL Tracking in your Store.

Enabling Postback URL Tracking

What is Postback URL Tracking?

Server postback tracking, also called “postback tracking” and “server-side tracking”, is the method of tracking conversions that uses the advertiser’s server rather than the user’s browser. The website has to store the information it receives from a redirect link, and later on send it to the tracking system (in our case TUNE), once the conversion happens.

Why is it a good method?

Postback Tracking is currently the go-to method when it comes to Affiliate Marketing and is also the recommended method by our partner, TUNE. The main advantage over other, client-side tracking methods, is the fact that Postback Tracking is not relying on cookies.

The tracking methods relying on cookies are prone to being unreliable, as ad blockers or simply clearing cookies can affect their accuracy. Fortunately, this is not an issue with Postback Tracking.

Initial setup

Initial setup needs to be performed on your side and its exact form may heavily depend on your infrastructure.

Manual Implementation

In the most basic form, Affiliate Tracking can be implemented into any system by adding supporting for two types of events: “Click” (where your page needs to save information about the transaction ID) and “Conversion” (where your page needs to create a request including saved transaction ID and conversion amount data).

Step 1/2: Receive and store parameters from the “Click” event

A unique Tracking Link will be generated for each Creator in a Campaign. For each customer that has used the Creator’s link, a unique Transaction ID will be generated and appended as a parameter to this link.

The website on which you expect the conversions to happen has to be ready to retrieve the mentioned Transaction ID from the link and store it throughout the whole session, up until the conversion point. Based on this Transaction ID, we will be able to assign the conversion statistics to appropriate Creators. An example of a tracking link can look like this:

https://a.taggermedia.com/aff_c?offer_id=25&aff_id=14078

which will ultimately redirect to

https://examplestore.com?transaction_id={transaction_id}

Step 2/2: Send the parameters in the “Conversion” event

When a conversion happens, the necessary data has to be sent over to TUNE. This includes the Transaction ID, as well as the conversion amount, in order to be able to attach it to a specific conversion. The Postback URL, while still subject to change, will look similar to the line below:

https://a.taggermedia.com/aff_l?transaction_id={transaction_id}&amount={amount}


where transaction_id is the parameter which was acquired from the tracking link, and the amount is the monetary value of the conversion. The advertiser should use an HTTP GET request to fire postbacks to TUNE.

For example, for conversion of $250, your final Postback URL should look like the following: https://taggermedia.go2cloud.org/aff_l?transaction_id=123456789&amount=250.

⚠️ All Conversions should be normalized to the Campaigns’ currency before sending the numerical value in the Postback URL.

Google Tag Manager Implementation

If you are using Google Tag Manager, it’s possible to use dedicated TUNE Tag template in order to easily support “Click” and “Conversion” events. This Tag has built-in support for storing the appropriate transaction_id value and appending it to a Conversion event.

A prerequisite for correct implementation is defining a GTM Trigger which correctly identifies when a conversion event happens and having the amount value stored in a GTM Variable.

Technical documentation for adding TUNE Tag to Google Tag Manager instance is available here:

Configuration details:

  • Network ID = taggermedia

  • Network Domain = https://a.taggermedia.com

  • When configuring Click event, there is no need to add any default or override parameters.

  • When configuring Conversion event, you have to add one custom parameter called amount:

    • name = amount

    • value = GTM variable storing the monetary value of the conversion (converted to an appropriate currency)

TUNE Tracking Setup for Shopify

The TUNE Javascript SDK enables Shopify customers to track conversion activity on their Shopify stores, and send conversion amounts back to TUNE for visualization on Tagger.

Code snippets must be placed in two different locations:

  • theme.liquid master template

    • Navigate to the theme.liquid master template by selecting Themes under Online Store and clicking on Actions > Edit Code.

    • Select theme.liquid in the menu on the left under Layout

    • Paste the following tracking snippet at the top of the file right below the first <head> tag

<script> 
!function(){var o=window.tdl=window.tdl||[];if(o.invoked)window.console&&console.error&&console.error("Tune snippet has been included more than once.");else{o.invoked=!0,o.methods=["init","identify","convert"],o.factory=function(n){return function(){var e=Array.prototype.slice.call(arguments);return e.unshift(n),o.push(e),o}};for(var e=0;e<o.methods.length;e++){var n=o.methods[e];o[n]=o.factory(n)}o.init=function(e){var n=document.createElement("script");n.type="text/javascript",n.async=!0,n.src="https://js.go2sdk.com/v2/tune.js";var t=document.getElementsByTagName("script")[0];t.parentNode.insertBefore(n,t),o.domain=e}}}();

tdl.init("https://a.taggermedia.com")
tdl.identify()
</script>
  • Order Status page / additional scripts

    • Click on Settings > Checkout and Account then go to the Order status page section. In the Additional Scripts box, paste the following script

{% if first_time_accessed %} 
{% unless checkout.discount_applications[0].type == 'discount_code' %}
<script>
!function(){var o=window.tdl=window.tdl||[];if(o.invoked)window.console&&console.error&&console.error("Tune snippet has been included more than once.");else{o.invoked=!0,o.methods=["init","identify","convert"],o.factory=function(n){return function(){var e=Array.prototype.slice.call(arguments);return e.unshift(n),o.push(e),o}};for(var e=0;e<o.methods.length;e++){var n=o.methods[e];o[n]=o.factory(n)}o.init=function(e){var n=document.createElement("script");n.type="text/javascript",n.async=!0,n.src="https://js.go2sdk.com/v2/tune.js";var t=document.getElementsByTagName("script")[0];t.parentNode.insertBefore(n,t),o.domain=e}}}();

tdl.init("https://a.taggermedia.com")
tdl.convert(
{
'amount':'{{ total_price | money_without_currency | remove: ',' }}',
}
)
</script>
{% endunless %}
{% endif %}

Testing your Postback Implementation

To test that you’ve correctly configured your store to send conversions back to Tagger via postback link:

  1. Create a Campaign in Tagger,

  2. Create an Affiliate Offer,

  3. Add a Creator to the Campaign and Hire them. This can be any Creator and they do not need to be contacted. We simply need to generate an affiliate link and to do so, there must be an associated Creator in the Campaign,

  4. Visit the Affiliate component in Creator View. Copy the link, paste it into your browser

  5. Create a conversion in your store, simulating the experience your consumer will have while shopping.

  6. If configured correctly, the conversion should then be registered in TUNE and Tagger. You’ll then see the conversion recorded in the Campaign Summary.

⚠️ Please note that conversions might take up to an hour to be displayed in Tagger.

Did this answer your question?