![Perform[cb] Logo](https://s3.amazonaws.com/cb-blog-prd/wp-content/uploads/2020/02/22170004/logo-mini.svg){kind=logo}
![Perform[cb] Logo](https://cb-blog-prd.s3.amazonaws.com/wp-content/uploads/2020/12/29053717/PerformCB_colored-logo-195x37px.svg){kind=logo}
![Perform[cb] Logo](https://www.performcb.com/wp-content/themes/performcb/assets/images/logoRed.svg)
If you are a marketer using a proprietary platform, we have included some technical instructions for your developers to help you get Perform[cb]'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 Perform[cb] passes the {clickid} parameter to your URL.
This is done on your Marketer 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 Perform[cb] 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://domain.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://domain.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 Perform[cb] to your HTML page.
Perform[cb] Placeholder | Requirement | Description |
REPLACEWITHOFFERID | Mandatory | Offer ID as provided by Perform[cb] |
REPLACEWITHCLICKID *Only for Postback URL | Mandatory | Perform[cb] 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 Perform[cb], 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 } ?> |