# 获取设备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 端推荐使用我们提供的专用工具；Harmony 端请直接通过系统设置查看。

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

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

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

## 三、Harmony 测试机获取 OAID 指南 [#三harmony-测试机获取-oaid-指南]

请根据您设备的 HarmonyOS 版本，在系统设置中查找 OAID。

### HarmonyOS 5.0 及以上设备 [#harmonyos-50-及以上设备]

依次进入 **设置 > 隐私和安全 > 跨应用关联**，滑到底部即可查看 OAID，可长按复制。

### HarmonyOS 5.0 以下设备 [#harmonyos-50-以下设备]

请根据您的系统版本，选择对应的查找路径：

1. **HarmonyOS 4.X**：设置 > 隐私 > 跟踪管理 > 滑到底部点击“查看 OAID”，可长按复制
2. **HarmonyOS 3.X**：设置 > 隐私 > 广告与隐私 > 底部点击“查看 OAID”，可长按复制
3. **HarmonyOS 2.X**（以下两种方式任选其一）：
   * 设置 > 安全和隐私 > 更多安全设置 > 匿名设备标识 > 点击“查看 OAID”
   * 设置 > 隐私 > 广告与隐私 > 底部点击“查看 OAID”
4. **EMUI 9.X**：设置 > 应用 > 应用管理 > 搜索“HMS Core” > 点击右上角齿轮按钮进入“设置” > 选择“广告” > 点击“查看 OAID”
5. **其他版本**（以下两种方式任选其一）：
   * 设置 > HMS Core > 广告
   * 设置 > 隐私 > HMS Core > 广告

> **提示**
> 若以上方法均找不到 OAID，可先卸载 HMS Core 更新（设置 > 应用/应用和服务 > 应用管理 > HMS Core > 右上角三/四点 > 卸载更新），再按上述路径重新查找。

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

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

**操作步骤：**

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

     <img alt="App Store 中 My Device ID by AppsFlyer 应用的下载页面" 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 或以上。
* 如果问题依旧，请直接联系引力运营人员。

***

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

**祝您联调顺利！**