AppsFlyer:设备标识符说明(GAID / IDFA / IDFV / OAID / App Set ID 用途) 原文标题:About device identifiers
内容概要总结
AppsFlyer 帮助中心关于「SDK 支持哪些设备标识符」的官方说明(英文原文,更新于 2026-10-01)。按平台列出:Android 侧 GAID(Google Play,V4.8.0 起自动采集)、Amazon Advertising ID、OAID(非商店渠道)、Android ID(不自动采集、不可与 GAID 并用);Apple 侧 IDFA(iOS 14.5 起需 ATT 授权)与 IDFV(同厂商 App 共享、全卸载后重置);以及 CTV / PC / 主机平台各自的设备 ID 字段名(Android TV=advertising_id、Roku=rida、Samsung=tifa、Steam=steamid 等)。用于核对「广告标识符类设备 ID 在各平台叫什么、什么时候可获取」。
翻译内容
原文内容(English)
速览:了解 AppsFlyer SDK 支持哪些设备标识符。
概述
AppsFlyer SDK 提供了一套框架,让客户可以配置自己的 App 使用哪些设备标识符来做归因与统计分析。
客户可以根据自身 App 的需求、适用的平台政策以及用户授权情况,配置 SDK 去获取 GAID、IDFA、IDFV 等广告标识符(例如面向第三方 Android 应用商店、或在中国大陆投放的 App)。
Android 设备标识符
SDK 在 Android 平台支持以下设备标识符:
上架 Google Play 的应用
| 设备标识符 | 用途 |
|---|---|
| GAID | Google Play 渠道 Android 用户的可重置标识符。从 SDK V4.8.0 起,AppsFlyer 会自动采集该标识符。 |
上架第三方应用商店的应用
| 设备标识符 | 用途 |
|---|---|
| Amazon Advertising ID | 可重置的唯一标识符,用于 Amazon Fire TV。参见 CTV 概览(https://support.appsflyer.com/hc/en-us/articles/4404083608849)。 |
| OAID | 部分非商店渠道 Android 应用市场使用的可重置标识符。详见 OAID 接入指南(https://support.appsflyer.com/hc/en-us/articles/360006278797)。 |
| Android ID | 第三方应用商店中使用的、不可重置的设备唯一标识符。SDK 不会自动采集 Android ID;如有采集需要,可由开发者自行实现。注意:Android ID 不能与 GAID 同时使用。 |
Apple 设备标识符
SDK 在 iOS 平台支持以下设备标识符:
| 设备标识符 | 用途 |
|---|---|
| IDFA | Apple iOS 或 tvOS(Apple TV)用户的可重置唯一标识符。自 iOS 14.5 起,只有在用户通过 ATT 弹窗授权后才可获得 IDFA。 |
| IDFV | 同一厂商在同一台设备上的所有 App 共享的标识符。安装第一个 App 时即为它分配 IDFV,该厂商的其它 App 会被分配同一个 IDFV,其它厂商的 App 则分配到不同的 IDFV。此外,当某厂商的全部 App 都被移除后,该厂商的 IDFV 会被删除,重新安装时会分配新的 IDFV。 |
CTV、PC 与主机平台的设备标识符
SDK 在 CTV、PC 与主机平台支持以下设备标识符:
| 平台 | 设备 ID |
|---|---|
| Android TV | advertising_id |
| tvOS (Apple TV) | idfa |
| Amazon Fire TV | amazon_fire_id |
| Chromecast | advertising_id |
| Roku | rida |
| Vizio | vida |
| Samsung | tifa |
| LG | LG Ads=lg_adid |
| Xbox | custom |
| Vidaa | vidaaid |
| Steam | steamid |
| Meta Quest (Oculus) | custom |
| Epic Games | epicid |
| PlayStation | psid |
| Native PC | custom |
| Google Play Games on PC | 见「Android 设备标识符」一节(https://support.appsflyer.com/hc/en-us/articles/4408847686161-Device-identifiers#android-device-identifiers) |
At a glance: Understand the device identifiers supported in the AppsFlyer SDK.
Overview
The AppsFlyer SDK provides a framework for customers to configure which device identifiers their app uses for attribution and analytics.
The customer can configure the SDK to retrieve advertising identifiers such as GAID, IDFA, and IDFV, based on their app's needs, applicable platform policies, and user consent. (for example, third-party Android app stores or apps marketed in China).
Android device identifiers
The SDK supports the following device identifiers for Android platforms:
Apps published on Google Play
| Device identifier | Purpose |
|---|---|
| GAID | A user-resettable identifier for Google Play Android users. Starting with SDK V4.8.0, AppsFlyer automatically collects this device identifier. |
Apps published in third-party app stores
| Device identifier | Purpose |
|---|---|
| Amazon Advertising ID | A user-resettable, unique identifier used by Amazon Fire TV. See CTV overview |
| OAID | A user-resettable identifier used by some out-of-store Android markets. For more information, see the Guide to implementing OAID. |
| Android ID | A unique, non-resettable mobile-device identifier used in third-party app stores. The SDK does not automatically collect the Android ID. However, if there is a need to collect these identifiers, your developer can implement collection. Note: Android ID cannot be used in conjunction with GAID. |
Apple device identifiers
The SDK supports the following device identifiers for iOS platforms:
| Device identifier | Purpose |
|---|---|
| IDFA | A unique user-resettable identifier for Apple iOS or tvOS (Apple TV) users. Since the release of iOS 14.5, IDFA is available only if the user consents via the ATT prompt. |
| IDFV | A device identifier shared by all the apps from the same vendor on the device. Once the first app is installed, the ID is assigned to it, and other apps from the same vendor are assigned the same IDFV. Apps from other vendors are assigned a different IDFV. In addition, when all the apps from a specific vendor are removed, the IDFV for that vendor is deleted, and upon a new installation, a new IDFV will be assigned. |
CTV , PC, and console app device identifiers
The SDK supports the following device identifiers for CTV, PC, and console platforms:
| Platform | Device ID |
|---|---|
| Android TV | advertising_id |
| tvOS (Apple TV) | idfa |
| Amazon Fire TV | amazon_fire_id |
| Chromecast | advertising_id |
| Roku | rida |
| Vizio | vida |
| Samsung | tifa |
| LG | LG Ads=lg_adid |
| Xbox | custom |
| Vidaa | vidaaid |
| Steam | steamid |
| Meta Quest (Oculus) | custom |
| Epic Games | epicid |
| PlayStation | psid |
| Native PC | custom |
| Google Play Games on PC | See Android identifiers |