跳到主要内容

Android

提示

XDSDK 广告包/分包功能对第三方平台广告埋点功能以及分包获取功能进行了封装，对于不同的渠道只能选择其中之一，游戏可根据自身需求选择需要集成的第三方平台渠道功能。 目前包含了今日头条（以下简称TT）、腾讯广点通（以下简称GDT）、快手（以下简称KS）。

SDK 集成​

提示

从新版（XDSDK 6.9.0）开始，XDSDK 的 XDADs_{version}.aar 包（4.x/5.x 版本为：XDAdAction.aar）中不再直接包含 TT SDK，在使用该功能时，如有旧版包，请移除历史版本 XDAdAction.aar 包。

XDSDK 分包/广告包功能集成​

将 XDADs_{version}.aar aar 包导入到 app module 级别的 libs 文件夹中， 并将相应的 aar 文件依赖添加到项目级别的 build.gradle 文件中：

implementation files('libs/XDADs_{version}.aar')

将 {version} 改为当前 分包/广告包 的具体版本号，详细版本参考更新日志。

如果游戏开启了混淆配置，需要在混淆配置文件中添加以下规则：

-keep class com.xd.ads.subpkg.** {*;}
-keep interface com.xd.ads.subpkg.** {*;}
-dontwarn com.qq.gdt.action.**
-keep class com.qq.gdt.action.** {*;}
-keep public class com.tencent.turingfd.sdk.**

-keepclasseswithmembers class * {
    native <methods>;
}

-keep class com.bytedance.ads.convert.broadcast.common.EncryptionTools {*;}

TT SDK 集成​

添加 TT 广告 SDK 依赖（当前使用版本：6.16.9）​

  1. 添加 TT 广告 SDK 的仓库地址

在根目录级别的 build.gradle 文件中添加 TT 广告 SDK 的仓库地址：

allprojects {
    repositories {
        maven {
            url 'https://artifact.bytedance.com/repository/Volcengine/'
        }
    }
}
  1. 添加 TT 广告 SDK 包依赖

在项目目录级别的 build.gradle 文件中添加 TT 广告 SDK 包的依赖：

// Applog 上报组件（必须）
implementation 'com.bytedance.applog:RangersAppLog-Lite-cn:6.16.9'
// 商业化组件（必须，头条广告埋点 SDK 从 6.15.4 版本开始已更改组件名称，如有旧版 SDK 依赖，可以删除依赖，并添加以下依赖
implementation 'com.bytedance.ads:AppConvert:1.3.1.9'
  1. 构建项目

附：今日头条广告 SDK 接入文档原文

添加 TT 分包 SDK 依赖（当前使用版本 1.0.0）（已过时，无需接入）​

提示

由于今日头条的相关规定，若游戏需要在今日头条进行广告投放，则需要「强制接入」今日头条分包 SDK。具体需求请与广告组联系。

从 XDADs 3.5.0 版本开始，头条广告 SDK 商业化组件中内置分包 SDK 内容，无需单独接入分包 SDK，如采用原生集成方式，请移除该 aar 库（humesdk-1.0.0.aar）的依赖

附：今日头条分包 SDK 接入文档原文

GDT SDK 集成​

添加 GDT 广告 SDK 依赖（当前使用版本 1.8.9）​

将 android附加/安卓渠道包工具/tencent 文件夹中的 aar 包导入到 app module 级别的 libs 文件夹中， 并将相应的 aar 文件依赖添加到项目级别的 build.gradle 文件中：

implementation files('libs/GDTActionSDK.min.1.8.9.aar')

权限说明

GDT SDK 会需要一定的权限支持：

权限说明
android.permission.INTERNET允许联网
android.permission.ACCESS_NETWORK_STATE检测联网方式，区分设备当前网络是2G、3G、4G还是WiFi
android.permission.READ_PHONE_STATE获取设备标识，标识用户
android.permission.WRITE_EXTERNAL_STORAGE文件读取权限

附：腾讯广点通广告 SDK 文档及原始下载地址

添加 GDT 分包 SDK 依赖（当前使用版本 3.0.4）​

在项目级别的 build.gradle 文件中添加 TT 广告 SDK 包的依赖：

implementation 'com.tencent.vasdolly:helper:3.0.4'

附：腾讯分包 SDK 文档及原始下载地址

KS SDK 集成​

添加 KS 分包 SDK 依赖（当前使用版本：0.2.0-beta）​

将 android附加/安卓渠道包工具/kuaishou 文件夹下的 aar 包导入到 app moudle 级别的 libs 文件夹中，并将相应的 aar 文件依赖添加到项目级别的 build.gradle 文件中：

implementation files('libs/channelsdk-0.2.0-beta.aar')

附：快手分包 SDK 使用原始文档