CPAlead Logo

Tracking Affiliate Conversions

In the world of performance marketing, there are many instances, where affiliates are going to want to track conversions in real time on their end. While CPAlead has some of the most real-time reporting in the industry, affiliates, may want to track their campaigns in their own tracking platform. Other times the affiliate will actually be another affiliate network that is re-brokering the offer to their own affiliates. In either case, they will want to track conversions in realtime so that they can keep track of the campaigns on their end. To track in real time, affiliates will need to place their offer postback/URL inside your CPAlead panel under "Postback" -> "Configuration". When a conversion is recorded, our platform will notify your server in real time via HTTP GET request.

Tracking URL Setup

Our tracking URL will look similar to the example below, we have multiple subid variables that will accomodate any transaction ID or click ID, so that you may pass this variable to us, then receive it inside your server to server postback.

https://example/offer.php?id=1234&pub=1234&subid={Tracking_or_Subid}&subid2={Additional_Subid}&subid3={Additional_Subid}

For Mobile App Developers, Please pass IDFA (Apple) or GAID (Google) variables using the following parameters, in addition to any subids:

https://example/offer.php?id=1234&pub=1234&subid={Tracking_or_Subid}&subid2={Additional_Subid}&subid3={Additional_Subid}&idfa={Your_Users_IDFA}&gaid={Your_Users_GAID}

Postback URL Setup

Inside your CPAlead Dashboard you will find a Postback Configuration area, in this area you will be able to enable and input your Postback URL. You will have many macro parameters available to you, to pass back to your conversion link. For example a Postback URL may look something like:

https://example.com/postback/conversion?subid={subid}&subid2={subid2}&subid3={subid3}

For example if you'd like to receive all parameters, your postback URL may look something like:

https://example.com/postback/conversion?campaign_id={campaign_id}&campaign_name={campaign_name}&subid={subid}&subid2={subid2}&subid3={subid3}&payout={payout}&ip_address={ip_address}&gateway_id={gateway_id}&lead_id={lead_id}&country_iso={country_iso}&password={password}&virtual_currency={virtual_currency}

Our system is capable of handling HTTP and HTTPS (Secure) Postback URLs.

Macro Parameters

While setting up your URL you may want to pass information back to your conversion script. We have the following dynamic macro parameters available:

Macro Description

{campaign_id}

For the campaign ID of the campaign

{campaign_name}

Name of the campaign

{subid}

For Tracking IDs or Affiliate sub IDs, this parameter is passed into our tracking links, and explained above

{subid2}

For Tracking IDs or Affiliate sub IDs, this parameter is passed into our tracking links, and explained above

{subid3}

For Tracking IDs or Affiliate sub IDs, this parameter is passed into our tracking links, and explained above

{idfa}

For Apple Mobile Apps, Pass IDFA advertising ID, this parameter is passed into our tracking links, and explained above

{gaid}

For Android Mobile Apps, Pass Google Play advertising ID, this parameter is passed into our tracking links, and explained above

{payout}

Amount paid to affiliate for conversion

{ip_address}

IP address of converting user

{gateway_id}

If a content, file, or link locker is involved in the conversion, this will be the ID of that tool

{lead_id}

ID number of the lead

{country_iso}

Two letter country ISO code, e.g. US

{password}

If your postback has a password associated, we pass this password back to you

{virtual_currency}

If a virtual currency widget is used in the conversion, this will display the amount of virtual currency credited

Whitelisting URL Setup

For security purposes, you may additionally want to whitelist our server IP in your software, that way you know for certain that postbacks are coming from CPAlead. Our postbacks come from a single IP address below.

52.0.65.65

Example Script

For complete custom script setups, CPAlead offers a basic postback example script that should give you, or your developer, an idea how a custom CPAlead postback script should function.

Download