开发者不用自行对广告样式进行编辑和渲染,可直接调用相关接口获取广告view进行展示
支持的广告尺寸:竖版视频(宽高比9:16)。注意:不支持开发者在view添加按钮及对广告拦截处理。
参数 | 说明 |
setCodeId | 平台创建的代码位ID 以9开头9位数字 |
setAdCount | 请求数量1-3条。建议设置为1 |
setExpressViewAcceptedSize | 设置请求模板广告素材的尺寸 单位:dp |
setAdLoadType() | 用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值: UNKNOWN//未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用 PRELOAD//预加载,当此次加载的广告用途为预加载(当作缓存)时使用 LOAD//实时加载,当此次加载的广告用途为实时播放时使用 |
注意:
①模板广告请求方法需要开发者设置setExpressViewAcceptedSize参数,单位dp。
②期望个性化模板尺寸的参数设置中,个性化模板Draw视频广告高度不能设置为0。
接入方可调用loadExpressDrawFeedAd(AdSlot adSlot, @NonNull NativeExpressAdListener listener)
异步加载广告
注意:点击事件注册时机在广告render之前 否则会影响展示、点击的数据上报
回调 | 说明 |
onError() | 广告请求失败回调 返回的错误码(code)表示广告请求失败的原因,详情请见链接 |
onNativeExpressAdLoad() | 广告请求成功的回调,客户端可在该回调中调用 |
回调 | 说明 |
onAdClicked() | 广告点击的回调,点击后的动作由sdk控制 点击量 可在穿山甲提供的方法里进行埋点统计 |
onAdShow() | 广告展示回调,展示量 可在穿山甲提供的方法里进行埋点统计 |
onRenderFail() | 个性化模板渲染失败 |
onRenderSuccess() | 个性化模板渲染成功,客户端可在该回调中把广告的view直接add要显示的控件,当前不建议直接使用该接口返回的float width, float height |
注意: 加载到广告后,调用TTNativeExpressAd.render()
方法渲染广告,在onRenderSuccess(View view, float width, float height)
回调中,处理添加广告view的逻辑,width&height即为广告的宽高。
方法 | 说明 |
onVideoLoad() | 视频广告加载成功回调 |
onVideoError() | 视频广告加载失败回调 |
onVideoAdStartPlay() | 视频广告播放回调 |
onVideoAdPaused() | 视频广告暂停回调 |
onVideoAdContinuePlay() | 视频广告续播回调 |
onProgressUpdate() | 视频广告播放进度回调 |
onVideoAdComplete() | 视频广告播放完成回调 |
onClickRetry() | 视频广告点击重播回调 |
dislike逻辑有助于我们提升广告体验和匹配度,请按照接入说明设置。
回调 | 说明 |
onItemClick() | 自定义样式情况下用户点击filterWord回调 |
onClick() | 自定义样式情况下用户点击了”为什么看到此广告“ |
onSelected() | 默认dislike样式,点击filterWord回调。开发者可以在此回调中移除广告 |
onCancel() | 默认dislike样式,点击取消回调 |
onShow() | 默认dislike样式,dislike弹窗展示回调 |
onRefuse() | 默认dislike样式,用户重复点击dislike按钮回调。3600版本废除 |
5.1.0.0及以上版本,dislike功能下“为什么看到此广告”接口标记废弃
5.1.0.0及以上版本,NativeAdType的get和set方法标记废弃
①个性化模板Draw广告不支持dislike逻辑。
②模板尺寸的参数设置中,个性化模板Draw视频广告高度不能设置为0。
模板Draw广告请参考Demo中的DrawNativeExpressVideoActivity
示例
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点