Template Affiliate Networks with tgid

{akid} Integration Overview

{akid} runs on the {tgid} platform. AnyTrack enables you to integrate with {akid} and any program running on {tgid} via {method}.

✍️

_This article was first published on 03/14/2023and was last updated on 03/14/2023. If you you notice something that is outdated, you can update the article here.

How does the {akid} AnyTrack integration work:

1. Traffic: When visitors land on your website, AnyTrack collects visitor behavior, traffic source data and first party data.
2. Engagements: When visitors interact with your content and click on affiliate links, AnyTrack does a few things:
   1. Collects granular data about the outbound click event.
   2. Triggers Event Tracking requests to your pixels and analytics.
3. Conversions: When visitors convert on the merchant's website, AnyTrack receives the Conversion Data through server side api / postback or webhooks.
4. Attribution: AnyTrack processes the Conversion Data and reports it in the AnyTrack campaign reports.
5. Conversion API: AnyTrack then sends conversions to your ad platforms' Conversion API which enables you to optimize your campaigns according to the exact conversion objective you are aiming for.

Technical information

👍

Good to know:

In 99% of the cases, the technical information provided in this article won't be needed, as the setup and tracking flow is fully automated. However, you must come back to it if you need to troubleshoot an integration and make some adjustments.

Standard Events

{akid} conversion payload example

👍

Good to know

The payload example below can be observed in the {akid} conversion event log as soon as you connect your integrations.

{
  //We removed some lines to improve convenience convenience lines removed for readability
  "sub1":"{sub1}",
  "sub2":"{sub2}",
  "sub3":"{sub3}",
  "sub4":"{sub4}",
  "sub5":"{sub5}", //used for the click_id
  "transaction_id":"{transaction_id}", //mapped to transaction di
  "event_name":"{event_name}", //mapped to the conversion event name
  "event_id":"{event_id}",
  "timestamp":[
    "{timestamp}",
    "{timestamp}"
  ],
  "datetime":"{datetime}",
  "affiliate_id":"{affiliate_id}",
  "affiliate_name":"{affiliate_name}",
  "source_id":"{source_id}",
  "offer_id":"{offer_id}", //product_id || item_id
  "offer_name":"{offer_name}",//product_name||item_name
  "offer_currency":"{offer_currency}",
  "payout_amount":"{payout_amount}", //event_value
  "amount":"{amount}",
  "revenue_amount":"{revenue_amount}",
  "advertiser_id":"{advertiser_id}",
  "advertiser_name":"{advertiser_name}",
  "geo_country_code":"{geo_country_code}", //country
  "geo_country_name":"{geo_country_name}",
  "geo_region_code":"{geo_region_code}", //region
  "geo_region_name":"{geo_region_name}",
  "user_id":"{user_id}",
  "random":"{random}",
  "app_id":"{app_id}"
}

Standard Conversion Parameters

❗️

Prerequisite:

You must first add the AnyTrack tag in the head section of your website. Learn now to Install the AnyTrack Tag on your website

Setup Guide

1. Go to the {akid} integration page and click Install Integration.

2. Follow this link to generate your security key.
3. Generate a new key (if you don’t have one already)
4. Add the following IP addresses: 0.0.0.0/255.255.255.255
5. Copy the Security Key (ctrl+C)
6. Return to AnyTrack settings and Paste the Security Key in the corresponding fields.
7. Save

Update the Event Mapping

1. Copy the Predefined Postback URL.

2. Login to your affiliate panel.

3. Create a new Postback

4. Paste the Postback URL in the Endpoint URL field.

5. Fill the Postback name (i.e. "AnyTrack")

6. Selected all Event Types as well as Create and Update

7. Click on Create Postback.

8. Click on Send Test Event to validate your setup.

9. Return to AnyTrack and check the Event Log to see the test event.

Validate your integration

This section covers the steps to validate the integration.

Link tracking

Since Tracking starts when visitors clicks on offer links, you must first check that the links are being tracked and that AutoTag is activated.

🔥

Reminder about AutoTag

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

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

Here is an example of how you would manually update links from {groupId}:

<a href="https://anytrack.io" data-tracking-group="incomeaccess">Hover on the incomeaccess Demo   
Link to see the AnyTrack click_id</a>

📘

Tracking Group

Tracking Group refers to the integration technology. For example, Impact Affiliate Network Tracking Group tracking group is impact and CJ Affiliates is cj. The Tracking Group

Conversion Tracking

To validate your setup, there aren't many options but to wait for a conversion and inspect the conversion logs.

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 offer link is required to track conversions.

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

  You can add event_name=YOUR_CONVERSION_NAME parameter in the postback URL.

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.

• Conversion sources

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

🚧

Before you reach out to the support, please inspect the conversion log to see what type of errors you are getting. Try to adjust the integration settings with 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 and this is the case when AutoTag did not append the anytrack click_id to the offer link.

  • Check that your affiliate links are not hidden behind some javascript.
  • 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 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 set in the integration matches the predefined postback URL we provide.
    • Copy the Event Reference and contact the support.

  • You're not getting conversions:

    • Check that the AnyTrack postback / webhook or API is set and active in your platform integration.

• Custom Integrations

  Custom integrations refer to integrations that have been set using the Custom Integration and that requires manual setup following standard tracking parameters.
  Common errors with custom integrations include missing and unknown click_id but can also be the result of using the wrong conversion attributes or postback tokens.

  • Check that you've properly set the AnyTrack tracking attributes and the integration tokens.
  • Check that you're passing the correct AutoTag subid parameter to the offer link.
  • Check that the Postback URL is correctly inserted in the custom integration.