客户端 SDK

调试悬浮层

开发阶段的内置调试工具

Version:

SDK 内置调试悬浮层(Debug Overlay),用于在开发阶段快速排查集成问题。

启用调试悬浮层

  1. 打开 AudienceLab SDK > Debug tab
  2. 勾选 Enable Debug Overlay
  3. 配置选项:
    • Max Events:显示的最近事件数量
    • Show Raw Identifiers:显示完整设备标识符
    • Toggle Key:切换快捷键(默认 F8)

真机切换

在 Development 构建中,移动设备可通过 五指点击 来切换悬浮层显示/隐藏。

悬浮层展示信息

调试悬浮层会显示:

  • Token 状态与最近一次获取尝试
  • 设备标识符(IDFV、GAID、App Set ID)
  • 最近请求的成功/失败状态
  • 请求 payload 与响应内容

配置项说明

选项说明
Max Events悬浮层显示的最近事件数量
Show Raw Identifiers显示完整设备标识符(而非截断值)
Toggle Key切换悬浮层可见性的快捷键

可用范围

调试悬浮层仅在 EditorDevelopment 构建可用;Release 构建会自动排除。

用悬浮层进行排障

你可以用它来确认:

  1. Token 状态:token 是否有效,是否已成功获取
  2. 设备标识符:预期的标识符是否被采集到
  3. 请求状态:事件请求的成功/失败情况
  4. Payload:实际发送到服务端的具体数据