遥测

本节介绍了用于衡量浏览器 UI 中与搜索引擎交互的现有遥测探针。

工具包记录了其他与搜索相关的遥测，例如搜索服务遥测和与获取搜索建议相关的遥测。工具包搜索遥测与 Firefox 以及其他工具包使用者相关。有关详细信息，请参阅工具包文档中的遥测。

术语表

SAP

搜索访问点，用户通过 Firefox 的某个访问点使用关联的合作伙伴代码执行的搜索。

SERP

搜索引擎结果页面。

持久化搜索

当用户具有以下偏好设置值时（仅在任何工具栏或溢出面板中都不存在搜索栏时适用）

  • browser.urlbar.showSearchTerms.enabled: true

  • browser.urlbar.showSearchTerms.featureGate: true

并执行以下操作

  • 从地址栏或上下文菜单开始搜索。

  • 加载默认搜索引擎结果页面。

搜索词将保留在地址栏中，导致其进入持久化搜索状态。

定义

自然搜索

用户通过直接访问搜索引擎执行的搜索。

带标签的

指带有关联合作伙伴代码的页面。它可能也可能不是通过 SAP 产生的。

带标签的后续搜索

指带有关联合作伙伴代码并被识别为后续搜索的页面。它可能也可能不是通过 SAP 产生的。

与前端搜索相关的搜索探针

地址栏是搜索不可或缺的一部分，并且拥有其自身的附加遥测。

BrowserSearchTelemetry.sys.mjs

此遥测由BrowserSearchTelemetry.sys.mjs处理。

SEARCH_COUNTS - SAP 使用情况

此直方图跟踪搜索引擎和搜索访问点。它由多个 SAP 增强，包括地址栏。它是一个带键的直方图，键是由搜索引擎名称和 SAP 名称组成的字符串，例如 google.urlbar。对于每个键，它记录使用该引擎和 SAP 进行的搜索次数。SAP 名称可以是

  • alias 这是在地址栏中使用别名（如 @google）时。请注意，别名和关键字之间经常存在混淆，并且它们可能被不恰当地使用：别名指的是搜索引擎，而关键字指的是书签。我们预计在 Firefox 83+ 中此 SAP 没有结果，因为地址栏搜索模式取代了它。

  • abouthome

  • contextmenu

  • newtab

  • searchbar

  • system

  • urlbar 除别名和搜索模式外。

  • urlbar-handoff 从about:newtab搜索时使用。

  • urlbar-persisted 在地址栏处于持久化搜索状态时从地址栏搜索时使用。

  • urlbar-searchmode 地址栏处于搜索模式时使用。

  • webextension

browser.engagement.navigation.*

这些带键的标量通过不同的 SAP 跟踪搜索，例如地址栏由 browser.engagement.navigation.urlbar 跟踪。它计算从指定 SAP 在子会话中触发的加载次数，并按源操作细分。可能的 SAP 为

  • urlbar 除搜索模式外。

  • urlbar_handoff 从about:newtab搜索时使用。

  • urlbar_persisted 在地址栏处于持久化搜索状态时从地址栏搜索时使用。

  • urlbar_searchmode 地址栏处于搜索模式时使用。

  • searchbar

  • about_home

  • about_newtab

  • contextmenu

  • webextension

  • system 指示从命令行进行搜索。

记录的操作可能是

  • search 用于来自 contextmenu、system 和 webextension 的任何搜索。

  • search_alias 对于 urlbar，指示用户通过别名确认了搜索。

  • search_enter 对于 about_home 和 about:newtab，这会计算任何搜索。对于其他 SAP，它跟踪键入然后按 Enter。

  • search_formhistory 对于 urlbar，指示用户选择了表单历史记录结果。

  • search_oneoff 对于 urlbar 或 searchbar，指示用户使用一次性按钮确认了搜索。

  • search_suggestion 对于 urlbar 或 searchbar，指示用户确认了搜索建议。

SearchSERPTelemetry.sys.mjs

此遥测由SearchSERPTelemetry.sys.mjs 和关联的父子 actor处理。

browser.search.content.*

这些带键的标量跟踪 SERP 页面加载次数。

键格式为 <provider>:[tagged|tagged-follow-on|organic]:[<code>|other|none]。尖括号中的值将根据 SERP 页面的 URL 替换为实际值。键格式由以下部分构建

  • <provider> 提供商的名称。这与搜索引擎 ID 无关，因为搜索可能是自然生成的。

  • [tagged|tagged-follow-on|organic] SERP 加载的类型。请参阅上面的定义部分。

  • [<code>|other|none] 与 SERP 加载相关的代码详细信息

    • <code> 在 URL 中找到的合作伙伴代码。这仅适用于与产品关联的合作伙伴。

    • other SERP 加载具有合作伙伴代码，但未被识别为关联合作伙伴或自然代码。

    • none SERP 加载没有合作伙伴代码，或者它是已识别的自然代码，例如，某些网站为搜索分配自己的代码。

它们按已知的源 SAP 分解

  • urlbar 除搜索模式外。

  • urlbar_handoff 从about:newtab搜索时使用。

  • urlbar_persisted 在地址栏处于持久化搜索状态时从地址栏搜索时使用。

  • urlbar_searchmode 地址栏处于搜索模式时使用。

  • searchbar

  • about_home

  • about_newtab

  • contextmenu

  • webextension

  • system 指示从命令行进行搜索。

  • tabhistory 指示搜索被计为用户从标签历史记录中加载的结果。

  • reload 指示搜索被计为重新加载页面的结果。

  • unknown 指示来源未知。

browser.search.withads.*

这些带键的标量跟踪显示广告的 SERP 页面的计数。键格式为 <provider>:<tagged|organic>。

它们按已知的源 SAP 分解，SAP 列表与 browser.search.content.* 相同。

browser.search.adclicks.*

这与 `browser.search.withads.* 相同，但跟踪 SERP 页面上广告点击次数。