故障排除

SDK 不发送事件

1. 在 SDK 设置中确认已开启 isSDKEnabled 与 SendStatistics
2. 检查 token 是否已验证成功
3. 启用 ShowDebugLog 查看 Console 输出
4. 使用 Debug Overlay 检查请求状态

缺少设备标识符

1. 检查 SDK 配置中的 Privacy tab 设置
2. GAID：确认设备可用 Play Services
3. 手动模式：确认尽早调用了 SetAdvertisingId()

事件未出现在控制台/看板

1. 检查设备网络连接
2. 确认 token 在 SDK 设置中有效
3. 事件处理可能需要几分钟
4. 在 Debug Overlay 中查看是否有错误

ProGuard 问题（Android）

如果在 Release 构建中出现 ClassNotFoundException 或 NoSuchMethodError：

1. 确认已添加 ProGuard 规则：

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

2. 重新构建项目
3. 在 Release 构建中测试所有 SDK 功能

Token 验证失败

1. 检查网络连接
2. 在 AudienceLab 控制台确认 token 是否正确
3. 确认 token 未过期
4. 保存 token 后尝试重启 Unity

事件在排队但没有发送

1. 检查网络连接
2. 确认 token 有效
3. 检查队列限制（最多 200 个事件，24 小时过期）
4. 用 Debug Overlay 观察队列状态

Debug Overlay 不显示

1. 确认在 SDK 设置中勾选了 Enable Debug Overlay
2. 检查 toggle key（默认 F8）
3. 真机：使用五指点击
4. 确认当前为 Development 构建（不是 Release）

获取帮助

如仍无法解决：

1. 开启调试日志并导出 Console 输出
2. 记录 SDK 版本（AudiencelabSDK.GetSDKVersion()）
3. 说明复现步骤
4. 联系 AudienceLab 支持并提供上述信息