AppLovin plugin: now with rewarded/incentivized ads

08 February 2016

AppLovin plugin: now with rewarded/incentivized ads

We are pleased to announce a new feature in the AppLovin plugin: rewarded/incentivized video ads! These ads — in contrast to standard graphical interstitial and video interstitial ads — can be implemented to reward users with some form of in-app currency upon viewing the ad. For example, if your game uses “coins” as an in-app currency, you can award the player with some coins each time they view a rewarded video ad.

AppLovin setup

To implement rewarded/incentivized ads, you must enable and configure them on a per-app basis within the AppLovin developer portal. The process is straightforward: basically just enable the feature, choose a frequency capping option, set up the virtual currency, select the modal options, and save your settings.

API changes

To use rewarded/incentivized ads within Corona, simply add the isIncentivized parameter (boolean value of true) to your applovin.load(), applovin.show(), or applovin.isLoaded() API calls. For instance:

Note that incentivized ad offers can be limited to a certain amount in a given day, defined under “frequency capping” in the AppLovin developer portal. If you are using frequency capping, we recommend that you check for an event.phase value of "validationExceededQuota" to determine if the limit has been reached. When this occurs, you may consider showing a normal graphical or video interstitial ad instead.

Listener changes

When using rewarded/incentivized ads, you can use the same event listener function as always, although you will find some new data passed in relation to incentivized ads.

First and foremost, the event table will contain a new entry called event.data. This is a table containing key-value pairs related to incentivized/rewarded video events. For instance, after a user has successfully completed watching a video, event.data will contain the key-value pairs associated with the rewarded currency:

• event.data.currency — The type of currency.
• event.data.amount — The amount of currency rewarded.

In addition, the event.phase string may be one of the following values, all specifically related to incentivized/rewarded video ads:

• "declinedToView" — Indicates that the user chose “no” when prompted to view the ad.
• "validationSucceeded" — Indicates that the user viewed the ad and that their reward was approved by the AppLovin server.
• "validationExceededQuota" — Indicates that the AppLovin server was contacted, but the user has already received the maximum amount of rewards allowed in a given day.
• "validationRejected" — Indicates that the AppLovin server rejected the reward request.
• "validationFailed" — Indicates that the AppLovin server could not be contacted.

In summary

This new addition to the AppLovin plugin gives you even more options for engaging and monetizing your users. For more information, please read the documentation or download the basic sample app from GitHub at https://github.com/coronalabs/plugins-sample-applovin.