Knowledgebase
How do I configure my affiliate for instant crediting through postbacks?
There are a number of steps performed in order to instantly credit a user for an offer.
- The user clicks on an offer which you have added through the admin panel. What's known commonly as their "subid" is appended to the end of this link. So if the user's ID is 123 and they are on a games site with the prefix GMS, their subid is GMS-123, which is appended at the end of the offer link. This is used to track which user completed the offer.
- The user then completes the offer. When they successfully do so, the affiliate is notified of the completion. When the affiliate receives this notification they begin the closed-loop reporting process.
- To initiate this process, the affiliate will call a URL that is hosted on your website. This URL will also contain a number of variables that will be used to determine the offer completed, the user that completed it, and the commission of the offer.
- In order to retrieve the values of these variables, FSR needs to know the names of the variables used to specify the values. Here are some sample URL's
- http://www.yourfreesite.com/pb/postback.php?oid=123&subid=GMS-123&cpa=12.00
- http://www.yourfreesite.com/pb/postback.php?offerid=123&sid=GMS-123&status=1
- http://www.yourfreesite.com/pb/postback.php?oid=123&user=GMS-123
- In the first example, we have 3 variables. The first one is titled oid. This specifies the value of the offer ID, which is 123 in this case. The next variable is subid, which specifies the ID of the user, which is GMS-123 in this case. The last variable is cpa which specifies the commission of the offer, $12.00 in this case. So in FSR, you would simply enter these variable names into the appropriate fields (Postback Offer ID Name, Postback User ID Name, and Postback Commission Name, respectively). The other fields can safely be left blank.
- In the second example we have 3 variables again. The first two are similar to the first case, except the variables are now called offerid and sid instead of oid and subid. The last variable, status, determines whether this report is a credit or a reversal. Not all affiliates do this! In this case, status is our variable name, and 1 is the value used to specify a credit. Let's say 0 is the value used to specify a reversal. So for Postback Credit Status Name you would enter status, for Postback Credit Value you would enter 1 and for Postback Reversal Value you would enter 0.
- In this last case we only have two variables, oid and user. These are the minimum variables we need to specify a credit. So for Postback Offer ID Name you would enter oid and for Postback User ID Name you would enter user.
- You will also need to specify a set of valid IP addresses from which this postback will come. Generally, this information is available on the affiliate website.
- One of the last things you will need to do is properly configure the offer you're running through a particular affiliate. Go to Manage Offers and click on Edit for the offer you wish to run through the affiliate. Choose the appropriate affiliate from drop-down menu. You will also need to enter a value for the CSV/Postback ID field. This is the offer ID that the affiliate will be sending through the postback URL (123 in all the above cases). This is generally available on the affiliate's listing of offers, or may be located somewhere in the offer URL.
- Finally, make sure you enter the proper postback URL into your affiliate's website so they know which URL to call! Pay careful attention if there is any special formatting that needs to be added to the URL in order to get it work. For example, FusionCash requires that you format the URL yourself and enter the values yourself like so: http://www.yourfreesite.com/pb/postback.php?oid=#offerid#&sid=#subid#&cpa=#comm#

