# 获取设备ID

> 来源：https://help.gravity-engine.com/docs/attribution/device-id
> 说明归因联调阶段如何获取 Android OAID 与 iOS IDFA，并将测试设备标识用于数据对接验证。





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

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

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

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

* 如果您使用 **Android 手机**进行测试 → 需要获取 **OAID/AndroidID**
* 如果您使用 **Harmony 手机**进行测试 → 需要获取 **OAID/ODID（AndroidID）**
* 如果您使用 **iPhone** 进行测试 → 需要获取 **IDFA**

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

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

## 二、Android 测试机获取 OAID/AndroidID 指南 [#二android-测试机获取-oaidandroidid-指南]

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

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

## 三、Harmony 测试机获取 OAID/ODID（AndroidID）指南 [#三harmony-测试机获取-oaidodidandroidid指南]

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

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

## 四、iOS 测试机获取 IDFA 指南 [#四ios-测试机获取-idfa-指南]

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

**操作步骤：**

1. **下载安装**
   * 请使用 **iPhone 测试机**打开 **App Store**。
   * 在搜索框中输入 **“My Device ID by AppsFlyer”** 搜索下载并安装。

     <img src="__img0" />
2. **获取 IDFA**
   * 安装完成后，打开下载好的应用。
   * 应用启动后，复制 **IDFA** 值。
3. **提交信息**
   * 将复制好的 IDFA 提供给与您对接的**引力平台运营人员**。

## 五、常见问题（FAQ） [#五常见问题faq]

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

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

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

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

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

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

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

A：请先确认：

* Android 手机：请在“设置”中开启“允许来自未知来源的应用”的安装权限。
* iOS 手机：请确认设备系统版本为 iOS 9 或以上。
* 如果问题依旧，请直接联系引力运营人员。

***

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

**祝您联调顺利！**