归因 · 获取设备ID · Gravity Engine

说明归因联调阶段如何获取 Android OAID 与 iOS IDFA，并将测试设备标识用于数据对接验证。

文档目的：本文档旨在帮助客户在联调测试阶段，快速获取测试设备的唯一标识符（OAID/IDFA），并提供给引力运营团队，以顺利完成数据对接的验证工作。

阅读对象：正在进行引力平台 SDK 接入联调测试的客户/运营人员。

一、联调准备工作核心目标

在开始联调前，您需要在一台真实的测试手机上，获取其设备标识符，并将此 ID 提供给引力的运营人员。

请注意：此流程仅用于联调测试，正式环境中 SDK 会自动完成采集，无需手动操作。

为保证获取方式的稳定性和准确性，我们强烈推荐您使用我们提供的专用工具。

推荐方案：使用引力平台官方推荐的测试工具

下载安装
- 请使用安卓测试手机的浏览器访问下载链接。
- 下载链接：gravity-oaid-demo.apk
- 在浏览器中打开链接后，下载并安装应用。
获取 OAID
- 安装成功后，在手机桌面找到并打开应用。
- 应用启动后，点击获取设备标识符，页面会清晰显示本机的 OAID/AndroidID。
- 复制获取到的设备信息。
提交信息
- 将获取到的设备 ID 提供给与您对接的引力平台运营人员。

推荐方案：使用引力平台官方推荐的测试工具

下载安装
- 请使用鸿蒙测试手机的浏览器访问下载链接。
- 下载链接：gravity-oaid-demo.hap
- 在浏览器中打开链接后，下载并安装应用。
获取 OAID
- 安装成功后，在手机桌面找到并打开应用。
- 应用启动后，点击获取设备标识符，页面会清晰显示本机的 OAID/ODID（AndroidID）。
- 复制获取到的设备信息。
提交信息
- 将获取到的设备 ID 提供给与您对接的引力平台运营人员。

我们推荐使用My Device ID by AppsFlyer获取 IDFA，该方法直接、可靠。

操作步骤：

下载安装
- 请使用 iPhone 测试机打开 App Store。
- 在搜索框中输入 “My Device ID by AppsFlyer” 搜索下载并安装。
获取 IDFA
- 安装完成后，打开下载好的应用。
- 应用启动后，复制 IDFA 值。
提交信息
- 将复制好的 IDFA 提供给与您对接的引力平台运营人员。

Q1：为什么一定要提供 OAID/IDFA？

A：这是联调测试的关键步骤。我们需要用您提供的 ID 在后台系统中验证数据链路是否通畅，行为数据能否正确关联到您的测试设备，从而确认 SDK 是否集成成功。

Q2：在 iOS 上弹出了“允许追踪”的弹窗，该怎么办？

A：请务必点击**“允许”**，否则将获取到无效的标识符。

Q3：iOS 获取到的 IDFA 是 00000000-0000-0000-0000-000000000000 怎么办？

A：在设置 > 隐私与安全性 > 跟踪中开启“允许 App 请求跟踪”。

Q4：工具无法安装或打开怎么办？

A：请先确认：

如有任何疑问，请联系您的引力平台对接运营或技术支持。

祝您联调顺利！