View source for Настройка postback для СРА/en

<languages/>
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 using this mechanism.

== 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 <span style="color: red">[CPA]</span> to the ad link, for example:

<span style="color: red"><code>http<nowiki/>://www.test.ru/home/?subid=[CPA]</code><br /></span>

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 <span style="color: red">get</span> parameter.

An example of an advertised link with an arbitrary tag value:

<span style="color: red"><code>http<nowiki/>://www.test.ru/home/?subid=0000x4a7d1ed414474e4033ac29ccb8653d9b</code><br /></span>

where <span style="color: red">get</span>, the parameter in this case is <span style="color: red">subid</span>, with the value <span style="color: red">0000x4a7d1ed414474e4033ac29ccb8653d9b</span>. The parameter value is generated dynamically and differs for each unique transition.

The name of the parameter (<span style="color: red">subid</span>) 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 <span style="color: red">subid</span> 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: <span style="color: red"><code>http<nowiki/>://postback.kadam.net/en/postback/?data={subid}</code><br /></span>

where <span style="color: red">{subid}</span> is an example of the parameter to which the [CPA] 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.).

For the data from the example advertised link above (with the specified arbitrary tag value) the postback link will look like this:

<span style="color: red"><code>http<nowiki/>://postback.kadam.net/en/postback/?data=0000x4a7d1ed414474e4033ac29ccb8653d9b</code><br /></span>

Usually the parameter in the advertised link that takes the values of the [CPA] tag matches the one that is then indicated and sent back to our network in the postback.<br />
Arbitrary examples of advertised link and postback:<br />
The advertised link - <span style="color: red"><code>http<nowiki/>://www.test.ru/home/?Subid=[CPA]</code><br /></span>
Postback - <span style="color: red"><code>http<nowiki/>://postback.kadam.net/en/postback/?Data={subid}</code><br /></span >
or<br />
The advertised link - <span style="color: red"><code>http<nowiki/>://www.test.ru/home/?Sub1=[CPA]</code><br /></span>
Postback - <span style="color: red"><code>http<nowiki/>://postback.kadam.net/en/postback/?Data={sub1}</code><br /></span >

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.<br />
For example:<br />
The advertised link - <span style="color: red"><code>http<nowiki/>://www.test.ru/home/?Сid=[CPA]</code><br /></span>
Postback - <span style="color: red"><code>http<nowiki/>://postback.kadam.net/en/postback/?Data={url.cid}</code><br /></span>
Or an example where the parameter is not indicated in curly brackets (very rarely in some partner networks, for example, admitad):<br />
The advertised link - <span style="color: red"><code>http<nowiki/>://www.test.ru/home/?Subid=[CPA]</code><br /></span>
Postback - <span style="color: red"><code>http<nowiki/>://postback.kadam.net/en/postback/?Data=[[[subid]]]</code><br /></span>
Those. the type of advertised link with our [CPA] tag and the type of postback link will depend on which affiliate network (tracker, crm) you integrate with.

'''IMPORTANT!'''
In case you 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 with get parameters substitution <?php echo $_GET['parameter'];?> (this method works for PHP pages).

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

<i>Link on the side of Kadam (specified in the URL of the campaign and ads)</i>: <pre>http://domain.com/index/biznes/059/?subid=[CPA]</pre>

<i>Link on the advertiser’s side (indicated in the padding code instead of all links)</i>: <pre>n.actionpay.ru/click/56014f2a8b30a808438b4567/106002/91267/<?php echo $_GET['subid'];?></pre>

=== Use advanced options ===

The Kadam service supports passing 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:
<ol>
<li>&status=hold - lead in the "hold"</li>
<li>&status=approved - lead confirmed</li>
<li>&status=reject - lead rejected</li>
</ol>

