1

趣盟 Android SDK 接入文档

广告 SDK 说明:

 

一、导入SDK依赖

1.1 本地aar依赖

  1. 在 app 目录下新建 libs 文件夹

  2. 将压缩包中的 aar 文件放入 libs 文件夹

  3. 在 app/build.gradle 添加如下代码

1.2 AndroidManifest 配置

1.3 混淆配置

注意事项:

如果 tools.build:gradle 版本小于 4.1.0,请检查自定义混淆规则或 proguard-android-optimize,确认混淆规则中没有使用 -allowaccessmodification 属性

1.4 FileProvider 配置

 

二、配置相关

2.1 初始化SDK

AiClkAdManager为单例,会做一些初始化工作,需要传入一个Context对象,以及 VERSION_NAME.

 

2.2 隐私信息控制开关

示例:

2.3 个性化设置

3.455.10.420新增推荐广告开关

3.469.13.435新增摇一摇开关

示例:

 

三、信息流广告

3.1 请求广告

通过管理类构造请求对象-AdRequest

构造请求参数-AdRequestParam

 

请求广告

 

3.2 展示广告

3.2.1 自渲染示例

onADLoaded回调得到的对象IMultiAdObject。

注意

①如果有渲染合规前置,点击创意区域直接下载(无二次确认弹窗),请使用bindEvent(ViewGroup adContainer, List clickViews, List creativeViews, ADEventListener listener) 将创意区域的view传入。

 

代码示例:

3.2.2 模板渲染示例

onADLoaded回调得到的对象IMultiAdObject。

代码示例:

 

3.3 信息流广告下载监听

广告下载事件监听(3.456及以上版本支持)

 

 

3.4 接口说明

接口IMultiAdObject说明

常量名意义
MATERIAL_TYPE_SMALL_IMAGE1小图
MATERIAL_TYPE_BIG_IMAGE2大图
MATERIAL_TYPE_GROUP_IMAGE3组图
MATERIAL_TYPE_VIDEO_H4横版视频
MATERIAL_TYPE_SPLASH6竖图
MATERIAL_TYPE_VIDEO_V9竖版视频
方法名意义备注
getRequestId()广告唯一id3.464.15.430开始支持
getECPM()广告价格单位分
getTitle()广告标题 
getDesc()广告副标题 
getLandingPageUrl()落地页地址 
getInteractionType()广告交互类型INTERACTION_TYPE_LANDPAGE=1;
落地页类型
INTERACTION_TYPE_DOWNLOAD=2;
下载类型(包含拉新和拉活)
getQMLogo()趣盟logo图片链接 
getImageUrls()广告图片链接 
getAppLogoUrl()广告创意logo 
getAppName()广告创意应用名称 
getAppPackageName()广告创意包名 
getAppInformation()广告六要素信息一般用于下载合规外显,信息包括应用版本、开发者信息、隐私协议链接、应用权限链接、应用功能链接
getMediaSize()素材宽高图片或者视频的宽高。
first为宽,second为高
getMaterialType()广告物料的类型1:小图
2:大图
3:组图
4:横版视频
6:竖图
9:竖版视频
getExtraInfo()获取扩展信息返回值:Map<String, Object>
getVideoView(Context)获取播放器组件context传入view.getContext()
getTwistView(Context context)获取摇一摇组件context传入view.getContext()
bindEvent(ViewGroup,List, IMultiAdObject.ADEventListener)信息流绑定广告事件adContainer:广告容器
clickViews:可点击的View的列表
listener:广告事件回调
bindEvent(ViewGroup adContainer
, List clickViews
, List creativeViews
, ADEventListener listener)
信息流绑定广告事件adContainer:广告容器
clickViews:可点击的View的列表
creativeViews:用于下载的View
listener:广告事件回调
destroy()释放广告资源 
setOnMediaStateListener
(IMultiAdObject.MediaStateListener)
设置视频回调 
getVideoDuration()视频播放时长 
setDownloadListener()设置广告下载事件监听 
getDownloadAdController()获取下载控制器获取信息流下载类型广告下载控制器

 

视频状态监听 IMultiAdObject.MediaStateListener 接口说明:

方法名含义
onVideoReady()视频播放准备
onVideoStart()视频播放开始
onVideoPause()视频播放暂停
onVideoResume()视频播放继续
onVideoCompleted()视频播放完成
onVideoStop()视频播放停止

 

下载控制器 DownloadAdController 接口说明:

