中文
登录
后可查看全部文档
开发测试/Android集成文档/模板渲染信息流广告
模板渲染信息流广告
最近更新 2026-03-17 16:35:11

一、简介

模板信息流场景应在应用的内容流中与应用内容穿插展示,支持图文和视频样式,不支持开发者自行对广告样式进行渲染,可直接调用SDK相关接口获取广告view去展示。开发者在穿山甲平台进行多模板、多尺寸的勾选。信息流广告应与应用内容穿插展示并明显区分,防止意外点击。

注意事项:

  • 模板尺寸setExpressViewAcceptedSize高度需设置为0,则高度会自适应展示
  • 模板信息流关闭弹窗不支持去掉,dislike逻辑有助于提升广告体验和匹配度
  • 广告的展示/点击等监听需要在广告render之前,否则会影响展示、点击的数据上报。

二、构建请求参数

1. 使用示例

创建TTAdNative对象

复制

创建广告请求AdSlot

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

复制

2. 接口说明

方法

说明

setCodeId

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

setAdCount

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

setExpressViewAcceptedSize

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

setAdLoadType()

用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值:
UNKNOWN:未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用
PRELOAD:预加载,当此次加载的广告用途为预加载(当作缓存)时使用
LOAD:实时加载,当此次加载的广告用途为实时播放时使用

三、请求及展示广告

调用loadNativeExpressAd(AdSlot adSlot, @NonNull NativeExpressAdListener listener)加载广告,在广告 加载回调 onNativeExpressAdLoad 后 调用render()渲染

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

2. 使用示例

复制

2. 接口说明

回调

说明

onError()

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

onNativeExpressAdLoad()

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

四、监听广告行为

1. 使用示例

复制

2. 接口说明

回调

说明

onAdClicked()

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

onAdShow()

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

onRenderFail()

模板渲染失败

onRenderSuccess()

模板渲染成功,客户端可在该回调中把广告的view直接add要显示的控件,当前不建议直接使用该接口返回的 float width, float height。

五、销毁广告对象

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

复制

六、资源

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


本篇目录
联系我们