遥测

本节介绍了用于测量与地址栏交互的现有遥测探针。

有关 Firefox Suggest 特定的遥测信息，请参阅 Firefox Suggest 遥测 文档。

直方图

PLACES_AUTOCOMPLETE_1ST_RESULT_TIME_MS

此探针跟踪获取第一个结果所需的时间。它是一个指数直方图，值介于 5 到 100 之间。

PLACES_AUTOCOMPLETE_6_FIRST_RESULTS_TIME_MS

此探针跟踪获取前六个结果所需的时间。它是一个指数直方图，值介于 50 到 1000 之间。

FX_URLBAR_SELECTED_RESULT_METHOD

此探针跟踪用户从列表中选择结果的方式。它是一个分类直方图，包含以下值

  • enter 用户在未首先选择结果的情况下按下了 Enter 键。这很可能发生在用户确认默认预选结果（也称为启发式结果）时，或者当他们使用键盘选择一次性搜索按钮并使用 Enter 键确认时。

  • enterSelection 用户选择了一个结果，但不是使用 Tab 键或箭头键，然后按下了 Enter 键。这是一个罕见且通常意想不到的事件，可能存在一些我们没有考虑到的奇特方式来选择结果，这些方式在这里进行跟踪。查看 arrowEnterSelection 和 tabEnterSelection 以了解更常见的操作。

  • click 用户点击了一个结果。

  • arrowEnterSelection 用户使用箭头键选择了一个结果，然后按下了 Enter 键。

  • tabEnterSelection 用户按下的第一个选择结果的键是 Tab 键，然后他们按下了 Enter 键。请注意，这意味着用户在第一次按下 Tab 键后可能使用了箭头键。

  • rightClickEnter 在 QuantumBar 之前，可以通过右键单击结果来突出显示，但不能选择它。然后用户可以按 Enter 键。这不再可能。

FX_URLBAR_ZERO_PREFIX_DWELL_TIME_MS

此探针记录显示零前缀视图的时间；即从打开到关闭的时间。“零前缀”表示搜索字符串为空，因此零前缀视图是在用户在输入搜索字符串之前单击地址栏中时显示的视图。通常也称为“热门网站”视图，因为它通常会显示用户的热门网站。这是一个指数直方图，其值范围从 0 到 60,000，有 50 个桶。值以毫秒为单位。此直方图在 Firefox 110.0 中引入，参见 bug 1806765。

PLACES_FRECENCY_RECALC_CHUNK_TIME_MS

这记录了重新计算页面块的频率所需的时间，如 PlacesFrecencyRecalculator 模块中所定义。

标量

urlbar.abandonment

一个 uint，记录地址栏中放弃的参与次数。当用户开始使用地址栏但在完成参与之前停止时，就会发生放弃。当用户单击地址栏外部以聚焦窗口的其他部分时，可能会发生这种情况。当用户在地址栏处于焦点状态时切换到另一个窗口时，也可能会发生这种情况。

urlbar.autofill_deletion

一个 uint，记录地址栏中自动填充字符串的删除次数。当用户在自动填充字符串被选中时，使用 BACKSPACE 或 DELETE 键删除整个自动填充字符串时，就会发生这种情况。

urlbar.engagement

一个 uint，记录用户在地址栏中完成的参与次数。当用户使用地址栏导航到一个页面时，就会发生参与，例如通过选择地址栏面板中的结果或在地址栏中键入搜索词或 URL 并按下 Enter 键。

urlbar.impression.*

一个 uint，记录用户选择任何结果时显示的展示次数。

  • autofill_about 用于关于页面类型的自动填充。

  • autofill_adaptive 用于自适应历史类型的自动填充。

  • autofill_origin 用于来源类型的自动填充。

  • autofill_other 统计没有特定标量的其他类型的自动填充结果显示了多少次。这是一个回退，用于代码没有正确设置特定自动填充类型时，并且通常不应该使用。如果它出现在数据中，则意味着我们需要调查并修复没有正确设置特定自动填充类型的代码。

  • autofill_url 用于 URL 类型的自动填充。

