中文
登录
后可查看全部文档
开发测试/iOS集成文档/自渲染全屏视频广告
自渲染全屏视频广告
最近更新 2023-02-16 14:43:53

简介

全屏视频是一种全屏播放的视频广告,用户可以进行5s跳过操作,且会显示结束endCard页面,视频播放完展示互动页面。全屏视频广告的展示场景为应用功能自然体验中断时,如游戏关卡之间。全屏视频广告不应突然出现,不应干扰用户使用应用的正常流程,例如应用加载,退出应用或者游戏过程中。

支持的广告尺寸: 全屏横屏(宽高比16:9)、全屏竖屏(宽高比9:16)

权限

自渲染全屏视频: 已回收,不再提供创建(该部分面向历史有历史使用该广告类型的开发者)

使用说明

SDK渲染全屏视频使用BUFullscreenVideoAd对象调用loadAdData请求广告,使用BUFullscreenVideoAd对象调用showAdFromRootViewController:展示广告,通过设置BUFullscreenVideoAdDelegate代理,获取广告、展示、点击、关闭等回调。

创建广告位对象、请求广告

每次需要生成新的BUFullscreenVideoAd对象调用loadAdData方法请求最新全屏视频,请勿重复使用本地缓存全屏视频多次展示.

BUFullscreenVideoAd

请求广告时需要传入广告位对象,广告位对象创建时必须传入广告位id必传参数:

字段定义

是否必传

字段名称

字段类型

备注

SlotID

广告位

NSString

代码位ID

使用BUFullscreenVideoAd创建对象,使用BUFullscreenVideoAd调用loadAdData请求广告

复制

展示广告

全屏视频广告不应有诸如“看视频给金币或奖励”之类的激励展示规则,并允许用户在5秒后跳过该广告。开发者不应对用户何时可以跳过广告的设置进行更改,或添加任何其他跳过功能。

调用showAdFromRootViewController:方法展示全屏视频广告,此处需要传入当前展示的页面。一定要设置rootViewController,即展示广告和跳转落地页需要的viewController,此处建议开发者在收到fullscreenVideoAdVideoDataDidLoad回调后再允许用户观看广告,可保证播放流畅和展示流畅,用户体验更好。

复制

展示时机

在收到fullscreenVideoAdVideoDataDidLoad回调后再允许用户观看广告,可保证播放流畅和展示流畅,用户体验更好。

复制

广告展示后重新加载广告

同一次请求的广告最多只能计一次展示,重复的展示会被系统过滤。因此建议开发者在用户观看完广告后在fullscreenVideoAdDidClose回调里将原来的广告对象置为nil 保证广告对象为新的请求对象

复制

接收广告加载结果

回调方法

注释

fullscreenVideoAd: didFailWithError:

返回的错误码(error)表示广告加载失败的原因,所有错误码详情请见链接。Link

fullscreenVideoMaterialMetaAdDidLoad:

广告素材物料加载成功

fullscreenVideoAdVideoDataDidLoad:

视频缓存成功

BUFullscreenVideoAdDelegate回调说明

回调方法

注释

fullscreenVideoMaterialMetaAdDidLoad:

广告素材物料加载成功

fullscreenVideoAd: didFailWithError:

返回的错误码(error)表示广告加载失败的原因,所有错误码详情请见链接。Link

fullscreenVideoAdVideoDataDidLoad:

视频缓存成功

fullscreenVideoAdWillVisible:

广告即将显示回调

fullscreenVideoAdDidVisible:

广告已经显示回调

fullscreenVideoAdDidClick:

点击回调

fullscreenVideoAdWillClose:

广告即将被关闭回调

fullscreenVideoAdDidClose:

广告被关闭回调

fullscreenVideoAdDidPlayFinish: didFailWithError:

当广告播放完成或者发生错误时会进入此回调,打印error即可。所有错误码详情请见链接。Link

fullscreenVideoAdDidClickSkip:

跳过按钮被点击时会触发此回调方法

fullscreenVideoAdCallback: withType:

此回调可知全屏视频的广告类型

通过设置BUFullscreenVideoAdDelegate代理,获取广告、展示、点击、关闭等回调。其他代理方法可参见DemoBUDFullscreenViewController类#pragma mark - BUFullscreenVideoAdDelegate部分

注意事项

①必须要设置rootViewController,用来处理广告跳转。SDK里所有的跳转均采用present的方式,请确保传入的rootViewController不能为空且没有present其他的控制器,否则会出现presentedViewController已经存在而导致present失败。

②为保证播放流畅和展示流畅,用户体验更好,在收到fullscreenVideoAdVideoDataDidLoad回调后进行广告的展示

③判断广告是否有效直接使用self.fullscreenAd判断即可

④每次请求数据时,都需要重新初始化一个新的BUFullscreenVideoAd对象。请勿重复使用本地缓存的全屏视频对象多次展示.

资源

详细接入可参照Demo中的BUDFullscreenViewController类,广告加载请求部分可参照loadFullscreenVideoAdWithSlotID方法,广告展示部分可参照showFullscreenVideoAd方法



本篇目录
联系我们