Tune integration

Tune Integration Overview

Tune and AnyTrack's integration makes it easy to track the success of your campaigns. Conversion data is sent from Tune into AnyTrack, which then forwards it onto platforms like Google Ads, Facebook Conversion API, and TikTok API. With this setup you can measure conversions more accurately across multiple channels in one place - no manual uploading or editing required! Streamline your tracking process today with the best-in-class Tune & AnyTrack integration.

How does the Tune AnyTrack integration work:

1. Traffic: When visitors land on your website, AnyTrack collects traffic source data and First Party data.
2. Engagements: When visitors click on your Tune affiliate links, AnyTrack does a few things:
   1. Collects granular data tied to the OutboundClick.
   2. Triggers Event Tracking API requests to your pixels and analytics.
3. Conversions: When visitors convert on the merchant's website, AnyTrack receives real time conversion data through Postback URL.
4. Attribution: AnyTrack processes the conversion data and reports it across various reporting sections of the Anytrack Dashboard.
5. Conversion API: AnyTrack then sends your conversions to your Ad Platforms' Conversion API so you can feed your ad platform's Machine Learning, AI and automatic optimization according to 100% of your conversion data.

Technical details

Standard Conversions

The Tune Postback URL

The Postback URL is fully pre-defined and ready to be implemented with your Tune account.

https://t1.anytrack.io/hBtoE3hN/collect/tune-test?aff_click_id={aff_click_id}&offer_id={offer_id}&offer_name={offer_name}&offer_ref={offer_ref}&goal_id={goal_id}&affiliate_id={affiliate_id}&affiliate_name={affiliate_name}&affiliate_ref={affiliate_ref}&source={source}&aff_sub={aff_sub}&aff_sub2={aff_sub2}&aff_sub3={aff_sub3}&aff_sub4={aff_sub4}&aff_sub5={aff_sub5}&aff_unique1={aff_unique1}&aff_unique2={aff_unique2}&aff_unique3={aff_unique3}&aff_unique4={aff_unique4}&aff_unique5={aff_unique5}&offer_url_id={offer_url_id}&offer_file_id={offer_file_id}&file_name={file_name}&advertiser_id={advertiser_id}&advertiser_ref={advertiser_ref}&adv_sub={adv_sub}&transaction_id={transaction_id}&sale_amount={sale_amount}&currency={currency}&payout={payout}&device_id={device_id}&session_ip={session_ip}&ip={ip}&datetime={datetime}

❗️

Before you begin

The Tune integration requires that the AnyTrack Tracking Tag in the head section of your website or landing pages. Learn now to Install the AnyTrack Tag on your website.

Setup Guide

Step #1: Add Tune to your AnyTrack Account

1. Go to the Integration Catalog, search for Tune.

2. Now click on the Tune cardand then Click on Install.

Step #2: Connect your Tune account

1. Copy the predefined Postback URL
2. Login and go to your to your affiliate account
3. Navigate to the offer you wish to track
4. Scroll down and open the Pixel / Postback settings
5. Click on “add a new pixel/postback”
6. Select the code type “postback https://tune.com”
7. Select the Goal
8. Paste the postback URL
9. Click on Create

Step #3: Adjust the Conversion Event Mapping

The Event Mapping allows you to define which events to track and map them to Conversion Events you will forward to your Ads Integrations (ex: Facebook Conversion API)

Validate your integration

This section will enable you to validate the main aspects of your setup.

Link tracking

Since Tracking starts when visitors clicks on offer links, you should verify that your links are tracked and AutoTagged.

AutoTag Methods

🔥

Reminder about AutoTag:

AutoTag is a function that is enabled by default through the AnyTrack Tracking Tag, and that appends aff_click_id & click_id data to affiliate links. Learn more about AutoTag.

• Default: By default, AnyTrack automatically identifies and AutoTags Tune links found on your website.
• AutoScan: AnyTrack scans links that are embedded in redirects plugins and AutoTags them accordingly.
• Manual:
  • Tracking Group Attribute: You add the tracking group attribute to links according to their tracking requirements. For example: data-tracking-group="hasoffers" or rel="hasoffers". More about Tracking Group.
  • Click ID Token: You Manually append the subid: &aff_click_id=--CLICK-ID-- to the offer link.

Once the links are set up, you can check in your Tune account reports and see whether the aff_click_id parameters are passed to the offer links.

Here is an example of how you would manually update links from hasoffers:

