客户端 SDK

配置

如何配置 AudienceLab Unity SDK

Version:

初始设置

  1. 在 Unity 菜单中进入 AudienceLab SDK,打开设置窗口
  2. 输入 AudienceLab 提供的认证 token
  3. 点击 Verify 将 Unity 项目与您的应用关联
  4. 保存项目并重启 Unity,确保初始化生效

SDK 设置窗口

SDK 设置窗口分为 3 个标签页(Tab):

Main Tab

设置说明
isSDKEnabledSDK 功能总开关
SendStatistics开启/关闭数据采集
ShowDebugLog在 Console 输出调试日志(排障用)

Privacy Tab

配置设备标识符采集策略(用于提升归因准确性):

模式说明
Auto GAIDSDK 自动采集 Google Advertising ID(推荐)
Manual/Disabled通过 SetAdvertisingId() 手动提供 GAID,或禁用 GAID 采集(依赖概率匹配)

其他选项:

  • 自动采集 App Set ID:采集 Android App Set ID(不需要用户授权)

依赖行为(Play Services Dependencies):

设置是否自动添加 Play Services 依赖
Auto GAID 开启✅ 自动添加
GAID 禁用 + App Set ID 自动采集✅ 自动添加
GAID 禁用 + App Set ID 也禁用❌ 不添加

Debug Tab

配置调试悬浮层(开发与测试用):

设置说明
Enable Debug Overlay开启/关闭调试悬浮层(仅 Editor / Development 构建)
Max Events悬浮层显示的最近事件数量(默认 20)
Show Raw Identifiers显示完整设备标识符(而非截断值)
Toggle Key切换悬浮层的快捷键(默认 F8)

调试悬浮层仅在 Unity Editor 与 Development 构建可用,Release 构建不会显示。

Android 依赖项

SDK 在 Android 侧需要 Google Play Services 依赖来完成身份标识采集。这些依赖会根据你的 SDK 设置自动管理。

自动模式(默认)

当开启 Auto GAIDApp Set ID 自动采集 时:

  • 构建时会自动生成依赖
  • 无需手动配置
  • 每次 Android 构建前,SDK 会生成 Assets/Plugins/Android/AudienceLabIdentity.gradle

禁用模式

GAID 禁用App Set ID 自动采集也禁用 时:

  • 不会添加任何 Play Services 依赖
  • 可减少包体积,避免不必要的权限/依赖
  • 适合不需要广告标识符的应用
  • 仍可通过 SetAdvertisingId()SetAppSetId() 手动提供 GAID / App Set ID

手动管理依赖

如果你希望手动控制依赖,或需要自定义版本:

  1. 在菜单选择 AudienceLab SDK > Android > Regenerate Android Dependencies 生成 gradle 文件
  2. 或在 mainTemplate.gradle 中自行添加依赖:
dependencies {
    implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
    implementation 'com.google.android.gms:play-services-appset:16.0.2'
}

检查依赖状态

使用 AudienceLab SDK > Android > Check Android Dependencies 查看:

  • 当前 GAID 模式
  • 是否需要 Play Services 依赖
  • gradle 文件是否存在

ProGuard 配置(Android)

若你在 Android Release 构建中启用了代码混淆,需要添加以下 ProGuard 规则:

-keep class com.Geeklab.plugin.** { *; }

将其添加到现有 ProGuard 配置中,或在 Assets/Plugins/Android 下创建 proguard-user.txt 并写入上述规则。