App Open 广告
在 Android 应用中集成 CloudX App Open 广告
App Open 广告是全屏广告位,适用于应用回到前台等场景,例如用户将应用切到后台后再次返回。
支持的网络
App Open 需求由以下竞价网络提供:
Google Mobile Ads waterfall 适配器同样支持 App Open 广告位,用于 AdMob waterfall 流量。
class MainActivity : AppCompatActivity(), CloudXAppOpenListener, CloudXAdRevenueListener {
private lateinit var appOpenAd: CloudXAppOpenAd
private fun createAppOpenAd() {
appOpenAd = CloudX.createAppOpen(this, "your-app-open-ad-unit-id")
appOpenAd.listener = this
appOpenAd.revenueListener = this
appOpenAd.load()
}
private fun showAppOpenAd() {
if (appOpenAd.isAdReady) {
appOpenAd.show(this, "app_foreground")
}
}
// CloudXAppOpenListener callbacks
override fun onAdLoaded(cloudXAd: CloudXAd) {
Log.d("CloudX", "App Open ad loaded from ${cloudXAd.networkName}")
}
override fun onAdLoadFailed(adUnitId: String, cloudXError: CloudXError) {
Log.e("CloudX", "App Open ad failed to load: ${cloudXError.message}")
}
override fun onAdDisplayed(cloudXAd: CloudXAd) {
Log.d("CloudX", "App Open ad displayed")
}
override fun onAdDisplayFailed(cloudXAd: CloudXAd, cloudXError: CloudXError) {
Log.e("CloudX", "App Open ad failed to display: ${cloudXError.message}")
appOpenAd.load()
}
override fun onAdHidden(cloudXAd: CloudXAd) {
appOpenAd.load()
}
override fun onAdClicked(cloudXAd: CloudXAd) {}
// CloudXAdRevenueListener callback
override fun onAdRevenuePaid(cloudXAd: CloudXAd) {
Log.d("CloudX", "App Open bid-time revenue: ${cloudXAd.revenue}")
}
override fun onDestroy() {
super.onDestroy()
appOpenAd.destroy()
}
}请谨慎使用 App Open 广告,仅在自然的应用打开或回到前台转场中展示。避免在用户已经与应用内容交互时展示。
广告就绪状态
isAdReady 从广告加载完成起保持为 true,直到您展示该广告或销毁广告对象。广告网络可能在未通知 SDK 的情况下无法再展示某个广告。此时 isAdReady 仍为 true,该问题会在您调用 show() 时被发现。如果广告网络确实报告其广告已过期,广告将不再就绪。
- 如果对广告网络已无法展示的广告调用
show(),会触发onAdDisplayFailed,广告不再就绪。请调用load()获取新广告。 - 在这种情况下,如果 CloudX 已为您的应用和广告单元启用展示恢复,SDK 会加载并展示一个替换广告。您会收到替换广告的展示和收益回调,不会收到
onAdDisplayFailed。如果过期广告的替换广告已在加载中,SDK 会使用它,并在展示前触发onExpiredAdReloaded。如果替换广告加载失败,或未能在 CloudX 设定的时限内就绪,会触发onAdDisplayFailed。 - 如果在广告已就绪时调用
load(),不会发起新请求,并会立即以该广告触发onAdLoaded。 - 在广告展示期间调用
load(),会在广告关闭后执行。在show()等待恢复替换广告期间调用load(),同样会在展示结束后执行,并且只会收到一次onAdLoaded或onAdLoadFailed。
过期广告
已加载但在过期前未展示的广告,会在同一广告对象上自动重新加载。在替换广告就绪之前,当前广告保持就绪状态,仍可展示。
- 如需在替换广告就绪时收到通知,请设置
expirationListener。自动加载完成的替换广告不会再次触发onAdLoaded。 - 如果在替换广告加载期间展示广告,替换广告会被保留。如果广告关闭时替换广告已就绪,或在其就绪前没有调用
load(),替换广告会在广告对象上变为就绪,届时会调用expirationListener。如果在广告关闭后、替换广告仍在加载时调用load(),该load()会发起自己的请求并收到onAdLoaded,之后不会再针对该替换广告调用expirationListener。 - 如果在过期广告仍处于已加载状态时调用
load(),不会发起新请求,并会立即以该过期广告触发onAdLoaded。替换广告会继续加载,就绪时会调用expirationListener。 - 如果在过期广告仍处于已加载状态时替换广告加载失败,会触发
onAdLoadFailed,广告不再就绪。重新加载及其重试由 CloudX 按广告单元配置,且默认不重试,因此一次无填充就会在此结束。这是正常结果,并非集成错误:请在延迟一段时间后再次调用load(),避免立即循环重试。
appOpenAd.expirationListener = CloudXAdExpirationListener { expiredAd, newAd ->
Log.d("CloudX", "Expired App Open ad replaced by an ad from ${newAd.networkName}")
}appOpenAd.setExpirationListener((expiredAd, newAd) ->
Log.d("CloudX", "Expired App Open ad replaced by an ad from " + newAd.getNetworkName()));