方法名含义
changeDownloadStatus()改变下载任务状态
(暂停正在下载的任务 或 暂停的任务恢复下载)
cancelDownload()取消下载任务

 

四、激励视频

4.1 广告请求加载

首先请求广告物料,请求方式和信息流基本一样。请注意,adType为ADTYPE_REWARD_VIDEO

onADLoaded回调得到的对象IMultiAdObject,启动激励视频界面

4.2 文案定制

根据业务特殊需求,可在请求时传入扩展字段extraBundle,比如:

文案参数解释

编号金币场景文案文案解释文案key
1可领金币倒计时上的奖励描述countdown_award_des
2任务提示关闭弹窗上的标题close_dialog_title
3观看完整广告可获得金币奖励关闭弹窗上的提示内容close_dialog_des
4放弃金币关闭弹窗上的退出按钮的描述close_dialog_exit_des
5继续观看关闭弹窗上的继续观看按钮描述close_dialog_continue_btn_des
6金币即将到账倒计时上的请求等待描述countdown_wait_des
7金币已到账倒计时上的请求成功描述countdown_success_des
8不能重复领金币倒计时上的请求重复描述countdown_repeat_des
9加金币失败倒计时上的请求失败描述countdown_fail_des
10金币亮色icon倒计时上的亮色图片countdown_icon_light_url
11金币灰色icon倒计时上的灰色图片countdown_icon_gray_url

1 2 3

4 5

4.3 其他定制

 

五、开屏广告

开屏类型请求时,adType传6

5.1 广告请求

5.2 开屏定制

开屏跳过按钮及合规点击区域默认由趣盟sdk渲染,可通过后台配置隐藏

5.3 接口说明

IMultiAdObject.SplashEventListener 接口说明

方法名返回类型含义
onObClicked() 开屏广告点击
onObShow() 开屏广告曝光
onObSkip() 开屏广告点击跳过
onObTimeOver() 开屏广告倒计时时间到

 

六、插屏广告

6.1 广告请求

插屏类型请求时,adType传2

6.2 接口说明

AdRequestParam.ADInteractionListener 接口说明

方法名返回类型含义
onAdClick() 点击回调
onADExposed() 曝光回调
onAdFailed(String s)失败原因渲染广告失败回调
onAdClose(Bundle bundle) 插屏广告关闭回调

 

6.3 关闭插屏广告

3.455.10.420 新增主动关闭插屏弹窗接口

示例:

 

 

七、竞胜竞败回传

3.445版本及以上开始支持回传

示例:

7.1 接口说明

IMultiAdObject 接口说明

方法名含义
winNotice(int auctionSecondPrice);竞价成功时上报接口
auctionSecondPrice 竞价第二名价格,单位是分 (接口调用时必填)
lossNotice(int auctionPrice, String lossReason, String winBidder);竞价失败时上报接口
auctionPrice 胜出者价格 单位分(非必填)
lossReason 竞价失败原因(非必填)
winBidder 胜出者 (非必填) 枚举值如下

ADEvent

 

 

八、TopOn聚合平台自定义广告接入文档

Topon自定义广告接入地址:https://docs.toponad.com/#/zh-cn/android/NetworkAccess/customnetwork/customnetwork

接入方式下载jar包集成

topOn单独版本:https://docs.qquanquan.com/android_sdk/topon/1.0.0/topon_qumeng_adapter.jar

自定义广告源adapter参数

广告类型广告类名称服务端配置参数
激励视频com.qumeng.advlib.topon.QMRewardVideoAdapter"slot_id" //广告栏位
插屏com.qumeng.advlib.topon.QMInteractionAdapter"slot_id" //广告栏位
横幅com.qumeng.advlib.topon.QMBannerAdapter"slot_id" //广告栏位
原生com.qumeng.advlib.topon.QMNativeAdapter"slot_id" //广告栏位
"draw_feed":"1"//渲染方式-模板渲染
"draw_feed":"0"//渲染方式-自渲染
开屏com.qumeng.advlib.topon.QMISplashAdapter"slot_id" //广告栏位

8.1 添加广告平台

1

8.2 创建广告源

参数填写:{"slot_id":"趣盟代码位ID"}

1

 

九、GroMore聚合平台自定义广告接入文档

接入方式下载jar包集成(根据穿山甲版本选择其一)

穿山甲单独gromore版本:https://docs.qquanquan.com/android_sdk/gromore/1.0.0/gromore_qumeng_adapter.jar

