跳到主要内容

Unity

提示

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

SDK 集成​

提示

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

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

  • 通过 NPM 方式添加引用：
{
    "dependencies": {
        "com.xd.sdk.ads.subpkg": "3.6.1",
    },
    "scopedRegistries": [
        {
            // NPMJS 访问不通时可以切换到淘宝源试试 https://registry.npmmirror.com
            // 公司内网可使用 http://npm.xindong.com 
            "name": "NPMJS",
            "url": "https://registry.npmjs.org/",
            "scopes": [
                "com.xd",
                "com.tapsdk",
                "com.leancloud"
            ]
        }
    ]
}

版本信息参考更新日志。

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

-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 集成​

危险

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

TT 广告 SDK & 分包 SDK 集成​

提示

广告 SDK 使用版本：6.16.9
分包 SDK 使用版本：1.0.0

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

Android 集成：​

XDSDK Unity 会通过脚本来自动帮助游戏添加上 TT 广告 & 分包 SDK 的依赖配置，游戏只需在 XDConfig.json 文件中的 ad_config -> tt_config 下配置上正确的 app_id、app_name 的信息即可。

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

iOS 集成：​

XDSDK Unity 会通过脚本来自动帮助游戏添加上 TT 广告 & 分包 SDK 的依赖配置，游戏只需在 XDConfig.json 文件中的 ad_config -> tt_config 下配置上 ios_enable 为 true 即可。如下代码：

    "ad_config": {
      "tt_config": {
        "ios_enable": true
      }
    }

GDT SDK 集成​

GDT 广告 SDK & 分包 SDK 集成​

提示

广告 SDK 使用版本：1.8.9
分包 SDK 使用版本：3.0.4

XDSDK Unity 会通过脚本来自动帮助游戏添加上 GDT 广告 & 分包 SDK 的依赖配置，游戏只需在 XDConfig.json 文件中的 ad_config -> gdt_config 下配置正确的 user_action_set_id、app_secret_key 的信息即可。其中如果不需要 GDT 的广告 SDK 功能，只需将 user_action_set_id 和 app_secret_key 设置为空字符串即可，切勿将整个 gdt_config 配置删掉，否认会影响 GDT 分包 SDK 的正常依赖配置。

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

KS SDK 集成​

KS 分包 SDK 集成​

提示

广告 SDK 使用版本：0.2.0-beta

由于 KS 分包 SDK 是以 aar 包形式提供，所以 XDSDK Unity 上只要添加上了 com.xd.sdk.ads.subpkg 的模块即会自动添加上 KS 分包 SDK 的依赖，游戏无需关心其他配置内容。