中文
登录
后可查看全部文档
开发测试/Android集成文档/自渲染贴片广告
自渲染贴片广告
最近更新 2024-04-24 15:58:31

简介

贴片广告是一种视频广告形式,开发者可以将广告位设置在其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()

上报播放中错误

接入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()接口上报。
复制

接入须知

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

资源

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


本篇目录
联系我们