Skip to main content

插屏广告

一.集成建议#

主要介绍在项目中如何集成 TradPlus SDK的插屏:

  • (1)插屏广告一般是全屏的,调用时机是在页面切换时,一般有图片和视频两种,部分渠道会有定制化的插屏。
  • (2)插屏广告一般需要预加载,在需要展示插屏前判断IsInterstialReady()是否准备好,准备好后可以调ShowInterstitialAd()

注意事项#

  • (1)禁止在OnInterstitialAdFailed回调中执行广告加载的方法,否则会引起多个无用请求。
  • (2)禁止在OnInterstitialAdAllLoaded回调中直接执行广告展示的方法。SDK有广告会过期自动补充功能。如果在OnInterstitialAdAllLoaded回调中执行ShowInterstitialAd(),开发者会无法精准控制广告展示的时机。

二.API说明#

1.加载类API#

  • 初始化广告位、请求广告
方法说明
TradPlus.LoadInterstitialPluginsForAdUnits("AdUnitId");初始化广告位。
仅初始化时调用一次。
TradPlus.IsInterstialReady("AdUnitId");检查是否有可用广告。
  • 展示广告(方法一)
方法说明
TradPlus.ShowInterstitialAd("AdUnitId");展示广告
TradPlus.InterstitialEntryAdScenario("AdUnitId");进入广告场景
  • 展示广告(方法二)
方法说明
TradPlus.ShowInterstitialAd("AdUnitId","sceneId");展示广告并设置广告场景ID
使用该方法必须调用TradPlus.RewardedVideoEntryAdScenario("AdUnitId","sceneId")
TradPlus.InterstitialEntryAdScenario("AdUnitId","sceneId");进入广告场景,并传入sceneId广告场景ID
  • 参数说明
参数说明
广告位ID adUnitIdTradPlus后台创建。应用管理——添加应用——添加广告位。注意广告类型创建错误会导致广告展示失败,例如用标准原生的广告位去请求激励视频广告。
广告场景ID sceneIdTradPlus后台创建。应用管理—— 广告场景。具体如何使用,请看广告场景的调用时机和用途说明

2.监听回调API#

  • 监听回调中的参数说明
参数说明
TPAdInfo广告位ID、三方广告平台、ecpm等信息,具体请参考回调信息说明
errorMsg广告请求失败、广告展示失败的错误信息,具体请参考错误码、错误信息说明
  • 广告位维度回调监听 V6.4.5新增API
  • 开发者可通过TradPlusManager调用
方法参数说明
OnInterstitialAdLoadedstring tpAdInfo广告加载成功。
OnInterstitialAdFailedstring adUnitId ,string errorMsg广告加载失败。
OnInterstitialAdImpressionstring tpAdInfo广告展示。老版本API为TradPlusManager.OnInterstitialShownEvent
OnInterstitialAdClickedstring tpAdInfo广告被点击。老版本API为TradPlusManager.OnInterstitialClickedEvent
OnInterstitialAdClosedstring tpAdInfo广告被关闭。老版本API为TradPlusManager.OnInterstitialDismissedEvent
OnInterstitialAdVideoErrorstring tpAdInfo,string errorMsg广告播放失败。
V7.3.0新增回调参数 errorMsg
OnInterstitialVideoPlayStartstring tpAdInfo视频播放开始。部分广告平台支持。
Android V8.1.0.1新增
iOS V7.8.10新增
OnInterstitialVideoPlayEndstring tpAdInfo视频播放结束。部分广告平台支持。
Android V8.1.0.1新增
iOS V7.8.10新增
  • 广告源维度回调监听 (可选) V6.4.5新增API
方法参数说明
OnInterstitialAdAllLoadedbool isSuccess,string adUnitId广告位的状态。
请求广告后,一次load()操作完毕后才会回調一次,可以用于判断是否有可用广告;
true表明有可用广告,false表明没有可用广告。老版本API为TradPlusManager.OnInterstitialAllLoadedEvent
OneInterstitialLayerLoadFailedstring tpAdInfo配置多个广告源,每个广告源加载失败后会都会回调一次。。老版本API为TradPlusManager.OnInterstitialFailedEvent
OneInterstitialLayerLoadedstring tpAdInfo配置多个广告源,每个广告源加载成功后会都会回调一次。。老版本API为TradPlusManager.OnInterstitialLoadedEvent
OnInterstitialLoadAdStartstring tpAdInfo请求广告后,广告开始加载。
V7.9.0 废弃
OneInterstitialLayerStartLoadstring tpAdInfo每层waterfall 向三方广告源发起请求前,触发的回调。
V7.9.0 新增回调
OnInterstitialAdStartLoadstring adUnitId每次调用load方法时返回的回调
V7.9.0 新增回调
OnInterstitialBiddingStartstring tpAdInfoBidding开始加载。
OnInterstitialBiddingEndstring tpAdInfo,string errorMsgBidding加载完成。
V7.3.0新增回调参数 errorMsg
  • 下载监听(可选) 仅快手、穿山甲、广点通支持(Android V8.1.0.1)
方法参数说明
OnInterstitialDownloadStartstring tpAdInfo,
string networkinfo
开始下载回调。
TPAdInfo:广告的信息对象,具体请参考上文回调信息说明
开发者可通过解析 json“networkinfo”获得:
totalBytes:文件总大小(单位:字节)
currBytes:当前已下载的大小(单位:字节)
fileName:文件名
appName:文件对应的应用名称
OnInterstitialDownloadUpdatestring tpAdInfo,
string networkinfo
下载进度更新回调。
参数意义同上。
OnInterstitialDownloadPausestring tpAdInfo,
string networkinfo
暂停下载回调。
参数意义同上。
OnInterstitialDownloadFinishstring tpAdInfo,
string networkinfo
下载完成回调。
参数意义同上。
OnInterstitialDownloadFailstring tpAdInfo,
string networkinfo
下载失败回调。
参数意义同上。
OnInterstitialInstalledstring tpAdInfo,
string networkinfo
Apk安装完成回调。
参数意义同上。

三.示例代码#

// 1、初始化广告位,广告位ID在TradPlus后台创建
TradPlus.LoadInterstitialPluginsForAdUnits("AdUnitId");
// 2、加载广告
TradPlus.RequestInterstitialAd("AdUnitId");
// 3、判断是否有可用广告
if (TradPlus.IsInterstialReady("AdUnitId"))
{
// 4、展示
TradPlus.ShowInterstitialAd("AdUnitId");
}