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.7.0",
},
"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>;
}
TT SDK 集成
由于今日头条的相关规定,若游戏需要在今日头条进行广告投放,则需要「强制接入」今日头条分包 SDK。具体需求请与广告组联系。
TT 广告 SDK & 分包 SDK 集成
广告 SDK 使用版本(商业化组件):2.0.2
(从 XDADs 3.5.0 版本开始,头条广告 SDK 商业化组件中内置分包 SDK 内容,无需单独接入分包 SDK,如采用原生集成方式,请移除该 aar 库(humesdk-1.0.0.aar)的依赖)
从 XDADs 3.7.0 版本开始,头条广告 SDK 在 Android 中的配置不再需要 app_id、app_name 信息,请使用 android_enable 配置。
Android 集成:
XDSDK Unity 会通过脚本来自动帮助游戏添加上 TT 广告 & 分包 SDK 的依赖配置,游戏只需在 XDConfig.json 文件中的 ad_config -> tt_config 下配置上 android_enable 为 true 即可。如下代码:
"ad_config": {
"tt_config": {
"android_enable": true
}
}
附:
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.9.2
分包 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 的正常依赖配置。
附:
KS SDK 集成
KS 分包 SDK 集成
广告 SDK 使用版本:0.2.0-beta
由于 KS 分包 SDK 是以 aar 包形式提供,所以 XDSDK Unity 上只要添加上了 com.xd.sdk.ads.subpkg 的模块即会自动添加上 KS 分包 SDK 的依赖,游戏无需关心其他配置内容。