If you are an advertiser using a proprietary platform, we have included some technical instructions for your developers to help you get Clickbooth’s Postbacks/Pixels placed and tracking! 


We suggest using both HTML and Postback tracking given they provide you with the functionality of cookie-based tracking and server-to-server tracking. 



Step 1 - The Initial Click

There are two parts of setting up the pixel.

The first part is to make sure Clickbooth passes the {clickid} parameter to your URL.

This is done on your Advertiser login, when creating/editing the offer.

You want to make sure that your Offer URL looks something like this


https://domain.com/….&subid={clickid}


On your side, you need to make sure this {clickid} is stored. 

We suggest storing this in databases such as MySQL, MongoDB, DynamoDB or just in user’s session. Please note that if you are storing it in session, you are still relying on cookies. They would be first party cookies, so your chances of blocking are smaller - but still, it is possible that this information will be lost.



Step 2 - Conversion Point

When a conversion is achieved, configure your platform to send a server 2 server to notify Clickbooth that the conversion happened.

In order for the conversion to be valid, you need to pass the {clickid} parameter that you collected on initial site visit (step 1)


Once the conversion is achieved, you need to make a server to server call with URL as follows:


https://track.clickbooth.com/l/con?oid=REPLACEWITHOFFERID&clickid=REPLACEWITHCLICKID&cbtid=TRANSACTIONID


To setup the iFrame pixel, just make add your iFrame pixel to the HTML of your page. 

Example iFrame pixel:

<iframe src="https://track.clickbooth.com/l/con?cbiframe=1&oid=REPLACEWITHOFFERID&cbtid=TRANSACTIONID" scrolling="no" frameborder="0" width="1" height="1"></iframe>


This can be done by manually copy/pasting the Tracking Pixel code from Clickbooth to your HTML page.



Clickbooth Placeholder

Requirement

Description

REPLACEWITHOFFERID

Mandatory

Offer ID as provided by Clickbooth

REPLACEWITHCLICKID

*Only for Postback URL

Mandatory

Clickbooth Click ID that you have recorded on the initial visit

TRANSACTIONID

*For both Pixel and Postback

Optional, but recommended

ActionID, TransactionID or any other ID that you generate on your side and want to pass it to Clickbooth, for easier tracking down the road.


Postback PHP Example code:



<?php


// create curl resource 

$ch = curl_init();



// set url - this assumes you have clickid loaded up in $clickid variable and optional $transactionid 

curl_setopt($ch, CURLOPT_URL, "https://track.clickbooth.com/l/con?oid=REPLACEWITHOFFERID&clickid=" . $clickid . "&cbtid=" . $transactionid);



//return the transfer as a string 

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);



// $output contains the output string 

$output = curl_exec($ch);



// error handling

if (curl_errno($ch)) {

    $error_message = curl_error($ch);

}



// close curl resource to free up system resources 

curl_close($ch);


//error handling

if (isset($error_message)) {

    // TODO - Error happened. Retry the connection later

}


?>