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 32 characters, optimal for Keitaro and Binom.
  • uuid, up to 64 characters, optimal for AppsFlyer.
  • utm_source, utm_campaign, utm_content, utm_term, utm_medium, up to 255 characters.

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}, {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".

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={payout}&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={payout}&cnv_status={stage}&cnv_currency={currency}