HitPath

HitPath Integration Overview

AnyTrack and HitPath have partnered to enable powerful data integrations. AnyTrack forwards conversion data from HitPath into platforms like Google Ads, Facebook Conversion API and Tiktok API so you can maximize your marketing performance with precise analytics. With this integration, you'll gain visibility of the most important metrics such as ROI, CPCs and conversions across all campaigns in one place - simplifying reporting & optimization tasks for better decision making. Try it out today!

✍️

This article was first published on 2023-04-19and was last updated on 2023-05-31. If you you notice something that is outdated, please suggest an edit.

How does the HitPath 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 HitPath 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 HitPath Postback URL

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

https://t1.anytrack.io/hBtoE3hN/collect/hitpath-test?c1=xxc1xx&c2=xxc2xx&c3=xxc3xx&cid=xxcidxx&progid=xxprogidxx&payout=xxpayoutxx&rand=xxrandxx

❗️

Before you begin

The HitPath 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 HitPath to your AnyTrack Account

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

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

Step #2: Connect your HitPath account

1. Copy the predefined Postback URL
2. Navigate to your affiliate account.
3. Open the pixel tracking option of the offer you want to track
4. Paste the postback URL
5. Save

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 c3 & click_id data to affiliate links. Learn more about AutoTag.

• Default: By default, AnyTrack automatically identifies and AutoTags HitPath 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="hitpath" or rel="hitpath". More about Tracking Group.
  • Click ID Token: You Manually append the subid: &c3=--CLICK-ID-- to the offer link.

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

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

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

📘

Tracking Group

Tracking Group refers to the integration technology. For example, HitPath Tracking Group tracking group is hitpath 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.

HitPath 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 HitPath-based affiliate network with AnyTrack using a template or a standard postback?

  Yes, simply install the HitPath integration from the Integration Catalog in AnyTrack to automatically generate the template needed for seamless tracking of your HitPath-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 HitPath 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 c3 parameter to the offer link.
  • Check that the Postback URL is correctly inserted in the custom integration.