Rewarded Ads

“What are Rewarded Video Ads?” from AppLovin’s Blog.

Loading a Rewarded Ad

The following code shows you how to attach listeners and load the first rewarded ad:

const REWARDED_AD_UNIT_IDS = {
  "android" : "android_rewarded_ad_unit_ID"
  "ios" : "ios_rewarded_ad_unit_ID",
}

func _initialize_rewarded_ads():
  var platform = OS.get_name().to_lower() # "android", "ios", etc.
  var ad_unit_id = adUnitsDict.get(platform)  

  var rewarded_listener = AppLovinMAX.RewardedAdEventListener.new()
  rewarded_listener.on_ad_loaded = Callable(self, "_on_rewarded_ad_loaded")
  rewarded_listener.on_ad_load_failed = Callable(self, "_on_rewarded_ad_load_failed")
  rewarded_listener.on_ad_displayed = Callable(self, "_on_rewarded_ad_displayed")
  rewarded_listener.on_ad_display_failed = Callable(self, "_on_rewarded_ad_display_failed")
  rewarded_listener.on_ad_clicked = Callable(self, "_on_rewarded_ad_clicked")
  rewarded_listener.on_ad_received_reward = Callable(self, "_on_rewarded_ad_received_reward")
  rewarded_listener.on_ad_hidden = Callable(self, "_on_rewarded_ad_hidden")
  AppLovinMAX.set_rewarded_ad_listener(rewarded_listener)

func _load_rewarded_ad():
  var platform = OS.get_name().to_lower() # "android", "ios", etc.
  var ad_unit_id = adUnitsDict.get(platform)
    
  AppLovinMAX.load_rewarded_ad(ad_unit_id)

### Rewarded Ad Callbacks

func _on_rewarded_ad_loaded(ad_unit_id: String, ad_info: AppLovinMAX.AdInfo):
  # Rewarded ad is ready to be shown. AppLovinMAX.is_rewarded_ad_ready(ad_unit_id) will now return 'true'
  print("Rewarded ad loaded from" + ad_info.network_name)
    
func _on_rewarded_ad_load_failed(ad_unit_id: String, errorInfo: AppLovinMAX.ErrorInfo):
  ⋮
    
func _on_rewarded_ad_displayed(ad_unit_id: String, ad_info: AppLovinMAX.AdInfo):
  ⋮
    
func _on_rewarded_ad_display_failed(ad_unit_id: String, errorInfo: AppLovinMAX.ErrorInfo, ad_info: AppLovinMAX.AdInfo):
  ⋮
    
func _on_rewarded_ad_clicked(ad_unit_id: String, ad_info: AppLovinMAX.AdInfo):
  ⋮

func _on_rewarded_ad_received_reward(ad_unit_id: String, ad_info: AppLovinMAX.AdInfo, reward: AppLovinMAX.Reward):
  ⋮
    
func _on_rewarded_ad_hidden(ad_unit_id: String, ad_info: AppLovinMAX.AdInfo):
  ⋮

Showing a Rewarded Ad

To show a rewarded ad, call ShowRewardedAd():

var platform = OS.get_name().to_lower() # "android", "ios", etc.
var ad_unit_id = REWARDED_AD_UNIT_IDS.get(platform)  

if AppLovinMAX.is_rewarded_ad_ready(ad_unit_id):
    AppLovinMAX.show_rewarded_ad(ad_unit_id)

S2S Rewarded Callbacks

Impression-level revenue data helps you better understand your users, calculate ROI precisely, and build accurate LTV models. MAX gives you revenue information associated with each impression, as well as information about the demand source and the creative served for supported networks.

You can either process the data directly yourself, or work with any of our supported analytics providers, which are listed in the “MMP Integration: MAX to MMP” section of this page.

Direct Integration: MAX to You

There are three ways you can get user-level revenue data:

User Revenue API

Use this API to retrieve user-level revenue data on a daily basis. You can retrieve this data aggregated for a particular user or with one row per impression. Data is available eight hours after UTC day end. Read more about it on the User Revenue API documentation page.

Client-Side

Starting in SDK version 10.3.0+, you can access impression-level user revenue data on the client side in real-time. You can find integration instructions in the Advanced Settings page.

Server-to-Server

If you want to access real-time revenue data on the server side, you can provide an impression postback to track impression-level user ad revenue data. Please contact your account team or the support team to enable this feature. This feature and the macros that the impression postback supports are described in the “Server-to-Server Impression Revenue API” section of this page.

MMP Integration: MAX to MMP

MAX partners with various analytics solutions to help you easily access your data in a single dashboard. You can work with any of our supported partners such as Adjust, GameAnalytics, AppsFlyer, or Singular to access impression-level ad revenue or aggregated ad revenue data. Please refer to the documentation pages maintained by those partners for more information.

Server-to-Server Impression Revenue API

Please contact your account team or the support team to enable this feature.

AppLovin can send (HTTP or HTTPS) GET requests, from its servers to an external endpoint that you define, whenever a MAX impression is recorded. AppLovin makes these postbacks soon after the impression, but they may be delayed by up to a few minutes. You can use an impression timestamp macro to reconcile any delay between the impression and the postback times.

If the postback receives a non-200 response code, AppLovin will retry the postback up to three more times: twice right away and then once more about 60 seconds later. The postback request will timeout if five seconds pass without a response.

Example

https://myimpressionserver.com/impression?idfa={IDFA}&user_id={USER_ID}&event={EVENT_ID}&token={EVENT_TOKEN}

Available Macros

You can incorporate any of the macros in the following table into your postback URL (as in the example URL above). AppLovin’s servers will replace these macro names with accurate values at the time it makes the postback to your server.

Setting the Reward Amount and Currency

To set the reward amount and currency, click Add S2S Reward Callback in your Edit Ad Unit page:

Add the Server Side Callback URL, Reward Amount, and Rewarded Currency Name: