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

简介

自渲染信息流: 为可自定义布局的信息流广告,包含大图、小图、组图和视频四种基本样式类型,电话拨打、应用下载、跳转到落地页、跳转到浏览器四种交互类型。标题和描述长度为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()方法中调用

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在4002及以上版本针对自渲染信息流广告提供了获取应用的下载五项信息:应用名称、开发者公司名称、应用版本、隐私协议超链、权限列表超链 的接口,详细说明见:自渲染获取应用下载五要素信息及注册直接下载区域说明

接口定义:

信息流广告接入Dislike

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

以下逻辑为穿山甲3500版本SDK中逻辑,3500以下版本SDK开发者可参考对应demo进行集成

DislikeInteractionCallback

回调

说明

onItemClick()

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

onClick()

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

onSelected()

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

onCancel()

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

onShow()

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

onRefuse()

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

销毁广告对象

在Activity的onDestroy回调方法中销毁广告view

参考Demo

1、请参考穿山甲Demo以及/res/layout/下的 listitem_ad_pic.xml 文件。

2、自渲染信息流详细代码使用ListView请参考Demo中FeedListActivity

3、使用RecyclerView可参看Demo中FeedRecyclerActivity

4、3900以上版本自渲染信息流新增直播流样式,具体实例代码可以查看FeedListActivity中image_mode为166的样式实现。

自渲染信息流注意点:

1、AdInteractionListener涉及到广告计费,必须正确调用 convertView必须使用ViewGroup

2、TTAdDislike支持自渲染信息流广告、自渲染Banner广告


本篇目录
联系我们