Let's talk about how to set up a postback URL.
To notify about a successful conversion, the postback mechanism (also known as pingback or s2s) is used.
This article contains information on setting up a conversion notification using this mechanism.
Receiving and saving a special tag on a promoted resource or in an affiliate program
To pass the postback tag (Click Id) from the Kadam service, you need to add the macro {click_id} to the link of the advertising campaign, for example:
http://www.test.ru/home/?subid={click_id}
After clicking on the ad on the platform, the user is redirected to the advertiser's site, and the link of this site already contains a special tag in the form of a regular GET parameter.
Example of a promoted link with an arbitrary value of the tag:
http://www.test.ru/home/?subid=0000x4a7d1ed414474e4033ac29ccb8653d9b
where in this case, the GET parameter is subid, with a value of 0000x4a7d1ed414474e4033ac29ccb8653d9b. The parameter value is dynamically generated and differs for each unique transition.
The parameter name (subid) can be any (for example, sub, sub1, sub_id, sid, etc.) - it is set by the advertiser or there may already be ready-made parameters in the affiliate program that can be used to pass the tag.
The subid parameter value must be saved on the side of the promoted resource or affiliate program.
Sending a tag by the resource or affiliate program after an action is performed in the Kadam service
After the user performs an action (registration, etc.), the promoted resource or affiliate program must call our postback link, which looks like this: https://kdtrk.net/ru/postback/?data={subid}
where {subid} is an example parameter to which the {click_id} tag is passed in the promoted link. Depending on various factors (affiliate network, advertiser's CRM, etc.), the parameter may be anything (for example, {sub}, {sub1}, {sub_id}, {sid}, etc.).
For the example of a promoted link with an arbitrary tag value given above, the postback link will look like this:
https://kdtrk.net/ru/postback/?data=0000x4a7d1ed414474e4033ac29ccb8653d9b
Usually, the parameter in the promoted link that accepts tag [CPA] values corresponds to the one that is then specified and sent back to our network in the postback.
Arbitrary examples of a promoted link and a postback:
Promoted link - http://www.test.ru/home/?subid={click_id}
Postback - https://kdtrk.net/ru/postback/?data={subid}
or
Promoted link - http://www.test.ru/home/?sub1={click_id}
Postback - https://kdtrk.net/ru/postback/?data={sub1}
But there are exceptions (very rare in some affiliate networks, for example, Vlk.partners) when the parameter in the promoted link may not match the parameter in the postback.
For example:
Promoted link - http://www.test.ru/home/?cid={click_id}
Postback - https://kdtrk.net/ru/postback/?data={url.cid}
Or an example when the parameter is not specified in curly brackets (very rare in some affiliate networks, for example, admitad):
Promoted link - http://www.test.ru/home/?subid={click_id}
Postback - https://kdtrk.net/ru/postback/?data=[[[subid]]]
That is, the appearance of the promoted link with our {click_id} tag and the appearance of the postback link will depend on which affiliate network (tracker, CRM) you are integrating with.
IMPORTANT!
If you use a pad that redirects to landing pages of several offers, to create correct conversion notifications for all campaigns of current offers, you need to specify links with the substitution of GET parameters <?php echo $_GET ['parameter'];?> (this method works for PHP pages).
Example of obtaining the subid parameter for the actionpay.ru affiliate network:
Link on Kadam side (indicated in the URL of the campaign and ads):
http://domen.ru/index/biznes/059/?subid={click_id}
Link on the advertiser's side (indicated in the pad code instead of all links):
n.actionpay.ru/click/56014f2a8b30a808438b4567/106002/91267/<?php echo $_GET['subid'];?>
Using Additional Parameters
Kadam Service supports passing additional parameters in postback.
These parameters can be passed as needed:
&status - the parameter is used to pass the conversion status. If the parameter is not used, the conversion will be accepted by the system as confirmed.
If you have the ability to pass order statuses, use the following parameters:
&status=hold - lead in "hold"
&status=approved - lead confirmed
&status=reject - lead rejected
&cost - the parameter is used if the lead cost 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
¤cy - the parameter is used to pass the currency. Kadam Service supports such currencies: euro, dollar, hryvnia, ruble. When using a currency other than the ruble, the amount received as a result of converting the specified currency into rubles will be debited from your balance.
If the cost of the lead is in rubles, there is no need to pass a currency parameter.
In other cases, use the following parameters:
¤cy=UAH - hryvnia
¤cy=USD - dollar
¤cy=EUR - euro
¤cy=KZT - tenge
key - the parameter for accounting for duplicate conversions in statistics in the cabinet. Suitable, for example, for e-commerce offers (to see repeat orders), for the RevShare model with payment for repeat deposits, and other similar offers where duplicates need to be seen in statistics.
If the parameter is not specified, duplicate conversions will not be counted.
For the key parameter, a label is specified that is responsible for passing the conversion ID to the affiliate program.
Example: &key={conversionid}
If you are working with an affiliate program, contact the affiliate program support service for help in setting up notifications about successful conversions.
We strongly recommend conducting test conversions after setting up before launching the campaign in order not to lose data about successful conversions.
Instructions for setting up notifications about successful conversions from popular affiliate programs
Instructions on how to set up notifications about successful conversions in popular trackers