贴片广告是一种视频广告形式,开发者可以将广告位设置在其APP内的视频播放前/播放中/播放结束后。贴片广告的时长可以设置成固定时长,如5s/15s等;也可以不限制固定时长,在5-60s范围内由系统返回收益最高的广告,帮助开发者实现收益最大化。贴片广告目前仅支持自渲染,可以使用穿山甲默认播放器,也可以申请使用开发者自己的播放器。
自渲染贴片广告:已回收,不再提供创建(仅支持历史创建代码位)。
SDK版本要求: 3400及以上。
参数 | 说明 |
setCodeId | 平台创建的代码位ID 以9开头9位数字 |
setAdCount | 请求数量1-3条,建议设置1 |
setImageAcceptedSize | 设置请求广告的尺寸 单位:px |
调用 mTTAdNative.loadStream(adSlot, new TTAdNative.FeedAdListener)
方法异步加载贴片广告。
回调 | 说明 |
onError() | 请求失败回调 |
onFeedAdLoad() | 请求成功回调 |
AdInteractionListener涉及到广告计费,必须正确调用 convertView必须使用ViewGroup。
在加载到贴片广告后,接入方需要注册在贴片广告中可以点击的View,即TTFeedAd.registerViewForInteraction()
方法,以实现广告的功能交互及计。包含图文点击区域的注册和附加创意按钮点击区域的注册。对于落地页广告,用户点击图文广告区域会跳转到相应的落地页,点击附加创意区域会进行电话拨打、应用下载等操作。
注意: 如果需要点击图文区域也能进行下载或者拨打电话动作,请将图文区域的view传入creativeViewList,详细代码如下。
注册点击View示例的示例代码如下,该示例片段在Demo的BaseAdapter getView()
方法中调用。
回调 | 说明 |
onAdClicked() | 点击普通区域回调 |
onAdCreativeClick() | 点击创意区域回调 |
onAdShow() | 广告展示回调 |
当返回的广告为应用下载类型,即ad.getInteractionType() == TTAdConstant.INTERACTION_TYPE_DOWNLOAD 时,接入方可调用如下示例代码接入 Feed 广告下载控制器:
回调 | 说明 |
onIdle() | 绑定下载监听回调 |
onDownloadActive() | 下载中回调 |
onDownloadPaused() | 下载暂停回调 |
onDownloadFailed() | 下载失败回调 |
onDownloadFinished() | 下载完成回调 |
onInstalled() | 安装完成回调 |
如果App有自己实现的播放器,可以替代SDK中默认的播放器来播放广告,但是需要额外处理好生命周期和事件回调。
方法 | 说明 |
getVideoUrl() | 获取视频url |
reportVideoStart() | 上报播放开始 |
reportVideoPause() | 上报播放暂停 |
reportVideoContinue() | 上报播放继续 |
reportVideoFinish() | 上报播放结束 |
reportVideoBreak() | 上报播放中止 |
reportVideoAutoStart() | 上报自动播放 |
reportVideoStartError() | 上报起播错误 |
reportVideoError() | 上报播放中错误 |
在获得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方法标记废弃
AdInteractionListener涉及到广告计费,必须正确调用 convertView
必须使用ViewGroup。
自渲染渲染贴片请参考Demo中StreamActivity
使用自定义播放器可参看Demo中StreamCustomPlayerActivity
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点