客户端 SDK
Android 身份标识
配置 Android 设备标识符采集
Version:
SDK 提供了灵活的 Android 设备标识符采集方案,以提升归因准确性。
自动采集(默认)
默认情况下,SDK 会自动采集:
- GAID(Google Advertising ID)- 需要 Play Services
- App Set ID - 不需要用户授权
- Android ID - 作为兜底标识符
在 Unity 中配置:AudienceLab SDK > Privacy tab
手动 GAID 模式
如果你的应用已经自行采集 GAID,也可以手动提供给 SDK:
// 手动设置 GAID(尽早调用,在 SDK 发出请求前)
AudiencelabSDK.SetAdvertisingId("your-gaid-here");
// 可选:手动设置 App Set ID
AudiencelabSDK.SetAppSetId("your-app-set-id-here");
// 清除手动覆盖
AudiencelabSDK.ClearAdvertisingId();
AudiencelabSDK.ClearAppSetId();重要
使用手动模式时:
- 在 SDK 设置里将 identity mode 设置为 Manual GAID
- 尽可能早地调用
SetAdvertisingId()(例如初始化逻辑中) - SDK 在发送首个请求前最多等待 2 秒来获取 identity
Identity 模式
| 模式 | 说明 |
|---|---|
| Auto GAID | SDK 自动采集 GAID(推荐) |
| Manual GAID | 通过 SetAdvertisingId() 手动提供 GAID |
| Disabled | 不采集 GAID;依赖概率匹配 |
App Set ID
App Set ID 是更偏隐私友好的标识符:
- 不需要用户授权
- 当用户卸载你开发者账号下的所有应用时会重置
- 适合在你的应用矩阵内做跨 App 分析
// 在 SDK 设置里开启 App Set ID 自动采集
// 或手动设置:
AudiencelabSDK.SetAppSetId("your-app-set-id-here");