一、简介

draw视频广告的展示场景一般在应用的视频流中进行展示，广告内容与应用其他内容区分开，防止意外点击。不支持开发者对广告样式进行编辑和渲染，可直接调用相关接口获取广告view进行展示

支持的广告尺寸：竖版视频(宽高比9:16)。注意：不支持开发者在view添加按钮及对广告拦截处理。

注意事项：

请求模板广告时需开发者设置setExpressViewAcceptedSize参数，单位dp。高度不能设置为0。
个性化模板Draw广告不支持dislike逻辑。

二、构建请求参数

1. 使用示例

创建TTAdNative对象

复制

创建广告请求AdSlot

复制

2. 接口说明

方法	说明
setCodeId	平台创建的代码位ID 9开头9位数字
setAdCount	请求数量1-3条。建议设置为1
setExpressViewAcceptedSize	设置请求模板广告素材的尺寸单位：dp
setAdLoadType()	用于标注此次的广告请求用途为预加载（当做缓存）还是实时加载，方便后续为开发者优化相关策略，传入参数值： UNKNOWN：未知，默认值，开发者未传入，或当此次加载的广告用途未知时使用 PRELOAD：预加载，当此次加载的广告用途为预加载（当作缓存）时使用 LOAD：实时加载，当此次加载的广告用途为实时播放时使用

三、请求和展示广告

接入方可调用loadExpressDrawFeedAd(AdSlot adSlot, @NonNull NativeExpressAdListener listener)异步加载广告，并在onNativeExpressAdLoad()方法中调用TTNativeExpressAd.render()进行广告渲染，在onRenderSuccess(View view, float width, float height)回调中将广告view添加到容器。

注意：点击事件注册时机在广告render之前否则会影响展示、点击的数据上报

1. 使用示例

复制

2. 接口说明

NativeExpressAdListener 说明

回调	说明
onError()	广告请求失败回调返回的错误码(code)说明详情请见链接
onNativeExpressAdLoad()	广告请求成功的回调，客户端可在该回调中调用render()进行广告渲染
setExpressInteractionListener(ExpressAdInteractionListener var1);	广告状态监听，如曝光，点击等行为
setVideoAdListener(ExpressVideoAdListener var1);	视频播放状态监听

四、监听广告行为

1. 使用示例

复制

2. 接口说明

ExpressAdInteractionListener

回调	说明
onAdClicked()	广告点击的回调，点击后的动作由sdk控制点击量可在穿山甲提供的方法里进行埋点统计
onAdShow()	广告展示回调，展示量可在穿山甲提供的方法里进行埋点统计
onRenderFail()	个性化模板渲染失败
onRenderSuccess()	个性化模板渲染成功，客户端可在该回调中把广告的view直接add要显示的控件，当前不建议直接使用该接口返回的float width, float height

五、监听视频状态

1. 使用示例

复制

2. 接口说明

ExpressVideoAdListener

方法	说明
onVideoLoad()	视频广告加载成功回调
onVideoError()	视频广告加载失败回调
onVideoAdStartPlay()	视频广告播放回调
onVideoAdPaused()	视频广告暂停回调
onVideoAdContinuePlay()	视频广告续播回调
onProgressUpdate()	视频广告播放进度回调
onVideoAdComplete()	视频广告播放完成回调
onClickRetry()	视频广告点击重播回调

3. 销毁广告对象

复制

六、资源

模板Draw广告请参考Demo中的DrawNativeExpressVideoActivity示例

本篇目录