Updated - Hotfix 3.3.0 (May 2023):
After 25 failed attempts due to error on the Partner's platform to fire a postback, the postback will be automatically disabled [Click Here]
Updated - Hotfix 3.2.0 (March 2023):
Global setting allows networks to expose sale_amount in the Partner UI [Click Here]
Filter added for Delivery Method in Partners - Postbacks [Click Here]
Table of Contents
Overview
This guide will help you set up Partner Postbacks and teach you how to troubleshoot common issues.
For a cheat sheet on how to setup Partner Postbacks from a variety of third-party platforms - [Click Here]
What is a Partner Postback?
Similar to your Advertiser postback, but for your Partners. In this case, they are also creating their own Click ID from their side when a User clicks on your tracking link, so you are able to credit Partners for the business they refer.
Note: A Partner postback can be added or edited from your Portal or the Partner Portal. To remove a Partner's ability to update their own postbacks, navigate to Control Center - Configuration > Global Settings card. Click Edit and turn off the following option:
A Step-By-Step Guide
Step #1
Choose Partner
To see the list of Partner postbacks, select Partners, then Postbacks in the drop down menu.
Step #2
Filter Data and Add/Subtract Columns
You can filter the list by Active, Inactive and All, and customize the columns displayed.
Step #3
Add New Postbacks
You can add a new postback by clicking [+ Postback]. After clicking that button it will take you to this page:
Postback Status: Active means that the status is active. Inactive means that the status is paused.
Description: Provide a description of the postback.
Postback Type:
Conversion (base) is the first conversion action
Event is a secondary conversion action
CPC is the postback for a CPC offer. A CPC Partner Postback is not visible in reporting. Reach out to the customer success team and they can confirm if a CPC postback was fired
Postback Level:
Global (offer) is for firing the postback on all conversions (or events) for that offer
Global is for firing the postback for that Partner on any offer they are sending traffic to
Specific is for a specific Offer and specific Partner.
Delivery Method:
HTML
image pixel
iframe pixel
Postback is a server-to-server (S2S) postback
Step #4
Click ID and Other Parameters
When you add a postback URL here, you need to ensure you have a spot to pass back the click ID. Without this, the postback will not work. You need to map the click ID from the tracking link and enter it as a macro in Everflow.
An example of this would be:
Partner Postback URL:
https://everflowdemopostbackurl.com/?click_id={sub1}
Partner Tracking Link:
https://testaffiliatetrackinglink.com/HDY287/SU273/?sub1=INSERT_CLICK_ID_HERE
**Pro Tip: If you are using ¤cy= in the partner postback, place it as the first parameter/macro in the postback to prevent symbols from breaking the postback.
If you would like to find out how to fire additional data to and from these URLs - [Click Here]
Step #5
View and Edit Postbacks
After you add the postback, you will be able to view it here (Partners > Postbacks). You can use the filter button to narrow down your view by Delivery Method, Offer, or Partner.
Click the vertical dots to Edit, Test, Delete, or see History.
Please Note:
A postback that fails due to an error from the Partner’s platform will be attempted to fire no more than 25 times. If delivery is still unsuccessful after 25 attempts, the Partner’s Postback is automatically disabled. If that Postback is "Global", then the Partner/Advertiser Manager will receive a daily notification of all postbacks that have been disabled for this reason, noting the Pixel ID.
To locate the pixel in Everflow, navigate to Partners > Partner Postback, then search for the Pixel ID.
To verify the server response on a Pixel ID from the Partner's platform, navigate to Reporting > Partner Postback. Then, click the vertical dots at the end of the row and select View Debug Info.
Exposing Sale Amount To Partners
A global setting now allows you to determine whether or not the sale amount can be passed in partner postbacks. By default, this setting is turned off.
When enabled, and {sale_amount} or {amount} is passed with the conversion or event, Partners will be able to see the sale amount associated with the conversion or event, both in their partner postbacks and in Reporting.
Navigate to Control Center - Configuration. Click Edit on the Global Settings tab, and use the toggle to adjust the following setting: Expose Sale Amount to Partner
Testing Postbacks
Now that you have placed your Partner postback, we recommend testing the tracking process from start to finish to ensure it is working properly with your Partner. Once testing is complete, you are all set to launch!
For instructions on testing your Partner's postback - [Click Here]
NEED HELP? OUR CUSTOMER SUCCESS TEAM IS HERE FOR YOU!
We've assembled a superstar team of industry veterans that are available around the clock to make sure that your issues are resolved and questions are answered. You can reach out any time in-platform via Chat or by emailing support@everflow.io.