穿山甲融合gromore版本:https://docs.qquanquan.com/android_sdk/gromore/1.0.1/gromore_qumeng_ronghe_adapter.jar

注:聚合版本可通过gromore的接口设置合规参数(TTAdConfig->setMediationConfig->getLocalExtra)

 

自定义广告源adapter参数

广告类型广告类名称
初始化com.qumeng.advlib.gm.QMCustomerConfig
激励视频com.qumeng.advlib.gm.QMRewardVideoAdapter
插屏com.qumeng.advlib.gm.QMInterstitialAdapter
横幅com.qumeng.advlib.gm.QMBannerAdapter
原生com.qumeng.advlib.gm.QMNativeAdapter
开屏com.qumeng.advlib.gm.QMSplashAdapter

9.1 添加广告平台

 

 

请求返回错误码

3.445版本及以上详细错误码

错误码说明排查方向
100001无填充,没有合适广告返回导致的,偶现属于正常情况"reason":100 此次出价未过底价(固价未过栏位底价)
"reason":101 请求频率过高,建议:避免同一时间内高频拉取广告
"reason":102 没有合适广告返回,检查流量提高用户质量,注:在开发测试阶段,可以添加设备或更换设备解决,如果还未填充可以联系运营
“reason”:103 命中平台策略导致的无填充,如果开发测试阶段可以联系运营反馈
“reason”:104 命中检索204策略导致的无填充,如果开发测试阶段可以联系运营反馈
"reason":-1 其它异常
100002服务器错误"reason":201 检索服务器异常
100003请求失败"reason":301 请求体解析失败
100004代码位不合法"reason":401 检查代码位ID是否传入空字符串或特殊字符,注:新建的代码位需要10分钟左右的生效时间
100005请求包名与媒体包名不一致"reason":501 实际发起的包名和媒体的包名是否一致,注:如果媒体是通过趣盟运营创建的可以联系趣盟运营协同排查
100006广告请求代码位类型不匹配"reason":601 例如开屏代码位使用的的激励视频方法
200001代码位不能为空检查设置代码位ID是否为空
200002无填充命中平台策略导致的无填充,如果开发测试阶段可以联系运营反馈
200003网络错误网络链接异常

 

历史版本

