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 增加尺寸大小参数

功能描述

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 后台获取，具体方式详见：文档地址

SDK 快速接入

基础环境

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

SDK 导入

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

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

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

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

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

dependencies {
    // bees sdk
    implementation 'io.github.beesads:sdk:1.0.4'
    // bees service
    implementation 'io.github.beesads:service:1.0.3'
    // google ads 
    implementation 'com.google.android.gms:play-services-ads:22.6.0'
}

3. 如果您的项目未使用 Java 8+，请在 build.gradle 中设置 Java 版本：

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
}

4. Bees SDK 参数配置

在 app/src/main.AndroidManifest.xml配置 BeesAds 平台的 App Id。

<manifest>
  <application>
    <meta-data
        android:name="com.bees.ads.sdk.APP_ID"
        android:value="应用 id" />
  </application>
</manifest>

5. 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 等平台参数

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

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

建议使用 33 及以上

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

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

4. SDK 该如何初始化

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

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

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

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

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

技术问题反馈

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

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