<a href="https://example.foo/goto/tune" data-tracking-group="hasoffers">Hover on theTune Demo   
Link to see the AnyTrack `click_id`</a>

📘

Tracking Group

Tracking Group refers to the integration technology. For example, Tune Tracking Group tracking group is hasoffers and ClickBank is clickbank. The Tracking Group

Conversion Tracking

To validate your setup, you should either wait for a conversion or trigger a test conversion yourself and inspect the conversion logs.

Tune conversion payload example

{
  "anytrack": "1100l35864",
  "customer_type": "existing",
  "country": "US",
  "referer": "https://www.chewy.com/",
  "search_keyword": null,
  "search_engine_id": null,
  "conversion_time": "1684692689",
  "conversion_id": "1011l2002827904",
  "publisher_reference":"mz7yYainzaN6hkc52QVBg",
  "publisher_commission": "10.57",
  "creative_id": "0",
  "source_referer": null,
  "advertiser_reference": null,
  "conversion_type": "1",
  "creative_type": "0",
  "conversion_reference": "1354998698",
  "metadata_query_string": null,
  "currency": "USD",
  "tracking_method": "clickref",
  "value": "52.85",
  "items": [
    {
      "item_code": null,
      "item_id": "1011l860699483",
      "item_sku": "332503",
      "item_commission": "3.5720",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "3.5720",
      "item_meta": null,
      "item_status": "1",
      "item_value": "17.8600",
      "item_category": "11130",
      "item_vertical": null
    },
    {
      "item_code": null,
      "item_id": "1011l860699484",
      "item_sku": null,
      "item_commission": "0.0000",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "0.0000",
      "item_meta": null,
      "item_status": "1",
      "item_value": "0.0000",
      "item_category": "COMMISSION",
      "item_vertical": null
    },
    {
      "item_code": null,
      "item_id": "1101l859617416",
      "item_sku": "677350",
      "item_commission": "6.9980",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "6.9980",
      "item_meta": null,
      "item_status": "1",
      "item_value": "34.9900",
      "item_category": "2802",
      "item_vertical": null
    }
  ],
  "campaign_id": "1100l517",
  "query_string": null,
  "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Mobile/15E148 Safari/604.1"
}

FAQ & Troubleshooting

• Can I integrate a Tune-based affiliate network with AnyTrack using a template or a standard postback?

  Yes, simply install the Tune integration from the Integration Catalog in AnyTrack to automatically generate the template needed for seamless tracking of your Tune-based affiliate networks.

• Can I import past conversions into Anytrack?

  No. Anytrack can only ingest conversions that have been triggered following a visitor session on your website.

• Can I track direct linking campaigns?

  Yes, but this requires a custom setup. Please refer to this article.

• Can I use a different subid parameter than the one predefined by AnyTrack?

  No.

• Can I track conversions without the click_id?

  No. The click_id passed to the Tune links is required to track conversions.

• The Conversion Event Name is not what I am expecting, how can I change it?

  You can update the Event Mapping in the Integration page.

Take these steps to troubleshoot errors you encounter in AnyTrack

• General troubleshooting

  • Verify that your tracking tag is set in the head section of your website.
  • If you're on the free plan, verify that you didn't reach the monthly traffic limit and upgrade if needed.

• Conversion sources

  When you are not tracking conversions, or most conversions trigger an error follow the guidelines below.

🚧

Before you reach out to the tech support, please inspect the conversion log to see what type of errors you are getting and try to fix the integration by following these troubleshooting guidelines.

• Native integrations

  Native integrations refer to platforms that are predefined in the catalog and should provide an error-free data flow.
  The most common error is that the click_id is unknown or missing. It happens when AutoTag could not be activated.
  • Check that your links are not hidden behind some javascripts or double redirects.
  • Check that the links are in a standard a element.
  • Try to manually set the tracking group attribute (check the integration guidelines).
  • Check whether your offers are not getting traffic from websites where the AnyTrack Tag isn't set.
  • If you just installed AnyTrack, errors might be from traffic that wasn't tracked by AnyTrack.

  • Conversion data doesn't trigger an error 🔴, but is not validated 🟢:

    • Check that the Postback URL you've set in the integration matches the pre-defined Postback URL we provide.
    • Copy the Event Reference from the Conversion Event Log and contact the support.

  • You're not getting any conversions:

  • Check that the Postback URL is set and active in your platform.
  • Check that you're passing the correct AutoTag aff_click_id parameter to the offer link.
  • Check that the Postback URL is correctly inserted in the custom integration.