中文
登录
后可查看全部文档
开发测试/Android集成文档/模板渲染Draw广告
模板渲染Draw广告
最近更新 2023-11-01 17:43:23

简介

开发者不用自行对广告样式进行编辑和渲染,可直接调用相关接口获取广告view进行展示

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

创建广告对象及请求参数

  • 创建TTAdNative对象
复制
  • 创建广告请求AdSlot
复制
  • 参数说明

参数

说明

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之前 否则会影响展示、点击的数据上报

复制
  • NativeExpressAdListener 说明

回调

说明

onError()

广告请求失败回调 返回的错误码(code)表示广告请求失败的原因,详情请见链接

onNativeExpressAdLoad()

广告请求成功的回调,客户端可在该回调中调用render()进行广告渲染

广告点击事件监听器

复制
  • ExpressAdInteractionListener说明

回调

说明

onAdClicked()

广告点击的回调,点击后的动作由sdk控制 点击量 可在穿山甲提供的方法里进行埋点统计

onAdShow()

广告展示回调,展示量 可在穿山甲提供的方法里进行埋点统计

onRenderFail()

个性化模板渲染失败

onRenderSuccess()

个性化模板渲染成功,客户端可在该回调中把广告的view直接add要显示的控件

注意: 加载到广告后,调用TTNativeExpressAd.render()方法渲染广告,在onRenderSuccess(View view, float width, float height)回调中,处理添加广告view的逻辑,width&height即为广告的宽高。

视频状态监听

复制
  • ExpressVideoAdListener说明

方法

说明

onVideoLoad()

视频广告加载成功回调

onVideoError()

视频广告加载失败回调

onVideoAdStartPlay()

视频广告播放回调

onVideoAdPaused()

视频广告暂停回调

onVideoAdContinuePlay()

视频广告续播回调

onProgressUpdate()

视频广告播放进度回调

onVideoAdComplete()

视频广告播放完成回调

onClickRetry()

视频广告点击重播回调

销毁广告对象

复制

接入须知

①个性化模板Draw广告不支持dislike逻辑。

②模板尺寸的参数设置中,个性化模板Draw视频广告高度不能设置为0

资源

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



本篇目录
联系我们