Documentation

Here you will find all the info you need to integrate the various monetization tools OfferToro has to offer.

Postback Notifications

Whenever a user makes a conversion, we will send you a URL request, called a 'Server to Server Postback' with some information. Using this information, you can reward the user who performed the action accordingly.

The postback will be sent to the global postback URL you have defined in your OfferToro's App Placement section .

The information will be sent to your postback URL, in one of 2 methods:


Method 1:

If you are using an Iframe based OfferWall, method 1 is recommended .

In method 1, the postback data added after the end of your postback url such as : http://www.Your-Site.com/pb/?OID=123&user_id=JohnSmith&Amount=10...


Method 2:

In method 2, Postback Data is added to your own parameters such as: http://www.Your-Site.com/pb/?YourParmater1={id}&YourParamater2={oid}&YourClickId=user_id etc...

If you are using our API / Stand-Alone offers, method 2 is recommended.

Our main clickId parameter is called user_id . You can also pass/receive additional subids, using the following subid parameters :

Subid1, subid2, subid3 . Please check our API doc page for more info.



Parameters List

The following is a list of all the parameters which are passed to you for every postback :

  • id = The ID of the conversion in our system
  • oid = The ID of the offer converted in our system
  • amount = The amount that your user should receive for this conversion nominated in your currency. For example if your currency name is Points and your Currency Equivalent field is 35 and the conversion is worth $1, we will send "35" in this field.
  • currency_name = The currency name that you set in your App's Placement page.
  • user_id = The id of your user, the one you have placed in the iframe integration.
  • payout = The publisher's revenue for this conversion.
  • o_name = The name of the offer converted.
  • sig = A signature to be sure the postback is legit. The signature is composed the following way:

    md5(oid + "-" + user_id + "-" + Your App Placement's KEY). You can find your App's Placement key in the App's details page. AKA secret key .

  • package_id (for mobile campaigns only) = The package id for the android / iTunes app.
  • ip_address = IP Address of the user when the click happened.
  • subid1 / subid2 / subid3 = Those would be passed in case you have sent us some subid data (optional)

If you would like to pass those additional subids in your iframe based OfferWall, they can be passed in the following way.

www.offertoro.com/ifr/show/14/UserID/5/0/0/subid1/subid2/subid3.

 

Important:

We expect a "1" (without quotes) as a response to a successfully received postback and a "0" (without quotes) to indicate that the postback was received incorrectly. We will try to send the postback up to 5 times if we have not receiving a "1" as a reply. After that, we will send you an email with the data of the conversion so you can process it manually.

 

Postback IPs

All of our postbacks shall be sent from the following OfferToro IP: 54.175.173.245

Please white-list this IP as this is the ONLY IP we'll be sending postbacks from.