中文
登录
后可查看全部文档
开发测试/Android集成文档/模板渲染信息流广告
模板渲染信息流广告
最近更新 2023-05-23 11:47:02

简介

模板渲染信息流广告: 支持图文和视频样式,开发者不用自行对广告样式进行编辑和渲染,可直接调用相关接口获取广告view去进行展示,开发者可以随时对穿山甲平台上勾选的模板进行样式上的调整。降低了接入成本的前提下,不会影响cpm的水平,仍然可以保持高的竞争力。

支持的广告尺寸:开发者在穿山甲平台上可以进行多模板、多尺寸的勾选。模板渲染信息流广告支持开发者调整、编辑。注意:不允许开发者在view添加按钮及对广告拦截处理。

权限

模板信息流广告: 默认提供

创建广告对象及请求对象

模板广告请求方法需要开发者设置setExpressViewAcceptedSize参数,单位dp。高度设置0,返回的view则会根据平台上勾选的不同模板做高度自适应。

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

参数

说明

setCodeId

平台创建的代码位ID 以9开头9位数字

setAdCount

请求数量1-3条。建议设置为1

setExpressViewAcceptedSize

设置请求模板广告素材的尺寸 单位:dp

setAdLoadType()

用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值:

UNKNOWN//未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用

PRELOAD//预加载,当此次加载的广告用途为预加载(当作缓存)时使用

LOAD//实时加载,当此次加载的广告用途为实时播放时使用

请求广告

调用loadNativeExpressAd(AdSlot adSlot, @NonNull NativeExpressAdListener listener)异步加载广告

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

复制
  • NativeExpressAdListener说明

回调

说明

onError()

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

onNativeExpressAdLoad()

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

广告点击事件监听器

复制
  • ExpressAdInteractionListener说明

回调

说明

onAdClicked()

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

onAdShow()

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

onRenderFail()

个性化模板渲染失败

onRenderSuccess()

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

Dislike监听

dislike逻辑有助于我们提升广告体验和匹配度,请按照接入说明设置。

复制
  • DislikeInteractionCallback说明

回调

说明

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方法标记废弃

复制

销毁广告对象

强烈建议:已经展示过且不再使用的广告需要在合适的时机调用destroy方法及时对广告进行销毁,避免内存异常场景。

复制

接入须知

①模板尺寸setExpressViewAcceptedSize的参数设置中,如果高度设置为0,则高度会自适应

②模板信息流关闭弹窗不支持去掉,dislike逻辑有助于提升广告体验和匹配度

③广告的点击事件注册时机需要在广告render之前,否则会影响展示、点击的数据上报。

资源

个性化模板信息流详细代码请参考Demo中的NativeExpressActivity,如果在信息流场景使用参考NativeExpressListActivity




本篇目录
联系我们