urlbar.persistedsearchterms.revert_by_popup_count

一个 uint，当搜索词在地址栏中持久化，并且地址栏由于弹出通知而恢复显示完整 URL 时，此值会递增。当用户处于 SERP 上并请求权限时，可能会发生这种情况，例如请求访问位置。如果弹出窗口是持久性的，并且用户在切换标签之前没有将其关闭，则当他们返回标签时，弹出窗口将重新出现。因此，当返回带有持久弹出窗口的标签时，此值将递增，因为它应该持久化搜索词，但改为显示了完整 URL。

urlbar.persistedsearchterms.view_count

一个 uint，当搜索词应该在地址栏中持久化时，此值会递增。当用户从导致搜索词在地址栏中持久化的任何 SAP 加载 SERP 时，以及切换到包含应该在地址栏中持久化搜索词的 SERP 的标签时，无论是否存在弹出通知，都会触发此操作。因此，对于每个 revert_by_popup_count，都应该至少有一个相应的 view_count。

urlbar.tips

这是一个键控标量，其值为 uint，并在每次显示提示结果、选择提示以及选择提示的帮助按钮时递增。键为

  • intervention_clear-help 当用户在清除历史记录搜索干预中选择帮助按钮时递增。

  • intervention_clear-picked 当用户选择清除历史记录搜索干预时递增。

  • intervention_clear-shown 当显示清除历史记录搜索干预时递增。

  • intervention_refresh-help 当用户在刷新 Firefox 搜索干预中选择帮助按钮时递增。

  • intervention_refresh-picked 当用户选择刷新 Firefox 搜索干预时递增。

  • intervention_refresh-shown 当显示刷新 Firefox 搜索干预时递增。

  • intervention_update_ask-help 当用户在 update_ask 搜索干预中选择帮助按钮时递增，当有 Firefox 更新可用但用户的首选项表明我们应该要求他们下载和应用它时，会显示此干预。

  • intervention_update_ask-picked 当用户选择 update_ask 搜索干预时递增。

  • intervention_update_ask-shown 当显示 update_ask 搜索干预时递增。

  • intervention_update_refresh-help 当用户在 update_refresh 搜索干预中选择帮助按钮时递增，当用户的浏览器是最新的但他们触发了更新干预时，会显示此干预。我们会显示这个特殊的刷新干预。

  • intervention_update_refresh-picked 当用户选择 update_refresh 搜索干预时递增。

  • intervention_update_refresh-shown 当显示 update_refresh 搜索干预时递增。

  • intervention_update_restart-help 当用户在 update_restart 搜索干预中选择帮助按钮时递增，当有更新并且已下载并应用时，会显示此干预。用户需要重新启动才能完成。

  • intervention_update_restart-picked 当用户选择 update_restart 搜索干预时递增。

  • intervention_update_restart-shown 更新重启搜索干预措施显示时递增。

  • intervention_update_web-help 当用户在 update_web 搜索干预措施中选择帮助按钮时递增，该干预措施在由于某些原因无法更新浏览器或甚至可能无法检查更新时显示，因此用户应该从网络下载最新版本。

  • intervention_update_web-picked 当用户选择 update_web 搜索干预措施时递增。

  • intervention_update_web-shown 当 update_web 搜索干预措施显示时递增。

  • tabtosearch-shown 非 onboarding 的 Tab-to-Search 结果显示时递增，每个引擎每次参与递增一次。请注意，非 onboarding 的 Tab-to-Search 结果被选择的次数是 urlbar.searchmode.tabtosearch 中所有键的总和。另请注意，关于 onboarding 和非 onboarding 的 Tab-to-Search 结果的更详细的遥测数据记录在 urlbar.tabtosearch.* 中。这些 urlbar.tips 中的探测器仍在记录，因为 urlbar.tabtosearch.* 目前未在 Release 版本中记录。

  • tabtosearch_onboard-shown 当 Tab-to-Search onboarding 结果显示时递增，每个引擎每次参与递增一次。请注意，Tab-to-Search onboarding 结果被选择的次数是 urlbar.searchmode.tabtosearch_onboard 中所有键的总和。

  • searchTip_onboard-picked 当用户选择 onboarding 搜索提示时递增。

  • searchTip_onboard-shown 当 onboarding 搜索提示显示时递增。

  • searchTip_redirect-picked 当用户选择重定向搜索提示时递增。

  • searchTip_redirect-shown 当重定向搜索提示显示时递增。

