In FirstPromoter, you can set up postbacks for your affiliates. Postback URLs are used in digital marketing to pass conversion data between your affiliate program and your promoters. They are created by a conversion tracking platform and used to relay data to your affiliates when a conversion takes place on FirstPromoter.
*Please note: This feature is available only on the Enterprise plan
Setting things up
By default, we provide postbacks for the following events:
Lead Signup and Reward Created.
Please note:
For the click id to be passed, 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
Lead Signup
This event is triggered when a user signs-up/registers for your service. This event does not have any transaction data.
Available parameters:
Click id : {{visitor.sub_id}}
Reward Created
This event is triggered anytime a payment is made on your website and a corresponding commission is generated for the affiliate.
Available parameters:
Click id : {{visitor.sub_id}}
Transaction id : {{reward.id}}
Conversion value/amount : {{reward.amount | divided_by: 100.0}}
Adding the links
Using the link below as an example link provided by an affiliate,
https://pxlmaweb.com/up.php?cid={clickid}&amount={amount}&tran={transaction_id}
the setup on FirstPromoter will the following.
Please note: the links provided by the affiliates for the events may vary for each event. You will need to use the correct
Lead Signup
https://pxlmaweb.com/up.php?cid={{visitor.sub_id}}
Reward Created
https://pxlmaweb.com/up.php?cid={{visitor.sub_id}}&amount={{reward.amount | divided_by: 100.0}}&tran_id={{reward.id}}
Though this is available only in V1 at the moment, you can still access your V1 service and set this up. Simply add v1 to your FirstPromoter URL like this testdomain.v1.firstpromoter.com
to navigate to our V1.
To set up the postback:
1) Navigate to the "Promoters" page on your FirstPromoter account > click on the three menu dots of the desired promoter > Select "Edit promoter";
2) This should open a new page with an edit promoter modal. Select the Advanced Tab and click on "Add Postback";
3) Add the correct URL and select the correct event and "Save".
In this example, we set the webhook for all 3 events however, you can set it only for 1 event if necessary.
Testing
It is ideal to test the postback in order to ensure that it is working as expected.
1. Visit the link provided by your affiliate in a new incognito window or using a different browser;
2. Try a sign-up on the page and check if the referral was created on FirstPromoter successfully;
3. Check with the affiliate to confirm if they received the postback for the lead signup event successfully;
4. Try out a purchase for the lead you just tracked. This should trigger the "Reward Created" event as well.