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

简介

自渲染Banner: :开发者可以拿到广告的物料信息进行拼接

支持的广告尺寸:

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

权限

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

创建广告对象及请求参数

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

方法

说明

setCodeId()

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

setImageAcceptedSize()

设置请求模板广告素材的尺寸 单位:px

setNativeAdType()

请求广告类型

setAdCount()

请求广告数量为1-3条

setAdLoadType()

用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值:UNKNOWN//未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用PRELOAD//预加载,当此次加载的广告用途为预加载(当作缓存)时使用LOAD//实时加载,当此次加载的广告用途为实时播放时使用

注意:

①setImageAcceptedSize 宽高比按照创建代码位ID时勾选的比例进行设置,单位px。

②setNativeAdType 请求原生广告时候,请务必调用该方法,设置参数为TYPE_BANNER。

4.9.0.0及以上版本下掉TTAdNative中的loadBannerAd和loadInteractionAd以及loadInteractionExpressAd接口。

请求广告

接入方可调用loadNativeAd(AdSlot adSlot, @NonNull NativeAdListener listener)异步加载广告。

复制
  • NativeAdListener

回调

说明

onError()

广告请求失败回调 返回的错误码(code)表示广告请求失败的原因,详情请见链接

onNativeAdLoad()

广告请求成功的回调

注意:

①addView前需要把控件上所有的view调用removeAllViews方法移除。

②setNativeAdType(AdSlot.TYPE_INTERACTION_AD)//请求原生广告时候,请务必调用该方法,设置参数为TYPE_BANNER。

③自渲染banner是在FrameLayout控件上创建一个view 把广告元素添加到view后 把view绑定到对应控件。

  • TTFeedAd 接口说明

通过getAdView()获取广告广告信息,比如title、buttonText等信息,自定义绘制整个广告区域,可以和自己的应用的样式风格尽可能的接近。

复制

广告行为监听

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

复制
  • AdInteractionListener

回调

说明

onAdClicked()

点击普通区域回调

onAdCreativeClick()

点击创意区域回调

onAdShow()

广告展示回调

TTAdDislike

SDK为接入方提供了信息流广告,当用户选择关闭广告时会有以弹窗形式询问用户,包含“不感兴趣”、“看过了”选项供用户选择。该反馈主要用于头条广告对用户端的广告策略,用来优化提升广告的点击率,提升广告效果及合作伙伴的收益。如果使用Dislike逻辑,初始化TTAdNative mTTAdNative =ttAdManager.createAdNative(activity)时,参数务必传入activity。

接入Dislike

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

复制

Dislike上报

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

关闭广告监听

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

复制

销毁广告对象

复制

接入须知

①setImageAcceptedSize 宽高比按照创建代码位ID时勾选的比例进行设置,单位px。

②setNativeAdType 请求原生广告时候,请务必调用该方法,设置参数为TYPE_BANNER。

③必须正确调用 convertView必须使用ViewGroup。

资源

自渲染Banner广告请参考Demo中的NativeBannerActivity示例。


本篇目录
联系我们