urlbar.searchmode.*

这是一组键控标量，其值是每次在 Urlbar 中进入搜索模式时递增的无符号整数。标量名称的后缀描述了如何进入搜索模式。可能包括

  • bookmarkmenu 用户在“库”菜单中选择“搜索书签”菜单项时使用。

  • handoff 用户使用新标签页上的搜索框并切换到地址栏时使用。注意：此入口点已从 Firefox 88 禁用到 91。从 91 开始，它将出现，但数量较少。用户必须禁用 Urlbar 中的搜索才能通过 handoff 进入搜索模式。

  • keywordoffer 用户选择关键字推荐结果时使用。

  • oneoff 用户在 Urlbar 中选择一次性引擎时使用。

  • shortcut 用户使用键盘快捷键或菜单栏项（例如 Accel+K）进入搜索模式时使用。

  • tabmenu 用户在标签页溢出菜单中选择“搜索标签”菜单项时使用。

  • tabtosearch 用户选择 Tab-to-Search 结果时使用。当搜索引擎的域名自动填充时，这些结果会建议一个搜索引擎。

  • tabtosearch_onboard 用户选择 Tab-to-Search onboarding 结果时使用。这些结果在用户第一次遇到 Tab-to-Search 结果时显示。

  • topsites_newtab 用户在新标签页中选择搜索快捷方式“热门网站”时使用。

  • topsites_urlbar 用户在 Urlbar 中选择搜索快捷方式“热门网站”时使用。

  • touchbar 用户在 Touch Bar 上点击搜索快捷方式时使用，适用于某些 Mac 电脑。

  • typed 用户在 Urlbar 中键入引擎别名时使用。

  • historymenu 用户在历史记录菜单中选择“搜索历史记录”菜单项时使用。

  • other 用作其他行为的兜底。我们不希望此标量包含任何值。如果包含，则需要纠正搜索模式入口点的问题。

上述标量的键是引擎和来源名称。如果用户使用内置引擎进入远程搜索模式，我们将记录引擎名称。如果用户使用他们安装的引擎（例如，通过 OpenSearch 或 WebExtension）进入远程搜索模式，我们将记录 other（不要与上述 urlbar.searchmode.other 标量混淆）。

当用户进入本地搜索模式时，我们将记录结果来源的英文名称（例如，“书签”、“历史记录”、“标签页”）。如果他们通过 typed 进入本地搜索模式，我们将使用后缀“keyword”或“symbol”记录结果来源名称，具体取决于用户是否使用了符号（^, %, *, >）或关键字（@tabs, @bookmarks, @history, @actions）。如果他们通过 keywordoffer 进入本地搜索模式，当他们选择限制关键字时，我们将使用后缀“keyword”记录结果来源名称。

请注意，我们对某些内置引擎的引擎名称进行了略微修改：我们将所有本地化的 Amazon 站点（Amazon.com、Amazon.ca、Amazon.de 等）简化为“Amazon”，并将所有本地化的 Wikipedia 站点（Wikipedia (en)、Wikipedia (fr) 等）简化为“Wikipedia”。这样做是为了减少这些标量使用的键的数量。

变更日志
Firefox 132

urlbar.searchmode.typed 和 urlbar.searchmode.keywordoffer 的标量键已更新。

