客户端 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();

重要

使用手动模式时:

  1. 在 SDK 设置里将 identity mode 设置为 Manual GAID
  2. 尽可能早地调用 SetAdvertisingId()(例如初始化逻辑中)
  3. SDK 在发送首个请求前最多等待 2 秒来获取 identity

Identity 模式

模式说明
Auto GAIDSDK 自动采集 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");