Offerwall

The offerwall contains the UI to show the user the rewarded apps which he can install and use. It is contained in a separate activity.

Displaying the offerwall

To display the offerwall call

window.AdjoePlugin.showOfferwall(
  function() {
    // the offerwall was displayed to the user
  },
  function(err) {
    // the offerwall cannot be displayed
  },
);

This will launch the AdjoeActivity displaying the adjoe offerwall. If you need to know in advance whether the user will see the offerwall or not, you can call window.AdjoePlugin.canShowOfferwall(function, function). This method will invoke the success callback if you can show the offerwall and invoke the error callback otherwise.

Before the user can interact with the partner apps on our offerwall, he has to accept the adjoe Terms of Service and grant your app permission to track the usage of other apps in his phone settings.

Sub-IDs You can pass two optional Sub-IDs when you show the offerwall, which will be logged every time a user views or clicks a campaign: window.AdjoePlugin.showOfferwallWithSubIDs('<subId1>', '<subId2>', success, error).

teaser_shown event

You should send the teaser_shown event when the user can see the teaser, e.g. the button via which he can access the adjoe SDK from the SDK App. Trigger this event when the teaser has been successfully rendered and would successfully redirect the user to the adjoe SDK. It should be triggered regardless of whether the user has actually clicked the teaser or not. This event is mostly appropriate for uses, in which the functionality of the SDK App and SDK are kept separate to a relevant degree.

window.AdjoePlugin.sendUserEvent(window.AdjoePlugin.EVENT_TEASER_SHOWN, '<subId1>', '<subId2>');

Best practices for teaser_shown event

It's always good to check if the offerwall can be shown to the user before showing the teaser button.

window.AdjoePlugin.canShowOfferwall(
    function() {
    // show teaser button
        window.AdjoePlugin.sendUserEvent(window.AdjoePlugin.EVENT_TEASER_SHOWN, '<subId1>', '<subId2>');
    },
    function() {
        //can't show the offerwall 
    }
);