版本号发布日期备注
3.469.11.4352024-02-17【优化】SDK广告链路
【优化】优化加密算法,提升SDK安全性
【修复】已知问题
3.468.13.4342024-11-29【优化】优化boot_id获取
【提升】SDK安全性能
【修复】已知问题
3.467.10.4332024-09-20【优化】广告链路,适配新预算
【修复】已知问题
3.466.15.4322024-08-12【优化】初始化耗时优化
【优化】安卓support&androidx合并通用包
【修复】已知问题
3.465.10.4312024-06-18【新增】通用包支持androidx和非androidx
【新增】接口增加链路请求唯一ID接口
【提升】广告链路优化,适配新预算
【修复】已知问题
【优化】SDK性能提升稳定性
3.464.10.4302024-06-03【优化】SDK稳定性提升
3.463.10.4292024-05-11【优化】SDK稳定性提升
3.462.15.4282024-04-30【合规】新增oaid获取开关
3.462.12.4282024-04-10【优化】SDK稳定性提升
【修复】已知问题
3.461.11.4272024-01-26【重要通知】topOn需要单独接入jar包
【新增】信息流视频支持TextureView
【优化】通知栏下载功能优化
【优化】SDK稳定性提升
3.460.10.4262023-12-12【优化】插屏场景合规优化
【优化】开屏渲染加载优化
【优化】SDK稳定性提升
3.459.11.4252023-11-08【新增】信息流左图右文自适应模板
【新增】通知栏下载进度条
【优化】合规方法调用相关优化
【优化】插屏场景优化
【优化】SDK稳定性提升
3.457.10.4222023-09-11【新增】新增信息流下载控制器
【新增】新增信息流组图自渲染类型
【优化】兼容android14版本
【优化】优化开屏广告加载速度
【优化】SDK稳定性提升
3.456.10.4212023-08-01【新增】新增下载合规六要素-产品功能介绍
【新增】激励视频支持自定义设置发放奖励时间
【新增】自渲染信息流支持传入创意点击区域
【优化】SDK稳定性优化
3.455.10.4202023-07-05【新增】支持横版开屏、激励视频、插屏广告场景
【新增】增加配置个性化广告开关
【新增】增加关闭插屏弹窗接口
【优化】SDK稳定性优化
3.452.10.4192023-05-09【优化】优化多种广告场景,支持618预算
【新增】支持传入lbs参数
【修复】SDK 稳定性优化
3.451.10.4182023-03-29【优化】优化应用市场直调预算
【新增】功能控制信息流不自动播放
【修复】SDK 稳定性优化
3.449.10.4172023-03-07【优化】隐私合规获取优化
【优化】增加下载类广告埋点
【修复】SDK 稳定性优化
3.448.10.4162023-02-13【新增】视频支持不自动播放功能
【优化】隐私合规获取优化
【修复】SDK 稳定性优化
3.447.10.4142023-01-04【优化】优化开屏广告展示效果
【优化】下载合规弹窗横屏展示效果
【修复】SDK 稳定性优化
3.446.10.4132022-11-29【优化】优化激励视频广告交互方式
【优化】SDK 稳定性优化
3.445.11.4122022-11-11【新增】广告请求无填充时错误码信息
【新增】竞价成功失败回传
【新增】信息流摇一摇功能
【优化】SDK 稳定性优化
3.441.10.4112022-10-18【新增】兼容topon接入
【优化】信息流、激励视频广告样式交互方式
【优化】SDK稳定性优化
3.440.10.4102022-09-29【新增】支持服务端bidding功能
【优化】广告样式交互方式
【优化】SDK 稳定性优化
3.439.10.4092022-09-06【新增】支持微信小程序类型广告
【优化】激励视频交互方式
【新增】隐私合规主动授权开关
【优化】SDK 稳定性优化
3.438.10.4082022-08-15【新增】支持合规信息传入
【新增】定制化任务场景
【优化】激励视频交互体验
【优化】SDK 性能优化
3.437.10.4072022-07-25【新增】激励视频样式
【优化】插屏交互方式
【优化】SDK 稳定性优化
3.436.10.4062022-07-11【新增】插屏交互方式
【新增】支持 topon 方式接入头部竞价
【优化】视频落地页交互体验
【优化】SDK 性能优化
3.435.10.4052022-06-27【新增】开屏热区新增合规弹窗
【新增】激励视频增加引导样式
【优化】信息流场景视频支持播放器回调
【新增】插屏支持n秒出跳过按钮
【修复】已知崩溃、内存溢出问题
【修复】激励视频静音失效
3.433.10.4042022-06-08提升SDK稳定性
广告请求优化
3.429.10.4042022-05-31应用列表上报修复
增加版本稳定性
兼容armeabi方式打包架构
3.428.10.4022022-05-17隐私合规信息加密
修复androidx版本模版渲染视频问题
新增banner轮播类型广告
新增互动类型广告
删除对relinker的依赖
删除媒体需要声明组件和混淆文件
替换趣盟包名
3.427.10.3922022-04-29支持TopOn自定义广告平台接入
新增插屏广告样式模板
新增角标广告样式模板
新增信息流模板渲染广告
优化sdk包体积
3.423.10.3892022-04-15优化开屏广告效果
默认设置广告合规下载弹窗
优化站内push弹窗广告
3.422.10.3882022-03-31增加趣盟logo回调方法
优化插屏广告效果
修复站内push弹窗广告渲染
3.421.10.3872022-03-18优化激励视频播放
优化拉新拉活广告投放
3.420.10.3862022-03-04修复跳转应用商城打开应用
imei加密传输
支持自渲染icon拉活场景
3.419.10.3852022-02-18增加开屏摇一摇功能
开屏支持自定义跳过按钮,合规点击区域
3.418.10.3842022-01-28修复oaid获取问题
兼容工信部sdk 1.0.13~1.1.0
3.418.10.3822022-01-14新增模板渲染icon拉活类型广告
新增站内push弹窗类型广告
新增获取广告应用信息接口需在bin dview前调用

 

常见问题 Q&A

Q1: 广告请求失败?

参考详细错误码。联系产品进行相关配置来提高填充率.

 

Q2: 广告栏位号如何申请?

广告栏位号要联系产品进行申请.

 

Q3: 初始化失败或构建请求为空?

1、检查混淆配置keep是否生效

2、检查androidx或非androidx版本集成是否有问题

 

Q4: 趣盟有demo工程吗?

demo下载地址:https://docs.jietuhb.com/android_sdk/OpenSDKDemo.zip

demo中的SDK版本不一定最新,请直接使用SDK下载地址链接中的版本