'''&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. <span style="color: red">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.</span>
If the cost of the lead in rubles, the transfer parameter with the currency is not required.

In other cases, use the following parameters:
<ol>
<li>&currency=UAH - hryvnia</li>
<li>&currency=USD - dollar</li>
<li>&currency=EUR - euro</li>
<li>&currency=KZT - tenge</li>
</ol>

<u>If you are working with an affiliate program, contact the affiliate program support service to help set up conversion conversion notifications.</u>

'' 'We strongly advise after setting up [[Test_conversion | test conversions]] before launching the campaign in order not to lose data on successful conversions.' ''

== Instructions for setting up successful conversion notifications from popular affiliate programs ==

=== 7offers.ru ===
Click on [[Configure_postback_for_7offers.ru | link]] to read the detailed instructions.
=== Actionpay ===
Click on [[Postback__Adjust_Actionpay | link]] to read the detailed instructions.
=== AD1 ===
Go to [[Configure_postback_for_AD1 | link]] to read the detailed instructions.
=== AD2Games ===
Follow [[Custom_postback__for_AD2Games | link]] for detailed instructions.
=== Adbees.com ===
Click on [[setup_postback__for_adbees | link]] for detailed instructions.
=== Adinfo.ru ===
Go to [[Configure_postback_for_adinfo.ru | link]] to read the detailed instructions.
=== Admitad ===
Go to [[Configure_postback_for_Admitad | link]] to read the detailed instructions.
=== Adtrafico.com ===
Follow the [[setup_postback__ for_adtrafico.com | link]] for detailed instructions.
=== Advendor.net ===
Follow the [[setup_postback__for_advendor.net | link]] to read the detailed instructions.
=== Advertise.ru ===
Click on [[Customize_postback_for_advertise.ru | link]] to read the detailed instructions.
=== Advertstar ===
Follow [[Configure_postback_for_Advertstar | link]] for detailed instructions.
=== Advgame.ru ===
Click on [[setup_postback__for_advgame | link]] for detailed instructions.
=== Ad-x.ru ===
Follow [[Config_postback__for_ad-x.ru | link]] to read the detailed instructions.
=== Arbitrage.top ===
Follow the [[Configure_postback_ for_Arbitrage.top | link]] to read the detailed instructions.
=== Babos.biz ===
Go to [[Setting up postpost_ for_Babos.biz | link]] to read the detailed instructions.
=== Badboys.network ===
Go to [[Setup_postback__ for_badboys.network | link]] to read the detailed instructions.
=== Binpartner.com ===
Go to [[Configure_postback_for_binpartner.com | link]] for detailed instructions.
=== C3pa.net ===
Go to [[Configure_postback_for_c3pa.net | link]] to read the detailed instructions.
=== Сityads.com ===
Click on [[setup_postback_ for_cityads | link]] to read the detailed instructions.
=== Clickdealer.com ===
Go to [[Customize postback_ for_clickdealer.com | link]] to read the detailed instructions.
=== Sppaelectro.com ===
Follow the [[setup_postback__for_cpaelectro.com | link]] to read the detailed instructions.
=== CPAExchange ===
Go to [[Config_postback__for_CPAExchange | link]] for detailed instructions.
=== Cpagetti.com ===
Follow the [[setup_postback__for_cpagetti.com | link]] to read the detailed instructions.
=== Cpazilla.ru ===
Go to [[setup_postback__for_cpazilla | link]] to read the detailed instructions.
=== Ctr.ru ===
Go to [[Configure_postback_for_ctr.ru | link]] to read the detailed instructions.
=== Dr.cash ===
Click on [[setup_postback__for_dr.cash | link]] to read the detailed instructions.
=== Elonleads.ru ===
Go to [[Configure_postback_for_elonleads.ru | link]] to read the detailed instructions.
=== Everad ===
Follow [[Custom_postback__for_Everad | link]] to read the detailed instructions.
=== Funcpa.ru ===
Go to [[Configure_postback_for_funcpa.ru | link]] to read the detailed instructions.
=== Himba.ru ===
Go to [[Configure_postback_for_Himba.ru | link]] to read the detailed instructions.
=== KMA ===
Follow [[Custom_postback__for_KMA | link]] for detailed instructions.
=== Leads.su/Tradeleads.su===
Click on [[setup_postback__for_leads.su | link]] to read the detailed instructions.
=== Luckypartners.biz ===
Follow the [[setup_postback__for_luckypartners.biz | link]] to read the detailed instructions.
=== Luckyshop.ru ===
Go to [[Customize_postback_ for _luckyshop | link]] for detailed instructions.
=== M1-shop.ru ===
Click on [[Setup_postback_for_m1-shop.ru | link]] to read the detailed instructions.
=== Mobytize ===
Click on [[setup_postback_ for_mobytize | link]] to read the detailed instructions.
=== MonsterLeads ===
Click [[Customize postback_for_MonsterLeads | link]] for detailed instructions.
=== Omnicpa.ru ===
Click [[Configure_postback_for_omnicpa.ru | link]] to read the detailed instructions.
=== PrimeLead ===
Click on [[Postback__Adjustment_For_PrimeLead | link]] for detailed instructions.
=== SalesDoubler ===
Click on [[Customize_postback__for_SalesDoubler | link]] for detailed instructions.
=== Shakes.pro ===
Click on [[setup_postback__for_shakes.pro | link]] to read the detailed instructions.
=== Vlk.partners ===
Follow [[Custom_postback__for_vlk.partners | link]] to read the detailed instructions.
=== Wap.Click ===
Click on [[Custom_postback__for_Wap.Click | link]] for detailed instructions.
=== Wildo.click ===
Follow the [[Setup_postback__for_Wildo.click | link]] to read the detailed instructions.