中文
登录
后可查看全部文档
开发测试/Android集成文档/模板渲染Banner广告
模板渲染Banner广告
最近更新 2022-01-30 11:18:47

简介

模版渲染Banner:开发者不用自行对广告样式进行编辑和渲染,可直接调用相关接口进行广告展示。

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


权限

模板渲染Banner广告: 默认提供


模板渲染Banner广告

创建TTAdNative对象

创建广告请求AdSlot

注意:

1.模板广告请求方法需要开发者设置setExpressViewAcceptedSize参数,单位dp。

2. 期望个性化模板尺寸的参数设置中,个性化模板Banner广告高度不能设置为0

3. setExpressViewAcceptedSize参数请按照平台勾选的比例去进行请求。平台现支持8种尺寸,请求比例与平台创建代码位ID时选择的尺寸不一致时,会出现展示效果的badcase。 因此请求比例应与平台勾选的保持一致

参数说明

参数

说明

setCodeId

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

setAdCount

请求数量设置为1

setExpressViewAcceptedSize

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

setAdLoadType()

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

请求广告

接入方可调用loadBannerExpressAd(AdSlot adSlot, @NonNull NativeExpressAdListener listener)异步加载广告

注意:

  • 代码位在创建的时候需要选择是否支持轮播
  • 若选择轮播则需要在onNativeExpressAdLoad回调里面调用TTNativeExpressAd.setSlideIntervalTime(30 * 1000);设置轮播时间设置Banner广告轮播的间隔时间,如果不设置则默认不开启轮播 Banner广告轮播的间隔时间,允许值在30 * 1000 ~ 120 *1000之间

NativeExpressAdListener 说明

回调

说明

onError()

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

onNativeExpressAdLoad()

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

广告点击事件监听器

ExpressAdInteractionListener说明

回调

说明

onAdDismiss()

广告关闭回调

onAdClicked()

广告被点击回调

onAdShow()

广告展示回调

onRenderFail()

广告渲染失败回调

onRenderSuccess()

个性化模板渲染成功,客户端可在该回调中把广告直接addView到控件上

注意: addView前需要把控件上所有的view调用removeAllViews方法移除

Dislike监听

dislike逻辑有助于我们提升广告体验和匹配度,请按照接入说明设置以下逻辑为穿山甲3500版本SDK中逻辑,3500以下版本SDK开发者可参考对应demo进行集成

DislikeInteractionCallback说明

回调

说明

onItemClick()

自定义样式情况下用户点击filterWord回调

onClick()

自定义样式情况下用户点击了”为什么看到此广告“

onSelected()

默认dislike样式,点击filterWord回调。开发者可以在此回调中移除广告

onCancel()

默认dislike样式,点击取消回调

onShow()

默认dislike样式,dislike弹窗展示回到

onRefuse()

默认dislike样式,用户重复点击dislike按钮回调。3600版本废除

销毁广告对象

参考Demo

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

模板渲染Banner注意点:

1.banner广告有其特有的使用场景 横幅广告是在内容底部或顶部显示的小条形广告 暂不支持在列表中使用2.平台上创建的例如:600*300比例的代码位代表标准模板的宽高比是2:1,开发者在请求广告设置尺寸的时候需要按照实际宽高去按照2:1的比例进行广告的请求。3.平台上已经创建好的代码位ID,不支持修改尺寸,因此要求开发者按照实际需求进行创建。4.模板banner不支持去掉dislike,dislike逻辑有助于提升广告体验和匹配度


本篇目录
联系我们