中文
登录
后可查看全部文档
开发测试/iOS集成文档/模版渲染新插屏广告
模版渲染新插屏广告
最近更新 2026-03-18 17:37:28

一、简介

插屏广告场景一般为应用功能自然体验中断时,例如,暂停视频播放,游戏关卡之间。插屏广告不应突然出现,不应干扰用户使用应用的正常流程,例如应用加载,退出应用或者游戏过程中。

新插屏广告分为全屏、半屏、优选(全屏+半屏),不同场景下开发者都可以选择投放的广告类型,分别为图片+视频、仅视频、仅图片。

注意事项:

  • 广告监听:nativeExpressFullscreenVideoAdViewRenderSuccess渲染成功回调在广告展示后为保证播放流畅和展示流畅,在收到nativeExpressFullscreenVideoAdDidDownLoadVideo回调后进行广告的展示
  • 其他配置:必须要设置rootViewController用来处理广告跳转。SDK里所有的跳转均采用present的方式,请确保传入的rootViewController不能为空且没有present其他的控制器,否则会出现presentedViewController已经存在而导致present失败。每次请求数据时,都需要重新初始化一个新的BUNativeExpressFullscreenVideoAd对象。请勿重复使用本地缓存的全屏视频对象多次展示判断广告是否有效直接使用self.fullscreenAd判断即可

二、创建广告对象

1. 使用示例

使用BUNativeExpressFullscreenVideoAd创建广告请求对象

复制

2. 接口说明

方法

说明

- (instancetype)initWithSlotID:(NSString *)slotID;

构建请求参数:
soltID:代码位ID ,必传

三、请求及展示广告

新插屏使用BUNativeExpressFullscreenVideoAd对象调用loadAdData请求广告,并在收到nativeExpressFullscreenVideoAdDidDownLoadVideo回调后再调用showAdFromRootViewController展示广告,通过设置BUNativeExpressFullscreenVideoAdDelegate代理,监听广告、展示、点击、关闭等状态。

注意事项:

  1. 调用showAdFromRootViewController方法展示新插屏广告,需要传入当前展示的页面。一定要设置rootViewController,即展示广告和跳转落地页需要的viewController。
  2. 同一次请求的广告最多只能计一次有效展示,重复的展示会被系统过滤。因此建议开发者在用户观看完广告后在nativeExpressFullscreenVideoAdDidClose回调里将原来的广告对象置为nil 保证广告对象为新的请求对象

1. 使用示例

复制

2. 接口说明

  • BUNativeExpressFullscreenVideoAd

方法

说明

- (void)loadAdData;

加载广告

- (BOOL)showAdFromRootViewController:(UIViewController *)rootViewController;

建议在收到nativeExpressFullscreenVideoAdDidClose回调后展示广告

  • BUNativeExpressFullscreenVideoAdDelegate

分类

方法

说明

广告加载回调

nativeExpressFullscreenVideoAdDidLoad

广告物料加载成功

nativeExpressFullscreenVideoAdDidDownLoadVideo

视频/图片下载完成,建议开发者在此回调方法中进行广告的展示,可保证播放流畅和展示流畅,用户体验更好。

nativeExpressFullscreenVideoAd: didFailWithError

广告加载失败,此回调方法中可定位具体的失败原因对应的错误码,打印error即可。所有错误码详情请见链接。Link

广告渲染回调

nativeExpressFullscreenVideoAdViewRenderSuccess

渲染成功回调方法

nativeExpressFullscreenVideoAdViewRenderFail:error

渲染失败,网络原因或者硬件原因导致渲染失败,可更换手机或者网络环境测试。建议直接升级到穿山甲平台最新版本

广告交互回调

nativeExpressFullscreenVideoAdWillVisible

新模版插屏广告即将展示回调

nativeExpressFullscreenVideoAdDidVisible

新模版插屏广告已经展示回调

nativeExpressFullscreenVideoAdDidClick

点击回调

nativeExpressFullscreenVideoAdDidClickSkip

点击跳过会触发此回调,如果需要在用户点击跳过时做相关的逻辑处理,可在此回调中进行处理

nativeExpressFullscreenVideoAdWillClose

此回调方法可知用户进行了广告关闭操作,可在此回调方法中进行用户关闭广告时的相应的逻辑处理

nativeExpressFullscreenVideoAdDidClose

点击关闭按钮会触发此回调

nativeExpressFullscreenVideoAdDidPlayFinish

广告播放完成会触发此回调

nativeExpressFullscreenVideoAdDidCloseOtherController: interactionType:

此回调在广告跳转到其他控制器时,该控制器被关闭时调用interactionType:此参数可区分是打开的appstore/网页/视频广告详情页面

四、资源

详细接入可参照Demo中的BUDExpressFullScreenVideoViewController类,广告加载请求部分可参照loadFullscreenVideoAdWithSlotID方法,广告展示部分可参照showFullscreenVideoAd方法简介,通过设置BUNativeExpressFullscreenVideoAdDelegate代理,获取广告、展示、点击、关闭等回调。其他代理方法可参见demo中BUDExpressFullScreenVideoViewController类#pragma mark - BUFullscreenVideoAdDelegate部分


本篇目录
联系我们