中文
登录
后可查看全部文档
开发测试/Android集成文档/自渲染贴片广告
自渲染贴片广告
最近更新 2022-01-30 11:17:43

简介

贴片广告: 贴片广告是一种视频广告形式,开发者可以将广告位设置在其APP内的视频播放前/播放中/播放结束后。贴片广告的时长可以设置成固定时长,如5s/15s等;也可以不限制固定时长,在5-60s范围内由系统返回收益最高的广告,帮助开发者实现收益最大化。贴片广告目前仅支持自渲染,可以使用穿山甲默认播放器,也可以申请使用开发者自己的播放器。


权限

自渲染贴片广告:默认需要申请权限SDK版本要求: 3400及以上


自渲染贴片请求方法

创建TTAdNative对象

创建广告请求类型参数AdSlot

参数说明

参数

说明

setCodeId

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

setAdCount

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

setImageAcceptedSize

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

请求广告

调用 mTTAdNative.loadStream(adSlot, new TTAdNative.FeedAdListener)方法异步加载贴片广告

FeedAdListener说明

回调

说明

onError()

请求失败回调

onFeedAdLoad()

请求成功回调

TTFeedAd 接口说明

贴片广告行为监听

重要!!! AdInteractionListener涉及到广告计费,必须正确调用 convertView必须使用ViewGroup

在加载到贴片广告后,接入方需要注册在贴片广告中可以点击的View,即TTFeedAd.registerViewForInteraction()方法,以实现广告的功能交互及计。包含图文点击区域的注册和附加创意按钮点击区域的注册。对于落地页广告,用户点击图文广告区域会跳转到相应的落地页,点击附加创意区域会进行电话拨打、应用下载等操作。

注意: 如果需要点击图文区域也能进行下载或者拨打电话动作,请将图文区域的view传入creativeViewList,详细代码如下

注册点击View示例的示例代码如下,该示例片段在Demo的BaseAdapter getView()方法中调用

AdInteractionListener说明

回调

说明

onAdClicked()

点击普通区域回调

onAdCreativeClick()

点击创意区域回调

onAdShow()

广告展示回调

App下载状态控制器

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

广告下载事件监听

TTAppDownloadListener说明

回调

说明

onIdle()

绑定下载监听回调

onDownloadActive()

下载中回调

onDownloadPaused()

下载暂停回调

onDownloadFailed()

下载失败回调

onDownloadFinished()

下载完成回调

onInstalled()

安装完成回调

贴片广告使用自定义播放器

如果App有自己实现的播放器,可以替代sdk中默认的播放器来播放广告,但是需要额外处理好生命周期和事件回调。

创建广告对象封装

使用自定义播放器

视频预加载时机

生命周期控制

CustomizeVideo

方法

说明

getVideoUrl()

获取视频url

reportVideoStart()

上报播放开始

reportVideoPause()

上报播放暂停

reportVideoContinue()

上报播放继续

reportVideoFinish()

上报播放结束

reportVideoBreak()

上报播放中止

reportVideoAutoStart()

上报自动播放

reportVideoStartError()

上报起播错误

reportVideoError()

上报播放中错误

参考Demo

自渲染渲染贴片请参考Demo中StreamActivity使用自定义播放器可参看Demo中StreamCustomPlayerActivity

自渲染贴片注意点:

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


本篇目录
联系我们