跳转到内容

激励广告

激励广告能够向与广告交互的用户提供各种应用内物品作为奖励,如继续游戏、虚拟货币等。这样,用户在广告互动中投入时间后就能获得切实的价值,从而达到推动交互的效果。

以下各节将向您介绍如何加载和显示激励广告。

加载激励广告

以下代码展示了如何附加监听器以及加载第一则激励广告:

const REWARDED_AD_UNIT_IDS = {
"android" : "«Android-ad-unit-ID»",
"ios" : "«iOS-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):

显示激励广告

要显示激励广告,请调用 show_rewarded_ad()

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 激励回传

您可以通过货币服务器接收回传。 要了解操作方法,请参阅 MAX S2S Rewarded Callback API 指南。 随后,在Edit Ad Unit页面更新Server Side Callback URL

设置激励广告的金额和币种

要设置激励广告的金额和币种,请按照下列步骤操作:

  1. Edit Ad Unit 页面点击Add S2S Reward Callback:Ad Type: ☐App Open, ☐Banner, ☐Interstitial, ☐MRec, ☐Native, ☑Rewarded.Add S2S Reward Callback.
  2. 添加 Server Side Callback URLReward AmountRewarded Currency Name:Ad Type: ☐App Open, ☐Banner, ☐Interstitial, ☐MRec, ☐Native, ☑Rewarded.Hide Callback Settings. Server Side Callback URL form field. Reward Amount form field. Rewarded Currency Name form field. AppLovin Event Key form field.