Tracker integration

You have several options for tracking and traffic analytics in AlterCPA: UTM tags, integrations with trackers, advertising network pixels, tracking codes for analytics systems, arbitrary code on websites.

General operating principles

Any tracker works according to the same principle: it sends a visitor with its own visit ID and wants to receive notifications about the actions of this visitor by the sent ID.

You can send the visitor ID to one of the tags:

  • subid, up to 255 characters, optimal for Keitaro and Binom.
  • uuid, sub1, sub2, sub3, sub4, sub5, up to 255 characters, optimal for apps optimisation.
  • utm_source, utm_campaign, utm_content, utm_term, utm_medium, up to 255 characters, for statistics.

We talked more about tags in the section "Tracking and pixels".

Postbacks are used to send notifications. They are configured inside the flow or in the "Postback" subsection of the "Flows" and "Traffic" sections.

Useful macros:

  • {subid}, {sub1}, {sub2}, {sub3}, {sub4}, {sub5}, {uuid}, {utm_source}, {utm_campaign}, {utm_content}, {utm_term}, {utm_medium} - your visitor ID should be here.
  • {stage} - lead status with values wait, hold, approve, cancel and trash.
  • {cash} and {currency} - amount and currency of payout for the lead.
  • {id} - unique lead identifier on the AlterCPA side.

Details about postbacks and tracking are described in the section "Postbacks".

Important! If your favorite tracker is not described in this guide, please contact us. We will prepare a description and try to integrate with ready-made website archives.

AlterCPA Red / One

The AlterCPA Red / One tracker has a ready-made AlterCPA Pro / Cloud template with all the necessary settings, you can use it.

If you work with links, specify {click} in the SubID field in the flow settings or add &sub1={click} to your link.

If you work with sites inside the tracker, you can download the ready-made archive for AlterCPA Red directly from the flow. Click on the download icon at the site you need, in the "Tracker" field, select "AlterCPA Red".

If you create sites yourself, add a hidden field to the submit form:

<input type="hidden" name="sub1" value="{click}" />

An example postback for AlterCPA Red looks like this:

https://www.altercpa.red/api/tracker/postback.json?id=a1b2c3d4&click={sub1}&status={stage}&uid={id}&price={cash}&currency={currency}&goal={goal}

Here www.altercpa.red is your tracker domain, a1b2c3d4 is your key. You can specify the postback both in the flow settings and in the global postback.

Keitaro

The Keitaro tracker has a ready-made AlterCPA template with all the necessary settings, you can use it.

If you work with links, specify {subid} in the SubID field in the flow settings or add &subid={subid} to your link.

If you work with sites inside the tracker, you can download the ready-made archive for Keitaro directly from the flow. Click on the download icon at the site you need, in the "Tracker" field, select "Keitaro (subid)". You can also use the options "Keitaro (utm_term)" or "Keitaro (utm_medium)" if you want to use these tags in postbacks.

If you create sites yourself, add a hidden field to the submit form:

<input type="hidden" name="subid" value="{subid}" />

An example postback for Keitaro looks like this:

http://tracker.domain/a1b2c3d4/postback?subid={subid}&tid={id}&payout={cash}&status={stage}&sale_status=approve&reject_status=cancel,trash&lead_status=wait,hold

Here tracker.domain is your tracker domain, a1b2c3d4 is your key. You can specify the postback both in the flow settings and in the global postback.

Binom

If you work with links, specify {clickid} in the SubID field in the flow settings or add &subid={clickid} to your link.

If you work with sites inside the tracker, you can download the ready-made archive for Keitaro directly from the flow. Click on the download icon at the site you need, in the "Tracker" field, select "Binom (subid)". You can also use the "Binom (clickid+campaign)" option to send the campaign ID in the utm_campaign field.

An example postback for Binom looks like this:

https://tracker.domain/click.php?cnv_id={subid}&payout={paid}&cnv_status={stage}&cnv_currency={currency}

Here tracker.domain is your tracker domain. You can specify the postback both in the flow settings and in the global postback.

In the Advanced Settings of the postback, specify the following Status payout relation:

  • wait -> 0
  • hold -> 0
  • approve -> {payout}
  • cancel -> 0
  • trash -> 0

When creating a template for a network, use the following options:

  • Name: AlterCPA
  • Offer URL template: {offer_url}&subid={clickid}
  • Postback URL: cnv_id={subid}&payout={paid}&cnv_status={stage}&cnv_currency={currency}