插屏广告
一.集成建议
主要介绍在项目中如何集成 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 adUnitId | TradPlus后台创建。应用管理——添加应用——添加广告位。注意广告类型创建错误会导致广告展示失败，例如用标准原生的广告位去请求激励视频广告。 |
| 广告场景ID sceneId | TradPlus后台创建。应用管理—— 广告场景。具体如何使用，请看广告场景的调用时机和用途说明。 |
2.监听回调API
- 监听回调中的参数说明
| 参数 | 说明 |
|---|---|
| TPAdInfo | 广告位ID、三方广告平台、ecpm等信息，具体请参考回调信息说明。 |
| errorMsg | 广告请求失败、广告展示失败的错误信息，具体请参考错误码、错误信息说明。 |
- 广告位维度回调监听 V6.4.5新增API
- 开发者可通过TradPlusManager调用
| 方法 | 参数 | 说明 |
|---|---|---|
| OnInterstitialAdLoaded | string tpAdInfo | 广告加载成功。 |
| OnInterstitialAdFailed | string adUnitId ，string errorMsg | 广告加载失败。 |
| OnInterstitialAdImpression | string tpAdInfo | 广告展示。老版本API为TradPlusManager.OnInterstitialShownEvent |
| OnInterstitialAdClicked | string tpAdInfo | 广告被点击。老版本API为TradPlusManager.OnInterstitialClickedEvent |
| OnInterstitialAdClosed | string tpAdInfo | 广告被关闭。老版本API为TradPlusManager.OnInterstitialDismissedEvent |
| OnInterstitialAdVideoError | string tpAdInfo，string errorMsg | 广告播放失败。 V7.3.0新增回调参数 errorMsg。 |
| OnInterstitialVideoPlayStart | string tpAdInfo | 视频播放开始。部分广告平台支持。 Android V8.1.0.1新增 iOS V7.8.10新增 |
| OnInterstitialVideoPlayEnd | string tpAdInfo | 视频播放结束。部分广告平台支持。 Android V8.1.0.1新增 iOS V7.8.10新增 |
- 广告源维度回调监听 (可选) V6.4.5新增API
| 方法 | 参数 | 说明 |
|---|---|---|
| OnInterstitialAdAllLoaded | bool isSuccess，string adUnitId | 广告位的状态。 请求广告后，一次load()操作完毕后才会回調一次，可以用于判断是否有可用广告； true表明有可用广告，false表明没有可用广告。老版本API为 TradPlusManager.OnInterstitialAllLoadedEvent |
| OneInterstitialLayerLoadFailed | string tpAdInfo | 配置多个广告源，每个广告源加载失败后会都会回调一次。。老版本API为TradPlusManager.OnInterstitialFailedEvent |
| OneInterstitialLayerLoaded | string tpAdInfo | 配置多个广告源，每个广告源加载成功后会都会回调一次。。老版本API为TradPlusManager.OnInterstitialLoadedEvent |
| string tpAdInfo | 请求广告后，广告开始加载。 V7.9.0 废弃。 | |
| OneInterstitialLayerStartLoad | string tpAdInfo | 每层waterfall 向三方广告源发起请求前，触发的回调。 V7.9.0 新增回调。 |
| OnInterstitialAdStartLoad | string adUnitId | 每次调用load方法时返回的回调 V7.9.0 新增回调。 |
| OnInterstitialBiddingStart | string tpAdInfo | Bidding开始加载。 |
| OnInterstitialBiddingEnd | string tpAdInfo，string errorMsg | Bidding加载完成。 V7.3.0新增回调参数 errorMsg。 |
- 下载监听(可选) 仅快手、穿山甲、广点通支持（Android V8.1.0.1）
| 方法 | 参数 | 说明 |
|---|---|---|
| OnInterstitialDownloadStart | string tpAdInfo, string networkinfo | 开始下载回调。 TPAdInfo：广告的信息对象，具体请参考上文回调信息说明 开发者可通过解析 json“networkinfo”获得： totalBytes：文件总大小（单位：字节） currBytes：当前已下载的大小（单位：字节） fileName：文件名 appName：文件对应的应用名称 |
| OnInterstitialDownloadUpdate | string tpAdInfo, string networkinfo | 下载进度更新回调。 参数意义同上。 |
| OnInterstitialDownloadPause | string tpAdInfo, string networkinfo | 暂停下载回调。 参数意义同上。 |
| OnInterstitialDownloadFinish | string tpAdInfo, string networkinfo | 下载完成回调。 参数意义同上。 |
| OnInterstitialDownloadFail | string tpAdInfo, string networkinfo | 下载失败回调。 参数意义同上。 |
| OnInterstitialInstalled | string tpAdInfo, string networkinfo | Apk安装完成回调。 参数意义同上。 |
三.示例代码
// 1、初始化广告位，广告位ID在TradPlus后台创建
TradPlus.LoadInterstitialPluginsForAdUnits("AdUnitId");
// 2、加载广告
TradPlus.RequestInterstitialAd("AdUnitId");
// 3、判断是否有可用广告
if (TradPlus.IsInterstialReady("AdUnitId"))
{
// 4、展示
TradPlus.ShowInterstitialAd("AdUnitId");
}