SDK接入

SDK版本	更新时间	更新内容
v.1.0.1	2024.3.19	修复网络请求失败 bug 优化日志
v1.0.2	2024.3.29	增加网关请求参数 修复日志打印开关 更新 TradPlus Adapter v1.0.1
v1.0.3	2024.4.8	广告 API 完成 增加 Admob Adapter v1.0.1 增加 Applovin Adapter v1.0.1 增加 Topon Adapter v1.0.1 更新 TradPlus Adapter v1.0.2
v1.0.4	2024.4.10	初始化 API 增加 App Id 参数 Banner 广告 API 增加尺寸大小参数
v1.0.5	2024.4.15	修复网关请求问题
v1.0.6	2024.4.18	修复混淆引起的 bug 更新 Admob Adapter v1.0.2 更新 Applovin Adapter v1.0.2 更新 Topon Adapter v1.0.2 更新 TradPlus Adapter v1.0.3
v1.1.0	2024.5.8	优化广告竞价逻辑 Native 广告 BeesNativeAdListener 监听器增加 onAdLoaded(@NonNull BeesNativeAd nativeAd) 回调 更新 Admob Adapter v1.0.3 更新 Applovin Adapter v1.0.4 更新 Topon Adapter v1.0.3 新增插播模块支持 v1.0.0 新增隐私合规 API
v1.1.1	2024.5.28	修复隐私合规问题 更新 Admob Adapter v1.0.4 更新 Applovin Adapter v1.0.4 更新 Topon Adapter v1.0.4 更新插播模块 v1.0.1
v1.1.2	2024.06.25	优化已知问题 更新 Admob Adapter v1.0.5 更新 Applovin Adapter v1.0.5 更新 Topon Adapter v1.0.5 更新插播模块 v1.0.2
v1.1.3	2024.06.28	插播功能新增友好控件注册和移除 API ，BeesMediaVideo 新增 registerFriendlyObstruction 和 unregisterAllFriendlyObstructions 方法 插播功能新增 AD 标签控制 API，BeesMediaVideo.Builder 新增 setShowAdLabelUI 方法 更新插播模块 v1.0.2
v2.0.0	2024.11.18	更新广告 API 修复已知 BUG 更新插播模块 v1.1.0 更新 Admob Adapter v1.1.0 更新 Applovin Adapter v1.1.0 更新 Topon Adapter v1.1.0
v2.0.1	2024.11.22	优化广告请求 更新 Topon 聚合适配器 v1.1.1
v2.0.2	2024.11.27	优化横幅广告回调 更新 Topon 聚合适配器 v1.1.2 更新 Applovin 聚合适配器 v1.1.1 更新 Admob 聚合适配器 v1.1.1
v2.0.3	2024.12.02	优化广告加载逻辑 修复已知问题
v2.0.4	2024.12.16	优化代码 修复已知问题 更新插播模块 v1.1.1 更新 Topon 聚合适配器 v1.1.3 更新 Applovin 聚合适配器 v1.1.2 更新 Admob 聚合适配器 v1.1.2
v2.0.5	2025.01.02	优化 WebView 性能 修复已知问题

功能描述

Bees Ads SDK 开发包（简称：SDK）主要⽤来向第三⽅应⽤程序提供广告竞价服务。本⽂主要描述 SDK 集成至聚合平台的⽅法，供合作伙伴的开发者接⼊使⽤。

接入前准备

接⼊前期准备⼯作包括在Bees 后台创建应用和聚合平台创建我方媒体中介，已完成商户可略过。 需要获取的参数包括：

参数名称	参数说明
app_id	Bees 后台创建的应用 id
application_id	Google Admob 或 Google Ad Manager 后台的应用 id

这些参数请通过不同平台获取

• app_id 通过 Bees Ads 后台获取
• application_id 通过 Google 后台获取，具体方式详见：文档地址

基础环境

本教程适⽤于AndroidStudio 开发⼯具，如果您没有以上开发⼯具，可以到官⽹下载

SDK 导入

重要提示：务必修改targetSdkVersion≥33; minSdkVersion≥21;

1. 在项目级 build.gradle 文件下配置仓库地址项目

buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

1. 在应用级 build.gradle 文件（通常是 app/build.gradle）中，完成 SDK 接入

dependencies {
    // bees sdk
    implementation 'io.github.beesads:sdk:2.0.5'
    // google ads 
    implementation 'com.google.android.gms:play-services-ads:23.5.0'
}

1. Google Ads 参数配置

<manifest>
  <application>
    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

接入流程 FAQ

若在使用 SDK 过程中遇到问题，可参考以下内容尝试解决。

1. 如何申请 app Id 等平台参数

在我方平台创建应用成功后即可获取

1. 进⾏打包时 targetSDKVersion 应该为多少？

建议使用 33 及以上

1. SDK 混淆规则该怎么处理

我方已处理 SDK 相关混淆，不需要在项目中额外配置我方 SDK 混淆规则

1. SDK 该如何初始化

只需完成聚合平台 SDK 接入，并配置我方媒体中介，Bees SDK 会通过聚合平台 SDK 完成初始化过程

1. 如何判断 Bees SDK 初始化状态？

当使用广告请求时，根据 tag: bees-sdk 查看初始化相关日志

• 当初始化成功时，会出现下图所示日志：

• 当初始化失败时，会出现下图所示日志：

技术问题反馈

若本接⼊⽂档不能解决您的疑惑，或有其他技术问题咨询

请发送邮件⾄：[e-mail]