激励广告
激励广告能够向与广告交互的用户提供各种应用内物品作为奖励,如继续游戏、虚拟货币等。这样,用户在广告互动中投入时间后就能获得切实的价值,从而达到推动交互的效果。
以下各节将向您介绍如何加载和显示激励广告。
加载激励广告
以下代码展示了如何附加监听器以及加载第一则激励广告:
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。
设置激励广告的金额和币种
要设置激励广告的金额和币种,请按照下列步骤操作:
- 在 Edit Ad Unit 页面点击Add S2S Reward Callback:
- 添加 Server Side Callback URL、Reward Amount和 Rewarded Currency Name: