Postback URLs are used in digital marketing to send conversion data from your affiliate program to your promoters. They provide a way for affiliates to send information/data to a third-party 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
