Postback URLs are used in digital marketing to pass conversion data between your affiliate program and your promoters. They provide a way for affiliates to send information/data to a thirdparty service when an event occurs on the FirstPromoter.
*Please note: This feature is only available on the Enterprise plans
Setting things up
By default, we provide postbacks for the following events:
New referral, New customer and New commission.
Please note:
To pass the click_id the referral link used by your affiliate must contain the correct click id set as fp_sid. e.g: If your affiliate referral link is https://testdomain.com?fpr=mywebsite and your click id is clk-id-12test, the link used by the affiliate for referrals should resolve to https://testdomain.com?fpr=mywebsite&fp_sid=clk-id-12test
New referral
This event is triggered when a user signs-up/registers for your service using an affiliate link. This event does not have any transaction data.
Available variables:
Click id : {{visitor.sub_id}}
New customer
This event is triggered when a referral makes their first payment
Available variables:
Click id : {{visitor.sub_id}}
New Commission
This event is triggered anytime a payment is made on your website and a corresponding commission is generated for the affiliate on FirstPromoter.
Available variables:
Click id: {{visitor.sub_id}}
Event id: {{event.id}}
Event type: {{event.etype}}
Conversion amount: {{reward.amount | divided_by: 100.0}}
Reward amount: {{reward.amount | divided_by: 100.0}}
How to add postback URLs
Postback URLs can be added by both admins and affiliates.
Admin Section
On the admin side navigate to the "Promoters" page > select your preferred promoter > click on Postbacks > New Postback
Affiliate Section
On the affiliate side click on the profile icon > select Postbacks > Create Postback
Testing
It is ideal to test the postback to ensure that it is working as expected. This can be done by simply clicking the Test postback button in when creating the postback