客户端 SDK
配置
如何配置 AudienceLab Unity SDK
Version:
初始设置
- 在 Unity 菜单中进入 AudienceLab SDK,打开设置窗口
- 输入 AudienceLab 提供的认证 token
- 点击 Verify 将 Unity 项目与您的应用关联
- 保存项目并重启 Unity,确保初始化生效
SDK 设置窗口
SDK 设置窗口分为 3 个标签页(Tab):
Main Tab
| 设置 | 说明 |
|---|---|
| isSDKEnabled | SDK 功能总开关 |
| SendStatistics | 开启/关闭数据采集 |
| ShowDebugLog | 在 Console 输出调试日志(排障用) |
Privacy Tab
配置设备标识符采集策略(用于提升归因准确性):
| 模式 | 说明 |
|---|---|
| Auto GAID | SDK 自动采集 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 GAID 或 App Set ID 自动采集 时:
- 构建时会自动生成依赖
- 无需手动配置
- 每次 Android 构建前,SDK 会生成
Assets/Plugins/Android/AudienceLabIdentity.gradle
禁用模式
当 GAID 禁用 且 App Set ID 自动采集也禁用 时:
- 不会添加任何 Play Services 依赖
- 可减少包体积,避免不必要的权限/依赖
- 适合不需要广告标识符的应用
- 仍可通过
SetAdvertisingId()与SetAppSetId()手动提供 GAID / App Set ID
手动管理依赖
如果你希望手动控制依赖,或需要自定义版本:
- 在菜单选择 AudienceLab SDK > Android > Regenerate Android Dependencies 生成 gradle 文件
- 或在
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 并写入上述规则。