对于 urlbar.searchmode.typed

  • 如果用户使用限制关键字（@tabs、@history、@bookmarks、@actions）进入本地搜索模式，则标量键以“keyword”为前缀。

  • 如果用户通过符号（%, ^, *, >）进入，则键以“symbol”为前缀。

例如，在历史记录搜索模式下

  • 如果通过限制关键字进入，则记录的标量键为 history_keyword。

  • 如果通过符号进入，则记录的标量键为 history_symbol。

对于 urlbar.searchmode.keywordoffer

  • 如果用户通过 keywordoffer 方法使用限制关键字，则标量键以“keyword”为前缀。

请注意，符号无法触发 urlbar.searchmode.keywordoffer 遥测，因为符号仅对 typed 有效。[Bug 1919180]

urlbar.picked.*

这是一组键控标量，其值是每次从 Urlbar 中选择结果时递增的无符号整数。标量名称的后缀是结果类型。上述标量的键是在选择结果时，结果在 urlbar 面板中的基于 0 的索引。

注意

从 Firefox 84 开始可用。在早期版本中使用 FX_URLBAR_SELECTED_* 直方图。

注意

Firefox 102 已弃用 autofill 并添加了 autofill_about、autofill_adaptive、autofill_origin、autofill_other、autofill_preloaded 和 autofill_url。在 Firefox 116 中，autofill_preloaded 已被移除。

有效结果类型为

  • autofill 此标量已在 Firefox 102 中弃用，并替换为 autofill_about、autofill_adaptive、autofill_origin、autofill_other、autofill_preloaded 和 autofill_url。之前，它记录在其他标量现在涵盖的每种情况下。

  • autofill_about 自动填充的“about:”页面 URI（例如，about:config）。用户必须先键入“about:”才能触发此类型的自动填充。

  • autofill_adaptive 来自用户自适应历史记录的自动填充 URL。此类型的自动填充与 autofill_url 有两个不同之处：(1) 它基于用户自适应历史记录，这是一种将用户搜索字符串与其在地址栏中选择的 URL 关联的特定类型的历史记录。(2) 它自动填充完整的 URL，而不是“到下一个斜杠”的部分 URL。有关此类型自动填充的更多信息，请参阅此 自适应历史记录自动填充文档。

  • autofill_origin 来自用户历史记录的自动填充 来源。通常，“来源”表示域名或主机名，例如“mozilla.org”。从技术上讲，它还可以包括 URL 方案或协议（例如“https”）和端口号（例如“:8000”）。Firefox 可以自动填充单独的域名、带有方案的域名、带有端口的域名以及带有方案和端口的域名。所有这些情况都算作来源自动填充。有关更多信息，请参阅此 自适应历史记录自动填充文档。

  • autofill_other 统计在给定索引处选择了多少次其他类型的自动填充结果，这些结果没有特定的键控标量。这是一个后备，用于代码未正确设置特定自动填充类型时，并且通常不应该使用。如果它出现在数据中，则表示我们需要调查并修复未正确设置特定自动填充类型的代码。

  • autofill_url 来自用户历史记录的自动填充 URL 或部分 URL。Firefox 自动填充 URL“到下一个斜杠”，因此要触发 URL 自动填充，用户必须先键入域名（或触发来源自动填充），然后开始键入 URL 的其余部分（从技术上讲，其路径）。当他们继续键入时，URL 将仅被部分自动填充到下一个斜杠，或者如果没有下一个斜杠，则填充到 URL 的末尾。这允许用户轻松访问域的不同子路径。有关更多信息，请参阅此 自适应历史记录自动填充文档。

  • bookmark 书签 URL。

  • bookmark_adaptive 从自适应历史记录中检索的书签 URL。

  • clipboard 从系统剪贴板检索的 URL。

  • dynamic 特殊制作的结果，通常在实验中使用，当基本类型对于丰富的布局不够灵活时。

  • dynamic_wikipedia 动态的维基百科 Firefox Suggest 结果。

  • extension 由附加组件通过 omnibox WebExtension API 添加。

  • formhistory 来自先前搜索历史记录的搜索建议。

  • history 来自历史记录的 URL。

  • history_adaptive 从自适应历史记录中检索的历史记录 URL。

  • keyword 书签关键字。

  • navigational 导航建议 Firefox Suggest 结果。

  • quickaction 快速操作。

  • quicksuggest Firefox Suggest（又名快速建议）建议。

  • remotetab 从其他设备同步的标签页。

  • restrict_keyword_actions 将限制关键字结果进入操作搜索模式。

  • restrict_keyword_bookmarks 将限制关键字结果进入书签搜索模式。

  • restrict_keyword_history 将限制关键字结果进入历史记录搜索模式。

  • restrict_keyword_tabs 将限制关键字结果进入标签页搜索模式。

  • searchengine 搜索结果，但不是建议。可能是默认搜索操作或搜索别名。

  • searchsuggestion 远程搜索建议。

  • switchtab 打开的标签页。

  • tabtosearch 标签页到搜索结果。

  • tip 提示结果。

  • topsite 来自热门网站的条目。

  • trending 热门建议。

  • unknown 未知的结果类型，应该提交错误报告以确定它是什么。

  • visiturl 用户输入的字符串可以直接访问。

  • weather Firefox Suggest 天气建议。

