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

一、简介

banner广告是在内容底部或顶部显示的小条形广告, 暂不支持在列表中使用。不支持开发者对广告样式进行编辑和渲染,可直接调用相关接口进行广告展示。原生横幅广告内容与其他内容区分开,周围应留出空间防止意外点击,不应将横幅广告放置于文本、图片和应用的其他可点击部分,避免误点。

注意:不支持开发者在view添加按钮及对广告拦截处理。

注意事项:

  • 尺寸设置:请求时需开发者设置setExpressViewAcceptedSize参数(单位dp)高度不能设置为0台现支持8种尺寸,请求比例需与平台创建代码位ID时选择的尺寸一致,否则会出现展示异常。如平台勾选的尺寸是300*150,setExpressViewAcceptedSize(屏幕宽,屏幕宽/2)
  • 轮播功能:创建代码位时需要选择是否支持轮播,如果不设置则默认不开启轮播;轮播功能需在onNativeExpressAdLoad调用mTTAd.destroy()将旧广告对象销毁并设置轮播时间用mTTAd.setSlideIntervalTime(30 * 1000)(允许值在30 * 1000 ~ 120 *1000)
  • dislike弹窗:模板banner不支持去掉dislike,dislike逻辑有助于提升广告体验和匹配度。

二、创建广告对象及请求参数

1. 使用示例

创建TTAdNative对象

复制

创建广告请求AdSlot

复制

2. 接口说明

方法

说明

setCodeId(codeId)

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

setAdCount()

请求数量设置为1

setExpressViewAcceptedSize()

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

setAdLoadType()

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

三、请求及展示广告

接入方可调用loadBannerExpressAd(AdSlot adSlot, @NonNull NativeExpressAdListener listener)异步加载广告,并在onNativeExpressAdLoad()方法中调用render()进行广告渲染;

1. 使用示例

复制

2. 接口说明

  • NativeExpressAdListener

回调

说明

onError()

广告请求失败回调 返回的错误码(code)说明详情请见链接

onNativeExpressAdLoad()

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

  • TTNativeExpressAd

方法

说明

render()

广告渲染

destroy()

广告销毁

setSlideIntervalTime(int var1)

设置轮播时间,单位ms

setExpressInteractionListener(ExpressAdInteractionListener var1)

广告事件监听,如曝光,点击,关闭等行为

四、监听广告行为

1. 使用示例

复制

2. 接口说明

  • ExpressAdInteractionListener说明

方法

说明

onAdDismiss()

广告关闭回调

onAdClicked()

广告被点击回调

onAdShow()

广告展示回调

onRenderFail()

广告渲染失败回调

onRenderSuccess()

个性化模板渲染成功,客户端可在该回调中把广告直接addView到控件上,当前不建议直接使用该接口返回的float width, float height

五、销毁广告对象

复制

六、资源

模板渲染Banner广告请参考Demo中的BannerExpressActivity示例


本篇目录
联系我们