TerraLeads

TerraLeads Integration Overview

The integration between TerraLeads and AnyTrack is a powerful combination for digital marketers looking to optimize their campaigns. With this integrated solution, conversion data from TerraLeads is sent to AnyTrack which then forwards it on to platforms like Google Ads, Facebook Conversion API and Tiktok API. This allows advertisers using these platforms the ability to better track leads in real-time and make smarter decisions with their campaigns - leading to higher ROI's! Additionally, thanks to advanced tracking features of AnyTrack such as attribution models (e.g., Last Click) or UTM tags you can further increase your understanding of customer behaviour across multiple channels allowing more targeted audience targeting!

✍️

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 TerraLeads 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 TerraLeads 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 TerraLeads Postback URL

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

https://t1.anytrack.io/hBtoE3hN/collect/terraleads?offer_id={offer_id}&lead_id={lead_id}&sub_id={sub_id}&sub_id_1={sub_id_1}&sub_id_2={sub_id_2}&sub_id_3={sub_id_3}&sub_id_4={sub_id_4}&payment={payment}&status={status}&ip={ip}&country={country}&time={time}

❗️

Before you begin

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

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

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

Step #2: Connect your TerraLeads account

1. Copy the predefined Postback URL
2. Go to your account to access your event tracking settings page.
3. Click the “edit” settings button
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.

🔎

Install the AnyTrack Pixel Helper Extension

Install the AnyTrack Pixel Helper Chrome extension to verify the AnyTrack Tag is installed on your website. It also shows connected ad networks and browser-side events. Learn more.

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

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

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

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

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

📘

Tracking Group

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

TerraLeads 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 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 TerraLeads 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 sub_id parameter to the offer link.
  • Check that the Postback URL is correctly inserted in the custom integration.