客户端提示概述和常见问题解答
客户端提示是单独的关于用户设备的信息。它们由 Chromium 浏览器提供,例如 Google Chrome 和 Microsoft Edge。对于这些浏览器,客户端提示将逐渐取代 User-Agent 作为设备信息的来源。Adobe Analytics 将更新其设备查找过程,以使它在 User-Agent 之外使用客户端提示确定设备信息。
低熵和高熵客户端提示
Google 将 User-Agent 客户端提示分为两类:低熵提示和高熵提示。
-
低熵提示 包含更加通用的设备信息。Chromium 浏览器自动提供这些提示。
-
高熵 提示包含更加详细的信息。仅应请求提供这些提示。AppMeasurement 和 Web SDK 都可以配置为请求高熵提示。默认情况下,两个库都 不 请求高熵提示。
从 2022 年 10 月开始,Chromium 浏览器的新版本已开始“冻结”在 User-Agent 字符串中表示的操作系统版本。操作系统版本是高熵提示,因此要保证报告中操作系统版本的准确无误,必须配置收藏集库以使其收集这些高熵提示。User-Agent 的其他设备信息逐渐将被冻结,需要客户端提示以保持设备报告准确性。
从2023年2月27日开始,客户端提示将纳入Analytics设备查找流程,并将于2023年3月2日结束。 AppMeasurement 和 Web SDK 目前都支持收集提示数据,但直到 2 月中旬才会用于设备查找。如下所述,操作系统版本已从 10 月开始冻结,但由于逐步推出以及许多用户代理已提高冻结的操作系统版本(有关更多信息,请参见此处),我们估计这将影响不到 3% 的 Chrome 访客。
Adobe Audience Manager需要收集高熵提示以保留完整功能。 如果您正在使用服务器端转发到Adobe Audience Manager,则您可能希望启用高熵提示的收集。
常见问题解答
浏览器会自动提供低熵提示,这些提示经摄取后用于获取设备和浏览器信息。较新版本的 Web SDK(从 2.12.0 开始)和 AppMeasurement(从 2.23.0 开始)可以配置为通过各自的标记扩展或直接通过配置选项收集高熵提示。请参阅关于 Web SDK 和 AppMeasurement 的说明。
这两个库 在默认情况下禁用 高熵提示的收集。
对于通过 API(例如,通过数据插入 API 或批量数据插入 API)提交的数据,提示必须明确包含在负载中。请参阅相应文档以了解详细信息。
目前还不可以。 您可以选择收集所有高熵提示,或者都不收集。
请注意,当前不收集fullVersionList,因为浏览器主版本被捕获为低熵提示。
下表对截至 2022 年 10 月的客户提示进行了说明。
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 | |||
---|---|---|---|
提示 | 描述 | 高熵或低熵 | 示例 |
Sec-CH-UA | 浏览器和重要版本 | 低 | "Google Chrome 84" |
Sec-CH-UA-Mobile | 移动设备类型(true 或 false) | 低 | true |
Sec-CH-UA-Platform | 操作系统/平台 | 低 | "Android" |
体系结构 | 网站架构 | 高 | "arm" |
位数 | 架构位 | 高 | "64" |
fullVersionList | 品牌及其版本的列表 | 高 | "Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98" |
model | 设备型号 | 高 | "Pixel 3" |
平台版本 | 操作系统/平台版本 | 高 | "10" |
- 通过请求头收集底熵提示。
- 高熵提示通过 JavaScript 收集并通过查询字符串参数值传递。 查询字符串参数使用
h.
作为图像请求中的前缀。 请注意,当前不收集fullVersionList,因为浏览器主版本被捕获为低熵提示。
高熵提示通过 JavaScript 调用收集并通过查询参数传递
这些字段直接从用户-代理派生,但用户-代理可用于帮助派生其他设备相关字段的值,具体取决于设备详细信息。
报告中的设备信息派生自用户代理程序。 我们更新了我们的流程,以便在可用的情况下同时使用用户代理程序和客户端提示。
回退 ID (s_fid) 派生自用户代理程序和 IP 地址。此 ID 仅在无法设置 Cookie 时使用,因此未被广泛使用
随着 Google“冻结”用户代理的更多部分,这将随着时间的推移而改变。第一个受到直接影响的字段是“操作系统”(其中包括操作系统版本)。根据 Google 发布的“冻结”用户-代理提示的时间表,操作系统版本将从 2022 年 10 月底的 Chromium 版本 107 开始冻结。届时,用户代理中的操作系统版本在某些情况下会不准确。
请参阅 Google 发布的时间表以参阅冻结 User-Agent 其他部分的时机。