In order to initialize OfferWall , the following parameters should be passed in initialization call: secret key, app id and user id.
The call should look similar to:
public static final String YOUR_OW_SECRET_KEY = ""; //set your value public static final String YOUR_OW_APP_ID = ""; //set your value public static final String YOUR_OW_USER_ID = ""; //set your value OTOfferWallSettings.getInstance().configInit(YOUR_OW_APP_ID, YOUR_OW_SECRET_KEY, YOUR_OW_USER_ID);
- APPID and SECRET_KEY can be found in your OfferToro account, under your "App Placement" settings.
- UserID, is a parameter which should be passed from your end as an id for each end user of your app. A common practice is to use the Google Advertising ID (GAID) . User IDs should be URL encoded.
You can add a maximum of 3 SubIDs, for example:OTOfferWallSettings.getInstance().configSubids(“SUBID1”);
OTOfferWallSettings.getInstance().configSubids(“SUBID1”, “SUBID2”, “SUBID3”);
OfferToro SDK instances should be created in the activity by calling the following method:
After being successfully initialized, OfferWall could be displayed into the app. For displaying the OfferWall
showOfferWall()method should be called:
The OfferToro SDK gives a possibility to be notified of events happening in OfferWall lifecycle via OfferWall listeners.
The following listeners are available:
onOTOfferWallInitSuccess() - invoked when OfferWall is successfully initialized;
onOTOfferWallInitFail(string errorMessage) - invoked when OfferWall initialization fails and receives (@param
errorMessage) describing the reason for fail;
onOTOfferWallOpened() - invoked when OfferWall is displayed;
onOTOfferWallCredited(double credits, double totalCredits)
- receive user's balance (@param
totalCredits) and the amount of credits the user has earned (@param
credits) since the last update.
However, it is not the precise way to calculate the user's balance. For a more robust way, please use the Server-to-Server postbacks instead.
The listener could also be updated at any point of time by calling
Due to server constraints, this feature will not execute automatically anymore, rather, call
getOTOfferWallCredits() manually to retrieve the user's balance.
onOTOfferWallClosed() - invoked when OfferWall is closed.
To be notified of OfferWall events,
setOfferWallListener(OfferWallListener listener) method should be called:
The OfferToro SDK gives possibility to update the
onOTOfferWallCredited() listener in OfferWall lifecycle at any point of time by calling
getOTOfferWallCredits() - updates the
OfferToro SDK supports two ways to reward your users. Those are:
User's balance and the amount of credits the user has recently earned are available via
The listener can be updated on demand by calling
Server to Server postbacks is a more secure way to receive notifications, in order to reward your users.
To receive Server to Server postbacks, you must define your postback URL in your App Placement under your OfferToro account
For more information - Please check this page: