What is a postback?
Postback serves as a means to interact with the tracking system of your affiliate.
Here's how it goes:
First, you need to receive a postback URL from the affiliate.
Once received, you integrate it into your Trackbox and provide your affiliate with a tracking link (landing page).
As soon as your affiliate sends you a lead, our system will fire a postback to your affiliate and a new lead will be registered on the affiliate's tracking system.
What information is required for a postback?
1) You need to provide your affiliate with a tracking link from Marketplace (a landing page).
There are two possible ways to connect a landing page to Trackbox:
First option
Integrate with Trackbox via API
Our API DOC is here:
Second option
Via Trackbox form
In order to use our form, go to system settings:
Then go to Lp registration form:
Copy the HTML code and download the Javascript file.
You need to upload the Javescrkupt file to the server where you host the landing pages.
You need to implement the HTML code inside the landing page.
For more info about how to implement the form, please read our marketplace manual.
2) Your affiliate needs to provide you with a postback for lead event and deposit (FTD) event.
Please make sure they provide you with postbacks for both, not just one.
Note that the lead and FTD postbacks may either differ or be identical.
Make sure to ask the affiliate what the parameter is for clickId in their system and if they need any extra info other than clickId.
How to implement the postback:
Let's say the affiliate provided you with these postbacks:
For Lead:
For FTD:
Steps to implement the postbacks:
Go to the menu and look for postbacks:
Then make sure you are in "pixels" and click on + to create a new postback:
After clicking on +, a new screen will pop up:
Here you need to give this new postback a name, select an affiliate (only one per postback) and you can also make a comment in "note).
Auto assign - this option is enabled automatically.
It means that the postback you're creating will be auto-assigned to existing and future campaigns of this affiliate.
If you need this postback to be relevant to some specific campaign only or some campaigns, you can just disable "auto assign" and choose the campaigns you want.
In lead, you need to insert the lead postback, and in FTDs you need to insert the FTD postback.
for clickid use {{MPC_3}} or as the affiliate guides you
for extra info use {{MPC_1}} or {{MPC_2}} or {{MPC_4}}
for payout use {{payout}}
for Trackbox uniqueid use {{transactionId}}
in our example, the URL for lead is:
You need to replace <payout> and <clickid> with {{payout}} and {{MPC_3}}
It would look like this:
Make sure that after implementing the postback you have parameters and values under "Params", as in the screenshot above.
If after implementation you can't see parameters in Params, it means it was set wrongly.
For example:
Method - always choose GET, unless the affiliate is telling you otherwise.
in our example, the URL for FTD is:
You need to replace <payout> and <clickid> with {{payout}} and {{MPC_3}}
It would look like this:
After implementing both postbacks, press on Add.
Please note
If you want your affiliate to get CPL / CPA payout on his postback, you must set up a payment plan deal for this affiliate.
Please read our payment plan manual for more information.
How to make a test:
After you set up the postbacks of your affiliate, you need to ask him for a test link.
He will provide you with a test link from his tracking system. After making a test, wait 5-7 minutes, and then go to Postbacks -> Pixel log:
check if the postback was fired (in HTTPS status you will get status 200), copy the postback, and send it to your affiliate to verify that everything is working.
Common problems associated with postbacks:
The postback is not firing
Postback not firing is a common issue and can occur for different reasons.
First, please make sure that the postback is set correctly, so the parameters are set under "params":
Next, let's make sure that the lead that has not been fired is set to the relevant affiliate and campaign in your system.
This means that if you have set a postback for affiliate "test" to campaign 1, then the test in your system belongs to "test" and to campaign 1 as well.
If everything is set correctly, let's check which data you're getting from the affiliate for this lead and if it matches what you have set for the postback.
In case you've set MPC_3 to cnv_id like in the example above, you need to make sure that for this lead the affiliate has sent you the click id in MPC_3.
You can check it by clicking on the relevant lead in "lead" and looking for "free parameters" section (the parameters you're getting from an affiliate for each lead):
If they haven't sent the click id in the parameter you have set - it may be the reason the lead is not firing to them.
If you're getting the relevant data from the affiliate for the lead, let's check pixel log and search for the lead.
Take the lead's unique id and search for it in pixel log:
Under HTTP status you should see 200 and in URL you'll see the fired postback
In case you see any other status other than 200 - please check with the affiliate why. They would have to check with their support why they didn't accept it.
In case the status is 200 and they can't see the lead fired in their system - send them the URL that was fired so they can check and make sure it's correct.
Also, feel free to contact support so they can check the postback.
In case you can't find the lead by unique id in pixel log at all, please contact support so they can check.
Payout is 0
In case the pixel was fired but you see payout set to 0 instead of an actual value, it may be due to two reasons:
There's no set payment plan for this affiliate and for this campaign.
in order to fix that, you need to set it up, and then it will be shown for future leads.
for more info about payment plans, please refer to our payment plans manual.
You have changed the lead to depositor manually.
Payout for a postback will be shown only when the broker have changed the lead to depositor in their system. Once it's a depositor on your side and has been approved in Falcon - the postback will be fired to the affiliate's system and they will see the payout amount.