urlbar.picked.searchmode.*

这是一组键控标量，其值是无符号整数，每次从 URL 地址栏搜索模式下选择结果时都会递增。标量名称的后缀是搜索模式入口点。标量的键是在选择时 URL 地址栏面板中结果的基于 0 的索引。

注意

这些标量同时包含 urlbar.picked.* 和 urlbar.searchmode.* 的元素。标量名称后缀是搜索模式入口点，例如 urlbar.searchmode.*。这些标量的键是结果索引，例如 urlbar.picked.*。

注意

这些数据是 urlbar.picked.* 记录的数据的子集。例如，如果用户通过点击一次性入口进入搜索模式，然后选择索引为 2 的 Google 搜索建议，我们将在 **两者** urlbar.picked.searchsuggestion 和 urlbar.picked.searchmode.oneoff 中记录。

urlbar.tabtosearch.*

这是一组键控标量，其值是无符号整数，当显示标签页到搜索结果时会递增，每个引擎每次参与递增一次。有两个子探测器：urlbar.tabtosearch.impressions 和 urlbar.tabtosearch.impressions_onboarding。前者记录常规标签页到搜索结果的展示次数，后者记录引导标签页到搜索结果的展示次数。键值与 urlbar.searchmode.* 探测器的键值相同：它们是在标签页到搜索结果中显示的引擎的名称。非内置引擎将分组在键 other 下。

注意

由于这些数据的潜在敏感性，目前仅在 Firefox 的预发布版本中收集这些数据。请参阅 错误 1686330。

urlbar.zeroprefix.abandonment

一个无符号整数，记录零前缀视图放弃的次数。“零前缀”表示搜索字符串为空，因此零前缀视图是在用户在输入搜索字符串之前点击 URL 地址栏时显示的视图。通常称为“热门网站”视图，因为它通常显示用户的热门网站。“放弃”表示用户打开了零前缀视图，但在其中没有选择结果的情况下关闭了它。此标量在 Firefox 110.0 中引入，请参阅 错误 1806765。

urlbar.zeroprefix.engagement

一个无符号整数，记录在零前缀视图中参与的次数。“零前缀”表示搜索字符串为空，因此零前缀视图是在用户在输入搜索字符串之前点击 URL 地址栏时显示的视图。通常称为“热门网站”视图，因为它通常显示用户的热门网站。“参与”表示用户在视图中选择了一个结果。此标量在 Firefox 110.0 中引入，请参阅 错误 1806765。

