Conversion tracking
Conversion information can be transmitted by:
The Conversion Tracking Types
Advertiser Postback Integration
Postbacks, in general, are URLs that are used to pass information about conversion. Postbacks allow servers to communicate with each other directly. A client is not involved, no cookies are used on a visitor’s computer. Once activated by an advertiser`s platform, these links send information to the Indoleads/Oneklix platform. It's a preferable way to receive notifications about conversions as they do not rely on cookies, which can be blocked by browsers, and as we move to a cookieless world this will be even more beneficial.
Postback implementation requires from advertiser to store and send back click ID value back. All the other tokes represent values from the advertiser`s side (like rate, sale_amount, txn_id, etc).
https://app.indoleads.com/acquisition?click_id=CLICK_ID&security_token=SECURITY_TOKEN&rate=AMOUNT¤cy=USD&txn_id=UNIQUE_TRANSACION_ID
Note: in this article Postback, Pixel, and Container URLs use the app.indoleads.com domain, however, the trk.indoleads.com domain could also be used for the conversion tracking.
For example https://app.indoleads.com/acquisition?click_id=CLICK_ID&security_token=SECURITY_TOKEN&rate=AMOUNT¤cy=USD&txn_id=UNIQUE_TRANSACION_ID
and https://trk.indoleads.com/acquisition?click_id=CLICK_ID&security_token=SECURITY_TOKEN&rate=AMOUNT¤cy=USD&txn_id=UNIQUE_TRANSACION_ID
are actually points to the same handler. As well as https://app.indoleads.com/js/platform/pixel.js
and https://trk.indoleads.com/js/platform/pixel.js
refers to the same file.
Tracking ClickID in Postback URLs:
To ensure the accuracy of the recorded data, Indoleads/Oneklix tracking platform has to identify everything that is going on with a visit. So we generate a unique ID and assign it to each visitor’s click on an Offer URL that is hidden behind an ad.
This means that each click has its own, unique value, called click ID.
This is important, as click IDs are used to verify conversions. After all, the conversion is what generates money for publishers and advertisers, so we have to make sure that all of them are real and passed to your affiliate program or affiliate network. Our tracker does not just accept any postbacks sent toward it. It only accepts the ones that contain their own click ID value that has been assigned to the original click and security token which is unique per advertiser and should match the values stored while processing the visitor's click.
In the offer URL, we pass an Indoleads’s click ID value to an advertiser`s platform.
In the postback URL, click ID is passed back as proof that this conversion has been triggered by Indolead`s visitor, as well as the security token as proof that postback was sent by advertiser`s platform.
Params available for the Postback URL:
click_id – is a unique and dynamic set of characters, generated by Indoleads Network. It is sent through an offer URL and returned through POSTBACK URL after the conversion is complete.
security_token - unique token provided to Advertiser, available on the offer detail page
rate | revenue – commission amount
sale_amount - for the case, if the commission amount is not defined
currency - the currency of conversion
cat– the category code and our system applies payout for the category accordingly.
txn_id – unique order/transaction id generated from your platform, any random unique number. This helps to avoid duplicates.
status - it may be the value of:
pending (by default)
approved
declined
sub1 - a parameter that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
sub2 - a parameter that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
sub3 - a parameter that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
sub4 - a parameter that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
Pixel
Pixel tracking means a piece of code or markup that has to be implemented on a "thank you" page to report conversions. When this page loads, the script makes a request to a target platform. The script runs on a client’s side.
Note: Pixels may not be 100% reliable because they may be blocked or removed by software or user action, leaving us without any confirmation. It should be used just in case when an advertiser has no ability to track click_id by themself.
To implement pixel tracking please add an <img> tag (like in the example below) on your “thank you page”, and don't forget to replace tokens with real values:
<img style="visibility:hidden;" src="https://app.indoleads.com/pixel?adid=3&rate=AMOUNT¤cy=USD&txn_id=UNIQUE_TRANSACION_ID&cat=CATEGORY_CODE">
If you separate payout for publishers by categories you should send us a specific marker as cat query parameter, where we can detect which category of payout it applies.
<img src=”https://app.indoleads.com/api/pixel?adid=206&sale_amount=AMOUNT¤cy=MYR&cat=fashion”>
There is also the ability to send click id value using the click_id
query parameter in the pixel image URL.
Note: in case an advertiser decides to send us click_id in the click_id query parameter it should be blank if it’s not our traffic, as it can lead to high server resource utilization.
adid – your unique offer in indoleads.com platform
rate – commission amount
txn_id – unique order/transaction id generated from your platform, any random unique number. This helps to avoid duplicates.
sale_amount – the amount of purchase made from our traffic
currency – the currency of amount in 3 symbol currency code (for e.g. MYR Malaysian Ringgit)
cat– here we understand that is the specific payout for the “fashion” category and our system applies payout for the category accordingly.
In the sale amount, you need to put the exact amount of the purchase made.
As long as it’s pixel no need to add anything specific into tracking link (except your personal marks for e.g. UTM for Google analytics). Each user that comes with our traffic from our tracking links all the information will be stored in browser cookies which ones we can read in the pixel if conversion from the user occurs.
sub1 - a parameter that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
sub2 - a parameter that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
sub3 - a parameter that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
sub4 - a parameter that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
Click_id will be detected by the cookie.
Container
Container is an advanced version of Pixel tracking type with all its benefits and drawbacks.
To implement conversion tracking via Container add script tag like in the block section below, on your “thank you" page:
* There is no way to use sub1-sub4 parameters with Container integration type.
Click_id will be detected by a cookie.
API
API is the most advanced way to track conversions. Implementation could be prepared by Indoleads DEV team If an advertiser already has API for fetching conversions from their platform, please provide us with API docs in such case.
To use sub1-sub4 the Advertiser should notify us which values from your API should be stored on our side and we will prepare the appropriate implementation on our side.
What type should be used?
POSTBACK - if the advertiser has the ability to send requests to our system from his back-end. The advertiser should store on his side click ID which he will send in a postback request.
PIXEL or CONTAINER – if the advertiser sends requests from the front – end or has no ability to store click ID on his side. The pixel uses COOKIES that’s why all requests are sent from the client’s browser after certain actions.
To prevent the occurrence of conversion duplicates in both you should add to it TXN ID with a unique identifier of for example saleID (order ID on the advertiser side)
Rate and Sale amount parameters
sale_amount - if we can't get exact payout from an advertiser.
If you used sale_amount publisher reward will be calculated based on offer commissions and type of offer (CPA - fixed amount, CPS & CPI - percentage commission)
categories - provides ability to manage payouts according to provided category code
rate - if we CAN get exact payout from an advertiser
In case of using rate offer commissions won’t be used. Publisher reward will be calculated based of network commission (rate - network commission = publisher payout)
Sub1 - Sub4 Parameters
Sub1 - Sub4 parameter are that may be used by an Advertiser to set any custom value they want to track in the Indoleads Platform.
E.g. a common practice is for advertisers to pass in their unique session ID on the click-through in the sub1 - sub4 parameters.
Also, those parameters could be used to track extra order details like Item SKU, Color, Qty, etc.
Country Tracking
The country tracked for converions is sourced from the IP of the original click buy the user.
Later once a conversion occurs the country value is copied from the click to conversion and available in the converion log.