中文
登录
后可查看全部文档
开发测试/Android集成文档/自渲染信息流广告
自渲染信息流广告
最近更新 2024-04-10 21:03:48

简介

为可自定义布局的信息流广告,包含大图、小图、组图和视频四种基本样式类型,电话拨打、应用下载、跳转到落地页、跳转到浏览器四种交互类型。标题和描述长度为6-26个字符。

支持的广告尺寸:

  • 大图(宽高比:1.78的图片)
  • 视频(宽高比:1.78的视频)
  • 小图(宽高比:1.52的图片)
  • 组图(三张宽高比:1.52的图片)

权限

自渲染信息流广告: 已回收,不再提供创建(仅支持历史创建代码位)

创建广告对象及请求参数

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

参数

说明

setCodeId

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

setAdCount

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

setImageAcceptedSize

设置请求广告的尺寸 单位:px

setAdLoadType()

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

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

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

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

请求广告

调用 TTAdNative.loadFeedAd(AdSlot adSlot, FeedAdListener listener)方法异步加载信息流广告

复制
  • FeedAdListener说明

回调

说明

onError()

请求失败回调

onFeedAdLoad()

请求成功回调

  • TTFeedAd接口说明
复制

信息流广告行为监听

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不能为空,否则会存在线上崩溃异常场景。

复制
  • AdInteractionListener说明

回调

说明

onAdClicked()

点击普通区域回调

onAdCreativeClick()

点击创意区域回调

onAdShow()

广告展示回调

信息流视频回调接口

复制
  • VideoAdListener说明

回调

说明

onVideoLoad()

视频加载成功回调

onVideoError()

视频加载失败回调

onVideoAdStartPlay()

视频开始播放回调

onVideoAdPaused()

视频广告暂停回调

onVideoAdContinuePlay()

视频广告需播回调

onProgressUpdate()

视频播放进度回调

onVideoAdComplete()

视频播放完成回调

App下载状态控制器

当返回的广告为应用下载类型,即ad.getInteractionType() == TTAdConstant.INTERACTION_TYPE_DOWNLOAD 时,接入方可调用如下示例代码接入 Feed 广告下载控制器:

复制

广告下载事件监听

复制
  • TTAppDownloadListener说明

回调

说明

onIdle()

绑定下载监听回调

onDownloadActive()

下载中回调

onDownloadPaused()

下载暂停回调

onDownloadFailed()

下载失败回调

onDownloadFinished()

下载完成回调

onInstalled()

安装完成回调

获取应用下载六要素信息接口

穿山甲SDK在5403及以上版本针对自渲染信息流广告提供了获取应用的下载五项信息:应用名称、开发者公司名称、应用版本、隐私协议超链、权限列表超链 、产品功能的接口,详细说明见:自渲染获取应用下载五要素信息及注册直接下载区域说明

接口定义:

复制
复制

信息流广告接入Dislike

在获得TTFeedAd后,调用TTFeedAd.getDislikeDialog()获取TTAdDislike对象,然后为该对象设置用户选择结果回调。事例代码:

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

复制

信息流广告Dislike上报

  • 使用SDK内置dislike/自定义dislike方案时,由sdk自己处理上报,开发者无需关注。
  • 未使用SDK 内置dislike方案,而是自己实现时,在用户dislike行为时媒体主动通过ad.uploadDislikeEvent()接口上报。
复制

销毁广告对象

强烈建议:已经展示过且不再使用的广告需要在合适的时机调用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枚举值说明

复制


本篇目录
联系我们