Conversion Postback¶

Creating a Conversion Postback¶

On the Conversion Postback tool page, click button Create. Opens the window where you can create the new tool.

1. In field Postback URL, enter the address of the page to receive the queries with notifications on conversions.

2. Configure selection Conversion Postback in Filters section.

   1. Query type: GET or POST.
   2. Action type – the type of conversion you want to get for processing:
      • All — notifications on leads (CPL), actions or sales (CPA).
      • CPL — notifications on new leads only.
      • CPS — notifications on new actions or sales only.
   3. Offer filters:
      • Yes – Postbacks on all added offers will arrive
      • No – Postbacks on offers you select in list Added offers will arrive.

3. Configure Query parameters. Select the checkboxes for variables you want to get from our affiliate network. You can use default or custom variable names.

   Attention

   Current release doesn’t contain the following variables:

   • Site
   • City
   • User-Agent string
   • Browser
   • Operating System

4. If necessary, set your own static variables.

5. Here you can see the resulting query format the affiliate network will send the Conversion Postback upon.

6. After configuration complete, click Save Postback URL.

Moderating a Conversion Postback¶

As you can see, there are two possible responses from our Client support service: positive and not really positive. After the moderation, your tool:

1. Will be confirmed and you will start to receive postbacks to configured URL. In this case, Change and Check options in Conversion Postback tools table will be available to you.
2. Won’t be confirmed. In this case, the main page will show the refuse reason.

Checking a Conversion Postback¶

After successful moderation, Conversion Postback tool can be tested. It means that you don’t have to wait for real conversion in order to get the postback from our system.

To check the health of your tool, in tool table click button Check. During the check, the values of your variables will be substituted by the random values, and such formed system response will be sent to the URL you configured. The result (indicated on the screenshot by the arrow) will be the response from your server to our query.

Processing a Conversion Postback¶

You can process and analyze conversion data on your own discretion. Below you will find the example of simple php code rendered on the tool main page:

<?php
//receiving variables sent in query
$offer_id = $_REQUEST['offer_id'];
$offer_name = $_REQUEST['offer_name'];
$sa = $_REQUEST['sa'];
$action_type = $_REQUEST['action_type'];
$payout = $_REQUEST['payout'];
//forming log string
$line = 'offer:' . $offer_name . '; sa:' . $subaccount . '; type:' . $action_type . '; total amount:' . $payout . "\n";
//opening file to log queries
if ($handle = fopen($_SERVER['DOCUMENT_ROOT'] . '/conversion_postback.log', 'a')) {
       fwrite($handle, '[' . date('Y-m-d H:i:s') . ']:' . $line . "\n");
        fclose($handle);
}
?>

Example

Webmaster Harry works with our affiliate network to advertise clothing store on his sites (including postback.test.ru).

1. He is eager to know what happens (and when) with conversions on one of the offers (ClothesTestOffer) coming from the clothing store ClothesTestShop.ru. For this, Harry configures GET Conversion Postback with name test in the system:

http://postback.test.ru/ru/postback?offer_id={offer_id}&offer_name={offer_name}&wp_id={wp_id}&wp_name={wp_name}&order_total={order_total}&action_type={action_type}&target_id={target_id}&target_name={target_name}&payout_id={payout_id}&payout={payout}&payout_currency={payout_currency}&xid={xid}&click_time={click_time}&event_time={event_time}&conversion_time={conversion_time}&ip={ip}&country={country}&user_device={user_device}&cpl_id={cpl_id}&open_commission={open_commission}&order_amount={order_amount}&status={status}&offer=ClothesTest

2. Also, to his affiliate link on ClothesTestOffer he adds unique label xid = test_xid_1234567890: http://cityads.com/click-GCQE6T5C-JHFDQDT8?xid=test_xid_1234567890 and requests parameter click ID in his Conversion Postback to get xid from the system server.
3. Sally finds the ad published on Harry’s website attractive and clicks the affiliate link to go to ClothesTestShop.ru website. In the store, she puts 5 dresses in the amount of RUB15,000 into the basket and places an order. As the result, the webmaster receives the following CPL Conversion Postback:

http://postback.test.ru/ru/postback/?offer_id=3135&offer_name=ClothesTestOffer&wp_id=51935&wp_name=test&order_total=15000&action_type=CPL&target_id=89153&target_name=NewTarget&payout_id=&payout=&payout_currency=&xid=test_xid_1234567890&click_time=1461595009&event_time=1461595182&conversion_time=&ip=212.233.125.98&country=RU&user_device=stationary&cpl_id=1555693533&open_commission=1500&order_amount=&status=open&offer=ClothesTest

4. However, when Sally received dresses, 2 of them appeared to be too small, so she paid only RUB10,000 for 3 dresses and webmaster received following CPS Conversion Postback:

http://postback.test.ru/ru/postback/?offer_id=3135&offer_name=ClothesTest_Dress&wp_id=51935&wp_name=test&order_total=15000&action_type=CPA&target_id=89752&target_name=Оплаченный заказ&payout_id=3424973352&payout=942&payout_currency=RUR&data=test_xid_1234567890&click_time=1461595009&event_time=1461595947&conversion_time=1461596078&ip=212.233.125.98&country=RU&user_device=stationary&cpl_id=1555693533&open_commission=1500&order_amount=10000&status=approved&offer=ClothesTest