为可自定义布局的信息流广告,包含大图、小图、组图和视频四种基本样式类型,电话拨打、应用下载、跳转到落地页、跳转到浏览器四种交互类型。标题和描述长度为6-26个字符。
支持的广告尺寸:
- 大图(宽高比:1.78的图片)
- 视频(宽高比:1.78的视频)
- 小图(宽高比:1.52的图片)
- 组图(三张宽高比:1.52的图片)
自渲染信息流广告: 已回收,不再提供创建(仅支持历史创建代码位)
参数 | 说明 |
setCodeId | 平台创建的代码位ID 以9开头9位数字 |
setAdCount | 请求数量1-3条,建议设置1 |
setImageAcceptedSize | 设置请求广告的尺寸 单位:px |
setAdLoadType() | 用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值: UNKNOWN//未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用 PRELOAD//预加载,当此次加载的广告用途为预加载(当作缓存)时使用 LOAD//实时加载,当此次加载的广告用途为实时播放时使用 |
调用 TTAdNative.loadFeedAd(AdSlot adSlot, FeedAdListener listener)
方法异步加载信息流广告
回调 | 说明 |
onError() | 请求失败回调 |
onFeedAdLoad() | 请求成功回调 |
AdInteractionListener涉及到广告计费,必须正确调用,convertView必须使用ViewGroup。
在加载到信息流广告后,接入方需要注册在信息流广告中可以点击的View,即TTFeedAd.registerViewForInteraction()
方法,以实现广告的功能交互及计。包含图文点击区域的注册和附加创意按钮点击区域的注册。对于落地页广告,用户点击图文广告区域会跳转到相应的落地页,点击附加创意区域会进行电话拨打、应用下载等操作。
注意:
①如果需要点击图文区域也能进行下载或者拨打电话动作,请将图文区域的view传入creativeViewList,详细代码如下
②注册点击View示例的示例代码如下,该示例片段在Demo的BaseAdapter getView()
方法中调用。
③void registerViewForInteraction(ViewGroup var1, List<View> var2, List<View> var3, List<View> var4, View var5, TTNativeAd.AdInteractionListener var6); ViewGroup var1和List<View> var2不能为空,否则会存在线上崩溃异常场景。
回调 | 说明 |
onAdClicked() | 点击普通区域回调 |
onAdCreativeClick() | 点击创意区域回调 |
onAdShow() | 广告展示回调 |
回调 | 说明 |
onVideoLoad() | 视频加载成功回调 |
onVideoError() | 视频加载失败回调 |
onVideoAdStartPlay() | 视频开始播放回调 |
onVideoAdPaused() | 视频广告暂停回调 |
onVideoAdContinuePlay() | 视频广告需播回调 |
onProgressUpdate() | 视频播放进度回调 |
onVideoAdComplete() | 视频播放完成回调 |
当返回的广告为应用下载类型,即ad.getInteractionType() == TTAdConstant.INTERACTION_TYPE_DOWNLOAD 时,接入方可调用如下示例代码接入 Feed 广告下载控制器:
回调 | 说明 |
onIdle() | 绑定下载监听回调 |
onDownloadActive() | 下载中回调 |
onDownloadPaused() | 下载暂停回调 |
onDownloadFailed() | 下载失败回调 |
onDownloadFinished() | 下载完成回调 |
onInstalled() | 安装完成回调 |
穿山甲SDK在5403及以上版本针对自渲染信息流广告提供了获取应用的下载五项信息:应用名称、开发者公司名称、应用版本、隐私协议超链、权限列表超链 、产品功能的接口,详细说明见:自渲染获取应用下载五要素信息及注册直接下载区域说明
接口定义:
在获得TTFeedAd后,调用TTFeedAd.getDislikeDialog()获取TTAdDislike对象,然后为该对象设置用户选择结果回调。事例代码:
回调 | 说明 |
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方法标记废弃
强烈建议:已经展示过且不再使用的广告需要在合适的时机调用onDestroy方法及时对广告进行销毁,避免内存异常场景。
①AdInteractionListener涉及到广告计费,必须正确调用 convertView
必须使用ViewGroup
②TTAdDislike支持自渲染信息流广告、自渲染Banner广告
①请参考穿山甲Demo以及/res/layout/下的 listitem_ad_pic.xml 文件。
②自渲染信息流详细代码使用ListView
请参考Demo中FeedListActivity
。
③使用RecyclerView
可参看Demo中FeedRecyclerActivity
。
④3900以上版本自渲染信息流新增直播流样式,具体实例代码可以查看FeedListActivity中image_mode为166的样式实现。
⑤IMAGE_MODE枚举值说明
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点