← 资料库索引 ← 官方文档 原始链接 ↗ 🔍
官方文档

AppsFlyer:设备标识符说明(GAID / IDFA / IDFV / OAID / App Set ID 用途) 原文标题:About device identifiers

发表时间:2026-10-01采集时间:2026-10-09 21:20:00来源:support.appsflyer.com原文语言:en状态:完整

内容概要总结

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)

⚠ 说明:原引用链接 support.appsflyer.com 对本机不可直连:直连 SSL UNEXPECTED_EOF、真实浏览器 ERR_CONNECTION_CLOSED、走 DoH 拿真实 IP 后 curl 仍 403(Cloudflare 机器人拦截)。改用该帮助中心(Zendesk)官方 API,经 appsflyer.zendesk.com 取到**同一篇文章**(article id 4408847686161,与引用链接同一 ID)的正文 HTML,再用本仓库当前抽取器转 markdown;表格与正文均取自 API 原文,未编造。原文为英文,中文为译文。

速览:了解 AppsFlyer SDK 支持哪些设备标识符。

概述

AppsFlyer SDK 提供了一套框架,让客户可以配置自己的 App 使用哪些设备标识符来做归因与统计分析。

客户可以根据自身 App 的需求、适用的平台政策以及用户授权情况,配置 SDK 去获取 GAID、IDFA、IDFV 等广告标识符(例如面向第三方 Android 应用商店、或在中国大陆投放的 App)。

Android 设备标识符

SDK 在 Android 平台支持以下设备标识符:

上架 Google Play 的应用

设备标识符用途
GAIDGoogle 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 平台支持以下设备标识符:

设备标识符用途
IDFAApple 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 TVadvertising_id
tvOS (Apple TV)idfa
Amazon Fire TVamazon_fire_id
Chromecastadvertising_id
Rokurida
Viziovida
Samsungtifa
LGLG Ads=lg_adid
Xboxcustom
Vidaavidaaid
Steamsteamid
Meta Quest (Oculus)custom
Epic Gamesepicid
PlayStationpsid
Native PCcustom
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 identifierPurpose
GAIDA 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 identifierPurpose
Amazon Advertising IDA user-resettable, unique identifier used by Amazon Fire TV. See CTV overview
OAIDA user-resettable identifier used by some out-of-store Android markets. For more information, see the Guide to implementing OAID.
Android IDA 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 identifierPurpose
IDFAA 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.
IDFVA 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:

PlatformDevice ID
Android TVadvertising_id
tvOS (Apple TV)idfa
Amazon Fire TVamazon_fire_id
Chromecastadvertising_id
Rokurida
Viziovida
Samsungtifa
LGLG Ads=lg_adid
Xboxcustom
Vidaavidaaid
Steamsteamid
Meta Quest (Oculus)custom
Epic Gamesepicid
PlayStationpsid
Native PCcustom
Google Play Games on PCSee Android identifiers