Configuring postback for CPA

The postback mechanism (aka pingback, aka 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 a label by a resource or affiliate program after an action has been committed to the Kadam service
- 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

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 clicking on an advertisement on the site, the user is taken to the advertiser's site, the link of this site will already be with a special label 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

when receiving, the get parameter in this case is subid, with the value, with the value 0000x4a7d1ed414474e4033ac29ccb8653d9b. The parameter value is generated dynamically and differs for each unique transition.

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

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

Sending a label by a resource or affiliate program after an action has been committed to the Kadam service

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

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

The postback link looks like this for the advertised link (which we used above as an example) with specified arbitrary tag value we used above:

http://kdtrk.net/ru/postback/?data=0000x4a7d1ed414474e4033ac29ccb8653d9b

Usually the parameter in the advertised link that takes the values of the {click_id} tag matches the one that is then indicated and sent back to our network in the postback.
Arbitrary examples of advertised link and postback:
The advertised link - http://www.test.ru/home/?Subid={click_id}
Postback - http://kdtrk.net/ru/postback/?data={subid}
or
The advertised link - http://www.test.ru/home/?Sub1={click_id}
Postback - http://kdtrk.net/ru/postback/?data={sub1}

But there are exceptions (very rarely in some partner networks, for example, Vlk.partners), when the parameter in the advertised link may not coincide with the parameter in the postback.
For example:
The advertised link - http://www.test.ru/home/?Сid={click_id}
Postback - http://kdtrk.net/ru/postback/?data={url.cid}
Or an example where the parameter is not indicated in curly brackets (very rarely in some partner networks, for example, admitad):
The advertised link - http://www.test.ru/home/?Subid={click_id}
Postback - http://kdtrk.net/ru/postback/?data=[[[subid]]]
Those. the type of advertised link with our {click_id} tag and the type of postback link will depend on which affiliate network (tracker, crm) you integrate with.

IMPORTANT! If you do use the spacer, with which you are switching to the landing pages of several offers, to create correct conversion notifications for all KSA campaigns of the current offers, you need to register links in order to get parameters substitution <?php echo $_GET['parameter'];?> (this method works only for PHP pages).

An example of getting the subid parameter for actionpay.ru affiliate program:

Link on the side of Kadam (specified in the URL of the campaign and ads):

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

Link on the advertiser’s side (indicated in the padding code instead of all links):

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

Use advanced options

The kadam service supports transferring additional parameters to postback.

These parameters can be transmitted if necessary:

&status - this parameter is used to pass the conversion status. If the parameter is not used, the conversion will be accepted by the system as confirmed and funds will be charged for it.

If you have the ability to transfer order status, then use the following parameters:

&status=hold - lead in the "hold"
&status=approved - lead confirmed
&status=reject - lead rejected

&cost - parameter is used if the cost of the lead may vary depending on any parameters. If the parameter is not specified, information about the cost of the lead will be taken from the offer/campaign. Example: &cost=200

&currency - this parameter is used to transfer currency. Kadam service supports the following currencies: euro, dollar, hryvnia, ruble. If you use a currency other than the ruble, the amount received as a result of the conversion of the specified currency into rubles will be deducted from your balance. If the cost of the lead is in rubles, the transfer parameters with the currency is not required.

In other cases, use the following parameters:

&currency=UAH - hryvnia
&currency=USD - dollar
&currency=EUR - euro
&currency=KZT - tenge

key - parameter for taking into account duplicate conversions in the statistics in the cabinet. Suitable, for example, for e-commerce offers (to see repeated orders), for RevShare model with payment by repeated deposits and other similar offers where you need to see duplicates in the statistics.
If the parameter is not specified, double conversions will not be taken into account.
For the key parameter, you specify the label that is 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 support service to help set up conversion notifications.

We strongly advise that you set up test conversions before launching your actual campaign so that you don’t lose data on successful conversions.