Configuring postback for CPA

The postback mechanism (also known as pingback or s2s) is used to notify you of a successful conversion.
This article contains information about setting up a conversion notification.

1 Acceptance and saving of a special tag on an advertised resource or in an affiliate program
2 Sending the tag back to the Kadam service from the resource or affiliate program after a conversion
- 2.1 Use advanced options
3 Instructions for setting up notifications about successful conversions from popular affiliate programs
4 Instructions for setting up successful conversion notifications from popular trackers
5 See also

Acceptance and saving of a special tag on an advertised resource or in an affiliate program

To send a postback tag (ClickId) from the Kadam service, you need to add the macro {click_id} to the ad link, for example:
http://www.test.ru/home/?subid={click_id}

After a user clicks on an advertisement on a site, they are taken to the advertiser's site; the URL of this site will already include a special tag in the form of the usual GET parameter.

An example of an advertised link with an arbitrary tag value:
http://www.test.ru/home/?subid=0000x4a7d1ed414474e4033ac29ccb8653d9b

In this case, the GET parameter received is subid with the value 0000x4a7d1ed414474e4033ac29ccb8653d9b. The parameter value is generated dynamically and differs for each unique click.

The name of the parameter (subid) can be any (for example, sub, sub1, sub_id, sid, etc.) — set either by the advertiser or by ready-made parameters in the affiliate program that can be used to transfer tags.

The value of subid must be saved on the side of the advertised resource or affiliate program.

Sending the tag back to the Kadam service from the resource or affiliate program after a conversion

After the user performs the target action (registration, etc.), the advertised resource or affiliate program should call our postback URL, which looks like this:
http://kdtrk.net/ru/postback/?data={subid}

Here, {subid} is an example of the parameter to which the {click_id} tag is transmitted in the advertised link. Depending on various factors (the partner network, advertiser CRM, etc.), the parameter can be any (for example, {sub}, {sub1}, {sub_id}, {sid}, etc.).

For the example advertised link above with the specified arbitrary tag value, the postback URL looks like this:
http://kdtrk.net/ru/postback/?data=0000x4a7d1ed414474e4033ac29ccb8653d9b

Usually, the parameter in the advertised link that takes the value of the {click_id} tag matches the one that is then sent back to our network in the postback.

Examples of advertised links and corresponding postbacks:
Advertised link: http://www.test.ru/home/?Subid={click_id}
Postback: http://kdtrk.net/ru/postback/?data={subid}

or

Advertised link: http://www.test.ru/home/?Sub1={click_id}
Postback: http://kdtrk.net/ru/postback/?data={sub1}

There are exceptions (very rarely in some partner networks, for example, Vlk.partners) when the parameter in the advertised link does not match the parameter in the postback.

For example:
Advertised link: http://www.test.ru/home/?Сid={click_id}
Postback: http://kdtrk.net/ru/postback/?data={url.cid}

Another example, where the parameter is not indicated in curly brackets (very rarely in some partner networks, for example, Admitad):
Advertised link: http://www.test.ru/home/?Subid={click_id}
Postback: http://kdtrk.net/ru/postback/?data=[[[subid]]]

In other words, the format of the advertised link with our {click_id} tag and the format of the postback URL depend on which affiliate network (tracker, CRM) you integrate with.

IMPORTANT!
If you use a redirect page to switch between landing pages of several offers, then to create correct conversion notifications for all KSA campaigns of the current offers, you need to specify links so that the parameters are substituted via <?php echo $_GET['parameter']; ?> (this method only works for PHP pages).

An example of getting the subid parameter for the actionpay.ru affiliate program:
Link on the Kadam side (specified in the URL of the campaign and ads):

http://domain.com/index/biznes/059/?subid={click_id}

Link on the advertiser's side (specified in the redirect-page code instead of the actual links):

n.actionpay.ru/click/56014f2a8b30a808438b4567/106002/91267/<?php echo $_GET['subid']; ?>

Use advanced options

The Kadam service supports passing additional parameters to the postback. These parameters can be transmitted as needed:

&status — this parameter is used to pass the conversion status. If the parameter is not used, the conversion is treated by the system as confirmed, and funds are charged for it.
If you have the ability to transfer the order status, use the following parameters:

&status=hold — lead on hold;
&status=approved — lead confirmed;
&status=reject — lead rejected.

&cost — this parameter is used if the cost of the lead may vary depending on certain conditions. If the parameter is not specified, the cost of the lead is taken from the offer/campaign settings.
Example: &cost=200

&currency — this parameter is used to pass the currency. The Kadam service supports the following currencies: euro, dollar, hryvnia. For other currencies, use the following parameters:

&currency=UAH — hryvnia;
&currency=USD — dollar;
&currency=EUR — euro;
&currency=KZT — tenge.

&key — this parameter is used to account for duplicate conversions in the dashboard statistics. It is useful, for example, for e-commerce offers (to track repeat orders), for the RevShare model with payment for repeat deposits, and other similar offers where you need to see duplicates in the statistics.
If the parameter is not specified, duplicate conversions will not be counted.
For the &key parameter, specify the tag responsible for passing the conversion ID to the affiliate network.
Example: &key={conversionid}

If you are working with an affiliate program, contact the affiliate program's support service to help set up conversion notifications.

We strongly recommend setting up test conversions before launching your actual campaign so that you do not lose data on successful conversions.