urlbar.zeroprefix.exposure

一个无符号整数，记录用户接触零前缀视图的次数；也就是说，它显示的次数。“零前缀”表示搜索字符串为空，因此零前缀视图是在用户在输入搜索字符串之前点击 URL 地址栏时显示的视图。通常称为“热门网站”视图，因为它通常显示用户的热门网站。此标量在 Firefox 110.0 中引入，请参阅 错误 1806765。

urlbar.quickaction.impression

一个无符号整数，记录用户显示快速操作的次数，键采用 $key-$n 的形式，其中 $n 是用户为了显示建议而输入的字符数。请参阅 错误 1806024。

urlbar.quickaction.picked

一个无符号整数，记录用户选择快速操作的次数，键采用 $key-$n 的形式，其中 $n 是用户为了显示建议而输入的字符数。请参阅 错误 1783155。

places.*

这是与位置相关的遥测数据。

有效结果类型为

  • sponsored_visit_no_triggering_url 无法在历史记录中找到其触发 URL 的赞助访问次数。我们预计这只是一个很小的数字，仅仅是因为导航层操纵了 URL。较大的或不断增长的值可能是一个问题。

  • pages_need_frecency_recalculation 需要重新计算频率的页面数。与数据库中的页面总数相比，此数字应保持较小（请参阅 PLACES_PAGES_COUNT 直方图）。出于性能原因，它可用于评估重新计算的频率和大小。

搜索参与遥测

从 Firefox 110 开始提供的搜索参与遥测数据是使用 Glean 事件记录的。由于数据量较大，这些事件仅针对一部分用户收集，使用 Glean 采样功能。请参阅以下文档以了解详细信息。

  • 参与：它被定义为 URL 地址栏中完成的操作，用户在其中选择了一个结果。

  • 放弃：它被定义为用户打开结果但未完成参与操作的操作，通常是取消 URL 地址栏焦点。如果结果弹出窗口正在打开，用户切换到另一个窗口也会发生这种情况。

变更日志
Firefox 128

“actions” 键已添加到参与事件中。[错误 1893067]

Firefox 125

“impression” 参与事件已被移除。[错误 1878983]

上下文服务的自定义 Ping

上下文服务目前有两个涉及地址栏、热门网站和 Firefox Suggest 的功能。热门网站遥测数据发送到 “top-sites” Ping，这在链接的 Glean 词典页面中进行了描述。对于 Firefox Suggest，请参阅 Firefox Suggest 遥测数据 文档。

变更日志
Firefox 122.0

PingCentre 发送的自定义 Ping 已移除。[错误 1868580]

Firefox 116.0

“top-sites” Ping 已实现。[错误 1836283]

其他与地址栏相关的遥测数据

搜索遥测数据

一些 搜索遥测数据 也与地址栏相关。

contextual.services.topsites.*

这些键控标量用于记录 URL 地址栏中赞助热门网站的展示次数和点击次数。键是热门网站链接的来源和位置（基于 1）的组合，例如“urlbar_1”。对于每个键，它都会记录展示次数或点击次数的计数器。请注意，这些标量与新标签页上的热门网站共享。

遥测环境

以下与地址栏相关的首选项记录在 遥测环境数据 中

  • browser.search.suggest.enabled：Firefox 中所有位置（搜索栏、URL 地址栏等）搜索建议的全局切换。默认为 true。

  • browser.urlbar.autoFill：URL 地址栏中是否启用自动填充的全局首选项。如果为 false，则禁用所有类型的自动填充。

  • browser.urlbar.autoFill.adaptiveHistory.enabled：如果 URL 地址栏中启用了自适应历史记录自动填充，则为 true。

  • browser.urlbar.suggest.searches：如果 URL 地址栏中启用了搜索建议，则为 true。默认为 false。

Firefox Suggest

特定于 Firefox Suggest 的遥测数据在 Firefox Suggest 遥测数据 文档中进行了描述。