blob: d23473bddc5d61321460cfbdb37a215ca5fd64c7 [file] [log] [blame]
<!--
Copyright 2020 The Chromium Authors. All rights reserved.
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file.
-->
<!--
This file is used to generate a comprehensive list of Mobile histograms
along with a detailed description for each histogram.
For best practices on writing histogram descriptions, see
https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md
Please follow the instructions in the OWNERS file in this directory to find a
reviewer. If no OWNERS file exists, please consider signing up at
go/reviewing-metrics (Googlers only), as all subdirectories are expected to
have an OWNERS file. As a last resort you can send the CL to
chromium-metrics-reviews@google.com.
-->
<histogram-configuration>
<histograms>
<variants name="MobileFreInflationSpeedComparison">
<variant name=".FasterThanInflation"
summary="This histogram reports just those timings that were faster
than inflation."/>
<variant name=".SlowerThanInflation"
summary="This histogram reports just those timings that were slower
than inflation."/>
</variants>
<histogram name="Mobile.AppMenu.HighlightMenuItem.Clicked"
enum="AppMenuHighlightItem" expires_after="2021-09-19">
<owner>shaktisahu@chromium.org</owner>
<owner>twellington@chromium.org</owner>
<summary>
Records which menu item was clicked when a user clicks on a menu item from
the app menu that was highlighted. Android only.
</summary>
</histogram>
<histogram name="Mobile.AppMenu.HighlightMenuItem.Shown"
enum="AppMenuHighlightItem" expires_after="2021-09-19">
<owner>shaktisahu@chromium.org</owner>
<owner>twellington@chromium.org</owner>
<summary>
Records which menu item was highlighted when the app menu was opened by the
user. Android only.
</summary>
</histogram>
<histogram name="Mobile.AppMenu.SimilarSelection"
enum="AppMenuSimilarSelectionType" expires_after="M95">
<obsolete>
Deprecated as of 03/2021.
</obsolete>
<owner>gangwu@chromium.org</owner>
<owner>twellington@chromium.org</owner>
<summary>
Android: This metrics is recorded when users made similar selections on app
menu within a period of time. ex. a user selected downloading the current
page. After 5 seconds, the user opened the app menu again and selected
download manager. In this case, we would consider that Download and Download
Manager are similar selections.
</summary>
</histogram>
<histogram name="Mobile.AppMenu.TimeToTakeAction.Abandoned" units="ms"
expires_after="2022-06-26">
<owner>gangwu@chromium.org</owner>
<owner>twellington@chromium.org</owner>
<summary>
The time it takes for the user to abandon the app menu after it's shown by
pressing back or touching outside the menu. This is only logged if the menu
is abandoned. See Mobile.AppMenu.TimeToTakeAction.SelectedItem for the cases
where it is closed as a result of user interaction with the menu. Android
only.
</summary>
</histogram>
<histogram name="Mobile.AppMenu.TimeToTakeAction.SelectedItem" units="ms"
expires_after="2022-07-03">
<owner>gangwu@chromium.org</owner>
<owner>twellington@chromium.org</owner>
<summary>
The time it takes for the user to select an item. This is only logged if the
menu is closed as a result of the user clicking a menu item. See
Mobile.AppMenu.TimeToTakeAction.Abandoned for the cases where it is
abandoned by the user. Android only.
</summary>
</histogram>
<histogram name="Mobile.CanonicalURLResult" enum="CanonicalURLResult"
expires_after="M102">
<owner>pkl@chromium.org</owner>
<owner>sebsg@chromium.org</owner>
<owner>tedchoc@chromium.org</owner>
<summary>
The result of the operation to retrieve the page's canonical URL.
</summary>
</histogram>
<histogram name="Mobile.ContextMenu.EntryPoints" enum="IOSMenuScenario"
expires_after="2022-06-01">
<owner>seblalancette@chromium.org</owner>
<owner>gambard@chromium.org</owner>
<summary>
Tracks which context menu was shown. To drill down into a specific context
menu's usage, take a look at its actions' histogram (the format for actions
histograms is Mobile.ContextMenu.*.Actions). Currently only on iOS.
</summary>
</histogram>
<histogram name="Mobile.ContextMenu.{EntryPoint}.Actions" enum="IOSMenuAction"
expires_after="2022-06-01">
<owner>seblalancette@chromium.org</owner>
<owner>gambard@chromium.org</owner>
<summary>
Tracks which action was selected in the context menu shown for a
{EntryPoint}. To view how often this context menu was shown, take a look at
this other histogram: Mobile.ContextMenu.EntryPoints. Currently only on iOS.
</summary>
<token key="EntryPoint">
<variant name="BookmarkEntry" summary="Bookmark entry"/>
<variant name="BookmarkFolder" summary="Bookmark folder"/>
<variant name="HistoryEntry" summary="History entry"/>
<variant name="MostVisitedEntry" summary="Most Visited entry"/>
<variant name="ReadingListEntry" summary="Reading List entry"/>
<variant name="RecentTabsEntry" summary="Recent Tabs entry"/>
<variant name="RecentTabsHeader" summary="Recent Tabs header/device"/>
<variant name="TabGrid" summary="Tab Grid Entry"/>
<variant name="TabGridAddTo" summary="Tab Grid Add To"/>
<variant name="WebImage" summary="Image on a Web page"/>
<variant name="WebImageLink" summary="Image-Link on a Web page"/>
<variant name="WebLink" summary="Link on a Web page"/>
</token>
</histogram>
<histogram base="true" name="Mobile.DefaultBrowser.BrowserCount" units="units"
expires_after="never">
<!-- Name completed by histogram_suffixes name="Mobile.DefaultBrowser.Type" -->
<!-- expires-never: Used to keep track of Android browser ecosystem. -->
<owner>dtrainor@chromium.org</owner>
<owner>nyquist@chromium.org</owner>
<summary>
Android: The number of browsers installed on the device. Logged when a new
session is started.
</summary>
</histogram>
<histogram name="Mobile.DefaultBrowser.State" enum="MobileDefaultBrowserState"
expires_after="never">
<!-- expires-never: Used to keep track of Android browser ecosystem. -->
<owner>dtrainor@chromium.org</owner>
<owner>nyquist@chromium.org</owner>
<summary>
Android: Whether or not the device has a default browser and whether or not
it is a system installed browser. Logged when a new session is started.
</summary>
</histogram>
<histogram base="true" name="Mobile.DefaultBrowser.SystemBrowserCount"
units="units" expires_after="never">
<!-- Name completed by histogram_suffixes
name="Mobile.DefaultBrowser.SystemDefaultBrowser.Type" -->
<!-- expires-never: Used to keep track of Android browser ecosystem. -->
<owner>dtrainor@chromium.org</owner>
<owner>nyquist@chromium.org</owner>
<summary>
Android: The number of system installed browsers. Logged when a new session
is started.
</summary>
</histogram>
<histogram name="Mobile.Legacy.Translate.Toggle.Delay" units="ms"
expires_after="2020-12-13">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Records the time between tapping the target and source language in a legacy
infobar. If only one of either is tapped, nothing is logged.
</summary>
</histogram>
<histogram name="Mobile.Legacy.Translate.Unused.Duration" units="ms"
expires_after="2020-10-11">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Records the time an unused legacy infobar persists on screen. This is logged
when the infobar is closed.
</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Badge.Tapped"
enum="MobileMessagesBadgeState" expires_after="2022-05-23">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records the state of a badge when it was tapped.</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Banner.Dismiss"
enum="MobileMessagesBannerDismissType" expires_after="2022-05-23">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records the reason why a Banner was dismissed.</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Banner.Event"
enum="MobileMessagesBannerEvent" expires_after="2022-05-27">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records Infobar Banner events.</summary>
</histogram>
<histogram name="Mobile.Messages.Banner.OnScreenTime" units="ms"
expires_after="2022-05-11">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@google.com</owner>
<summary>
Records the time an Infobar (Messages) Banner is visible on screen. Used to
know how long it takes a user to act on the banner before it gets
auto-dismissed.
</summary>
</histogram>
<histogram name="Mobile.Messages.ConcurrentPresented" units="infobars"
expires_after="2022-03-20">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Tracks the number of multiple Infobars being presented at the same time.
This will be recorded everytime an Infobar is presented.
</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Confirm.Accept.Time" units="ms"
expires_after="2022-07-27">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Confirm.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Records the time between the Infobar Delegate is created, and the user
accepts a Confirm Infobar action.
</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Confirm.Event"
enum="MobileMessagesConfirmInfobarEvents" expires_after="2022-07-27">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Confirm.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Records the events related to Confirm Infobars (e.g. Presented, Accepted,
Dismissed,etc.)
</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Modal.Event"
enum="MobileMessagesModalEvent" expires_after="2022-05-22">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records generic Infobar Modal events.</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.OverflowRow.Tapped"
enum="MobileMessagesInfobarType" expires_after="2022-03-20">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records a tap on an Infobar overflow menu row.</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Passwords.Modal.Dismiss"
enum="MobileMessagesPasswordsModalDismiss" expires_after="2022-07-03">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Password.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records the reason why a Password Modal was dismissed.</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Passwords.Modal.Event"
enum="MobileMessagesPasswordsModalEvent" expires_after="2022-05-22">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Password.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records Password specific Infobar Modal events.</summary>
</histogram>
<histogram base="true" name="Mobile.Messages.Passwords.Modal.Present"
enum="MobileMessagesPasswordsModalPresent" expires_after="2022-03-20">
<!-- Name completed by histogram_suffixes name="Mobile.Messages.Password.Type" -->
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records the context when a Password Modal was presented.</summary>
</histogram>
<histogram name="Mobile.Messages.Save.Card.Modal.Event"
enum="MobileMessagesSaveCardModalEvent" expires_after="2022-06-26">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>Records Save Card specific Infobar Modal events.</summary>
</histogram>
<histogram name="Mobile.Messages.Translate.Banner.Event"
enum="MobileMessagesTranslateBannerEvent" expires_after="2022-03-20">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Records the context when an iOS user taps on a Translate Banner Action
Button.
</summary>
</histogram>
<histogram name="Mobile.Messages.Translate.Modal.Event"
enum="MobileMessagesTranslateModalEvent" expires_after="2022-06-05">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Records when an iOS user initiates an Translate specific Infobar Modal
event.
</summary>
</histogram>
<histogram name="Mobile.Messages.Translate.Modal.Present"
enum="MobileMessagesTranslateModalPresent" expires_after="2022-03-20">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Records the context when an iOS user initiates a Translate Modal
presentation.
</summary>
</histogram>
<histogram name="Mobile.RecentTabsManager.TotalTabsFromOtherDevicesOpenAll"
units="count" expires_after="2022-04-19">
<owner>sczs@chromium.org</owner>
<owner>edchin@chromium.org</owner>
<summary>
Records the total number of tabs opened when Open all was selected from
other devices in Recent Tabs.
</summary>
</histogram>
<histogram name="Mobile.Share.EntryPoints" enum="IOSActivityScenario"
expires_after="2022-06-01">
<owner>seblalancette@chromium.org</owner>
<owner>chrome-sharing-core@google.com</owner>
<summary>
Tracks which sharing entry point was triggered. To view the outcome of these
sharing scenarios, take a look at their actions' histogram (the format is
Mobile.Share.*.Actions). Currently only on iOS.
</summary>
</histogram>
<histogram name="Mobile.Share.{EntryPoint}.Actions" enum="IOSShareAction"
expires_after="2022-06-01">
<owner>seblalancette@chromium.org</owner>
<owner>chrome-sharing-core@google.com</owner>
<summary>
Tracks the sharing actions executed when the sharing scenario was initiated
for a {EntryPoint}. To view how often this sharing scenario was triggered,
take a look at: Mobile.Share.EntryPoints. Currently only on iOS.
</summary>
<token key="EntryPoint">
<variant name="BookmarkEntry" summary="Bookmark entry"/>
<variant name="HistoryEntry" summary="History entry"/>
<variant name="MostVisitedEntry" summary="Most Visited entry"/>
<variant name="QRCodeImage" summary="QR code image"/>
<variant name="ReadingListEntry" summary="Reading List entry"/>
<variant name="RecentTabsEntry" summary="Recent Tabs entry"/>
<variant name="SharedHighlight" summary="highlighted fragment"/>
<variant name="TabGridItem" summary="tab grid item"/>
<variant name="TabGridSelectionMode" summary="tab grid selection mode"/>
<variant name="TabShareButton" summary="current tab"/>
</token>
</histogram>
<histogram name="Mobile.SystemNotification.Action.Click"
enum="SystemNotificationActionType" expires_after="never">
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>dtrainor@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Records which Android notifications users interact with. Recorded when an
user taps the button in a notification, for any Chrome-generated
notification on Android that includes a button tap-target.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.Action.Click.Age" units="minutes"
expires_after="never">
<!-- Name completed by histogram_suffixes
name="SystemNotificationAgeType" -->
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>dtrainor@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Records the duration in minutes from the time when the system notification
is shown to the time that the user clicked on an action button on the
Android notification.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.Blocked"
enum="SystemNotificationType" expires_after="never">
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>dtrainor@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Android: Represents the number of system notifications that were blocked and
could not be shown by type.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.BlockedAfterShown"
enum="SystemNotificationType" expires_after="never">
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>dtrainor@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Android: Represents the type of notification that was last shown before the
user disabled notification permissions on Chrome. This is only logged the
first time we attempt to show a notification and fail.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.ChannelBlocked"
enum="SystemNotificationType" expires_after="never">
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>peter@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Android: Represents the number of system notifications by type that we
attempted to show but were blocked, due to their notification channel being
blocked. Only applies to devices on Android O and above.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.Content.Click"
enum="SystemNotificationType" expires_after="never">
<!-- expires-never: part of top-line metric (internal: go/chrome-browser-nsm) -->
<owner>xingliu@chromium.org</owner>
<owner>chrome-analysis-team@google.com</owner>
<summary>
Records the type of notification when the user clicks the body of Android
notification. This does not include clicks on notification action buttons.
This histogram is of special interest to the chrome-analysis-team@. Do not
change its semantics or retire it without talking to them first.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.Content.Click.Age" units="minutes"
expires_after="never">
<!-- Name completed by histogram_suffixes
name="SystemNotificationAgeType" -->
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>dtrainor@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Records the duration in minutes from the time when the system notification
is shown to the time that the user clicked the notification on Android.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.Dismiss"
enum="SystemNotificationType" expires_after="never">
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>dtrainor@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Records the type of notification when the user dismisses the Android
notification.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.Dismiss.Age" units="minutes"
expires_after="never">
<!-- Name completed by histogram_suffixes
name="SystemNotificationAgeType" -->
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>dtrainor@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Records the duration in minutes from the time when the system notification
is shown to the time that the user dismissed the notification on Android.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.NotifyFailure"
enum="SystemNotificationType" expires_after="2021-10-31">
<obsolete>
Deprecated 10/2021
</obsolete>
<owner>knollr@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Android: Represents the number of system notifications failed to be notified
by Android NotificationManager API. Recorded when the notification is shown
on Android.
</summary>
</histogram>
<histogram name="Mobile.SystemNotification.Shown" enum="SystemNotificationType"
expires_after="never">
<!-- expires-never: Core Android notification metrics. Used by multiple teams. -->
<owner>dtrainor@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Android: Represents the number of system notifications that will be
successfully shown to the user by type.
</summary>
</histogram>
<histogram name="Mobile.Translate.Unused.Count" units="units"
expires_after="2022-03-20">
<owner>sczs@chromium.org</owner>
<owner>thegreenfrog@chromium.org</owner>
<summary>
Records a histogram for an infobar (both legacy and Messages) that the user
did not interact with throughout its lifetime.
</summary>
</histogram>
<histogram name="MobileDownload.Background"
enum="MobileDownloadBackgroundDownloadEvent" expires_after="2020-10-11">
<obsolete>
Removed 2020-10.
</obsolete>
<owner>hnakashima@chromium.org</owner>
<owner>hanxi@chromium.org</owner>
<owner>yfriedman@chromium.org</owner>
<summary>
Android: Records events for downloads started from the background, that is,
while the browser process is not running. Used to measure completion rate of
these downloads.
</summary>
</histogram>
<histogram name="MobileDownload.Background.TargetDeterminationResult"
enum="MobileDownloadBackgroundTargetDeterminationResult"
expires_after="2020-12-13">
<owner>qinmin@chromium.org</owner>
<owner>xingliu@chromium.org</owner>
<summary>
Android: Records the target determination result for downloads started in
the background, that is, while the browser process is not running.
</summary>
</histogram>
<histogram name="MobileDownload.ContextMenu.SaveImage"
enum="ContextMenuSaveImage" expires_after="M85">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records various counts related to the save image context menu
option.
</summary>
</histogram>
<histogram name="MobileDownload.DownloadLaterPromptStatus"
enum="DownloadLaterPromptStatus" expires_after="2022-02-06">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>
Android: Records whether download later dialog will be shown to the user.
Recorded when the download later preference is initialized in native.
</summary>
</histogram>
<histogram name="MobileDownload.DownloadPromptStatus"
enum="DownloadPromptStatus" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>
Android: Records whether download dialog will be shown to the user. Recorded
when the download preference is initialized in native.
</summary>
</histogram>
<histogram name="MobileDownload.Location.Dialog.DirectoryType"
enum="DownloadLocationDirectoryType" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>
Records the directory type when the user selects the download directory
through download location dialog. May be recorded even when the user didn't
download anything.
</summary>
</histogram>
<histogram name="MobileDownload.Location.Dialog.Result"
enum="DownloadLocationDialogResult" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>
Records whether the user accepted or dismissed the dialog to select a
download location.
</summary>
</histogram>
<histogram name="MobileDownload.Location.Dialog.Suggestion.Events"
enum="DownloadLocationSuggestionEvent" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>Records the download location suggestion event.</summary>
</histogram>
<histogram name="MobileDownload.Location.Dialog.SuggestionSelected"
enum="BooleanSelected" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>Records the download location suggestion choice.</summary>
</histogram>
<histogram name="MobileDownload.Location.Dialog.Type"
enum="DownloadLocationDialogType" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>
Records the download location dialog type when the dialog is shown to the
user.
</summary>
</histogram>
<histogram name="MobileDownload.Location.DirectoryType"
enum="DownloadLocationDirectoryType" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>dtrainor@chromium.org</owner>
<owner>qinmin@chromium.org</owner>
<summary>
Records the directory type shown when a user opens download location dialog
or download location setting. This is recorded when the directory provider
generates a list of available directories.
</summary>
</histogram>
<histogram name="MobileDownload.Location.Download.DirectoryType"
enum="DownloadLocationDirectoryType" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>Records the directory type when download is completed.</summary>
</histogram>
<histogram name="MobileDownload.Location.Setting.DirectoryType"
enum="DownloadLocationDirectoryType" expires_after="2022-02-16">
<owner>xingliu@chromium.org</owner>
<owner>clank-downloads@google.com</owner>
<summary>
Records the directory type when the user selects the download directory
through download preference. May be recorded even when the user didn't
download anything.
</summary>
</histogram>
<histogram base="true" name="MobileDownload.ResumptionsCount" units="units"
expires_after="2020-04-05">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records the number of resumptions for a download by resumption
type. For all resumption types, this is recorded when a download is
finished, completed or cancelled. For automatic resumptions, it is also
recorded when user manually resumes the download to clear the auto retry
count.
</summary>
</histogram>
<histogram name="MobileDownload.StoragePermission"
enum="MobileDownloadStoragePermission" expires_after="M82">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records various counts when requesting the storage permission.
</summary>
</histogram>
<histogram
name="MobileFre.CctTos.EnterprisePolicyCheckSpeed2{MobileFreInflationSpeedComparison}"
units="ms" expires_after="2022-05-01">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Records the time it takes from ToS fragment attached to the
activity to the enterprise policy check completing. This check is often
skipped when its result becomes irrelevant.
{MobileFreInflationSpeedComparison}
</summary>
<token key="MobileFreInflationSpeedComparison"
variants="MobileFreInflationSpeedComparison"/>
</histogram>
<histogram
name="MobileFre.CctTos.EnterprisePolicyCheckSpeed{MobileFreInflationSpeedComparison}"
units="ms" expires_after="2022-05-01">
<obsolete>
Deprecated and replaced with MobileFre.CctTos.EnterprisePolicyCheckSpeed2.*.
as of 11/2020. The starting time of this metrics is changed to when the
fragment attached to the FirstRunActivity.
</obsolete>
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Records the time it takes from object initialization to the
enterprise policy check completing. This check is often skipped when its
result becomes irrelevant. Histogram has suffixes depending if the timing
was faster or slower than inflation.
</summary>
<token key="MobileFreInflationSpeedComparison"
variants="MobileFreInflationSpeedComparison"/>
</histogram>
<histogram
name="MobileFre.CctTos.IsDeviceOwnedCheckSpeed2{MobileFreInflationSpeedComparison}"
units="ms" expires_after="2022-05-01">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Records the time it takes from ToS fragment attached to the
activity to the device ownership check completing.
{MobileFreInflationSpeedComparison}
</summary>
<token key="MobileFreInflationSpeedComparison"
variants="MobileFreInflationSpeedComparison"/>
</histogram>
<histogram
name="MobileFre.CctTos.IsDeviceOwnedCheckSpeed{MobileFreInflationSpeedComparison}"
units="ms" expires_after="2022-05-01">
<obsolete>
Deprecated and replaced with MobileFre.CctTos.IsDeviceOwnedCheckSpeed2.*. as
of 11/2020. The starting time of this metrics is changed to when the
fragment attached to the FirstRunActivity.
</obsolete>
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Records the time it takes from object initialization to the device
ownership check completing. Histogram has suffixes depending if the timing
was faster or slower than inflation.
</summary>
<token key="MobileFreInflationSpeedComparison"
variants="MobileFreInflationSpeedComparison"/>
</histogram>
<histogram name="MobileFre.CctTos.LoadingDuration" units="ms"
expires_after="2022-05-01">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Records how long it takes to load the enterprise CCT/ToS fragment.
</summary>
</histogram>
<histogram name="MobileFre.ChildAccountStatusDuration" units="ms"
expires_after="2022-06-12">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: The amount of time spent fetching child account status during the
FRE. Not applicable for light weight FRE.
</summary>
</histogram>
<histogram base="true" name="MobileFre.FragmentInflationSpeed" units="ms"
expires_after="2022-06-26">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Enterprise FRE cannot fully show the first page until the
appRestrictions call returns. This suffixed histogram measures when fragment
inflation was slower or faster than the appRestrictions call, and wether the
UI had to wait. Note this is recorded for all clients, not just enterprise.
Not applicable for light weight FRE.
</summary>
</histogram>
<histogram base="true" name="MobileFre.FromLaunch" units="ms"
expires_after="2022-06-19">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: This suffixed histogram represents the amount of time from when the
FRE intent was initially constructed, until some event in the future occurs.
Not applicable for light weight FRE.
</summary>
</histogram>
<histogram
name="MobileFre.Lightweight.EnterprisePolicyCheckSpeed{MobileFreInflationSpeedComparison}"
units="ms" expires_after="2022-05-01">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Records the time it takes from Lightweight FRE launch to the
enterprise policy check completing. This check is often skipped when its
result becomes irrelevant. {MobileFreInflationSpeedComparison}
</summary>
<token key="MobileFreInflationSpeedComparison"
variants="MobileFreInflationSpeedComparison"/>
</histogram>
<histogram
name="MobileFre.Lightweight.IsDeviceOwnedCheckSpeed{MobileFreInflationSpeedComparison}"
units="ms" expires_after="2022-05-01">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Records the time it takes from from Lightweight FRE launch to the
device ownership check completing. This check is often skipped when its
result becomes irrelevant. {MobileFreInflationSpeedComparison}
</summary>
<token key="MobileFreInflationSpeedComparison"
variants="MobileFreInflationSpeedComparison"/>
</histogram>
<histogram name="MobileFre.Lightweight.LoadingDuration" units="ms"
expires_after="2022-05-01">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: Records how long it takes waiting from the dialog for Lightweight
FRE created to content fully loaded - either ToS is shown or FRE is skipped.
</summary>
</histogram>
<histogram name="MobileFre.NativeInitialized" units="ms"
expires_after="2022-06-12">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: The amount of time spent between FRE started and native
initialization. Recorded when native is fully initialized.
</summary>
</histogram>
<histogram name="MobileFre.PolicyServiceInitDelayAfterNative{PolicyPresence}"
units="ms" expires_after="2022-05-01">
<obsolete>
Replaced by MobileFre.PolicyServiceInitDelayAfterNative.*2 due to bug fix as
of 05/2021. See https://crbug.com/1208942.
</obsolete>
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: The amount of time spent between native initialized and the
decision &quot;whether we need to wait to load policy service from
native&quot; has been made. The decision is made when no on-device policy is
found, or policy service is fully initialized. If the decision has been made
before native initialization, SystemClock#elapsedRealTime was recorded, in
which does not provide much useful information. Recorded during FRE only,
when on-device policy is {PolicyPresence}
</summary>
<token key="PolicyPresence">
<variant name=".WithoutPolicy" summary="not presented."/>
<variant name=".WithPolicy" summary="presented."/>
</token>
</histogram>
<histogram name="MobileFre.PolicyServiceInitDelayAfterNative{PolicyPresence}2"
units="ms" expires_after="2022-05-01">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: The amount of time spent between native initialized and the
decision &quot;whether we need to wait to load policy service from
native&quot; has been made. The decision is made when no on-device policy is
found, or policy service is fully initialized. If the decision has been made
before native initialization, it will not be recorded. Recorded during FRE
only, when on-device policy is {PolicyPresence}
</summary>
<token key="PolicyPresence">
<variant name=".WithoutPolicy" summary="not presented."/>
<variant name=".WithPolicy" summary="presented."/>
</token>
</histogram>
<histogram name="MobileFre.Progress" enum="MobileFreProgress"
expires_after="2022-07-03">
<owner>bsazonov@chromium.org</owner>
<owner>msarda@chromium.org</owner>
<owner>droger@chromium.org</owner>
<owner>gogerald@chromium.org</owner>
<owner>chrome-signin-team@google.com</owner>
<summary>
Android: Records which states of the &quot;first run experience&quot; have
been reached. Each bucket represents a state and recorded everytime the
state changed. Pages can be double counted if the user goes backwards in the
flow.
</summary>
</histogram>
<histogram name="MobileFre.SignInChoice" enum="MobileFreSignInChoice"
expires_after="M82">
<owner>aruslan@chromium.org</owner>
<summary>
Android: How the user left the sign-in part of the &quot;first run
experience&quot; activity (M-38+).
</summary>
</histogram>
<histogram name="MobileFre.TosFragment.SpinnerVisibleDuration" units="ms"
expires_after="2022-02-06">
<owner>skym@chromium.org</owner>
<owner>wenyufu@chromium.org</owner>
<summary>
Android: The amount of time that the small spinner, which become visible
after the ToS is accepted, is showing on screen.
</summary>
</histogram>
<histogram name="MobileFullscreenVideo.DurationAfterPotraitRotation" units="ms"
expires_after="M85">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records the duration that a fullscreen video is played after device
rotates from portrait to landscape mode for the first time, and before it
exits fullscreen. If there is no device rotation or if the video starts with
landscape mode, it is not recorded. If there are mutiple rotations between
portrait and landscape mode, only one record is emitted and it is equal to
the time period from the first rotation to the moment when the video exits
fullscreen.
</summary>
</histogram>
<histogram name="MobileFullscreenVideo.LandscapeDuration" units="ms"
expires_after="M85">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records the duration that a fullscreen video is played in landscape
mode. If a video starts playing in landscape mode, and then it is switched
back and forth between landscape and portrait mode, only the time period
before the first switch is accounted. If a video starts playing in portrait
mode, it is not recorded.
</summary>
</histogram>
<histogram name="MobileFullscreenVideo.LandscapeRotation" enum="BooleanEnabled"
expires_after="M85">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records whether a fullscreen video is switched from landscape to
portrait mode at any point during playback.
</summary>
</histogram>
<histogram name="MobileFullscreenVideo.OrientationPortrait"
enum="BooleanEnabled" expires_after="M85">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records the device orientation when a video enters fullscreen. The
value is true if device orientation is portrait, or false otherwise. The
video doesn't necessarily needs to be in a playing state.
</summary>
</histogram>
<histogram name="MobileFullscreenVideo.PortraitDuration" units="ms"
expires_after="M85">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records the duration that a fullscreen video is played in portrait
mode. If a video starts playing in portrait mode, and then it is switched
back and forth between landscape and portrait mode, only the time period
before the first switch is accounted. If a video starts playing in landscape
mode, it is not recorded.
</summary>
</histogram>
<histogram name="MobileFullscreenVideo.PortraitRotation" enum="BooleanEnabled"
expires_after="M85">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records whether a fullscreen video is switched from portrait to
landscape mode at any point during playback.
</summary>
</histogram>
<histogram name="MobileFullscreenVideo.VideoPortrait" enum="BooleanEnabled"
expires_after="M85">
<owner>qinmin@chromium.org</owner>
<summary>
Android: Records whether a video has a larger height than width when it
enters the fullscreen mode.
</summary>
</histogram>
<histogram name="MobileIntent.FirstPartyToInternalScheme" enum="Boolean"
expires_after="2022-06-26">
<owner>peconn@chromium.org</owner>
<owner>peter@chromium.org</owner>
<summary>
Recorded when Chrome on Android is launched to an internal Chrome scheme
(chrome://, chrome-native://, about://) by a first party app (not Chrome).
This metric is to be used to determine whether any first party app uses the
feature, and whether we can remove it.
</summary>
</histogram>
<histogram name="MobileIntent.PageLoadDueToExternalApp" enum="ClientAppId"
expires_after="never">
<!-- expires-never: Navigation (external-apps) heartbeat metric for Android. -->
<owner>tedchoc@chromium.org</owner>
<summary>
Android: Count of page loads started by intents from external apps. In M87
the reporting of this histogram was updated to exclude intents sent from
Chrome itself.
</summary>
</histogram>
<histogram name="MobileOmnibox.LongPressPasteAge" units="ms"
expires_after="2021-04-18">
<owner>gangwu@chromium.org</owner>
<owner>jdonnelly@chromium.org</owner>
<summary>
Recorded when user long presses and pastes clipboard content into omnibox.
The value indicates the estimated age of the clipboard.
Intended to be compared to Omnibox.ClipboardSuggestionShownAge.
</summary>
</histogram>
<histogram name="MobileOmnibox.PopupOpenDuration" units="ms"
expires_after="2022-02-02">
<owner>stkhapugin@chromium.org</owner>
<owner>mpearson@chromium.org</owner>
<owner>jdonnelly@chromium.org</owner>
<summary>
Recorded when the omnibox popup is closed. Indicates the duration it was
open.
</summary>
</histogram>
<histogram name="MobileOmnibox.PressedClipboardSuggestionAge" units="ms"
expires_after="2022-06-05">
<owner>jdonnelly@chromium.org</owner>
<owner>mpearson@chromium.org</owner>
<summary>
When a user presses an omnibox suggestion based on the content of the
clipboard, this histograms records how long ago Chrome detected a change in
the clipboard.
Intended to be compared to Omnibox.ClipboardSuggestionShownAge.
If Chrome never detected a change to the clipboard, no clipboard suggestion
is shown, meaning this histogram will never be emitted to.
</summary>
</histogram>
<histogram name="MobileSignInPromo.BookmarkManager.ImpressionsTilDismiss"
units="impressions" expires_after="2022-06-05">
<owner>jlebel@chromium.org</owner>
<owner>chrome-signin-team@google.com</owner>
<summary>
Counts how many times the signin promo is implicitly dismissed (by closing
the bookmark manager) per impression.
</summary>
</histogram>
<histogram name="MobileSignInPromo.BookmarkManager.ImpressionsTilSigninButtons"
units="impressions" expires_after="2022-06-05">
<owner>jlebel@chromium.org</owner>
<owner>chrome-signin-team@google.com</owner>
<summary>
Counts how many times one of the &quot;sign in&quot; buttons (any of the
signed-out &quot;Sign in to Chrome&quot; button, the &quot;Continue as
|name|&quot; button, or the &quot;Not |email|?&quot; button) is clicked per
impression.
</summary>
</histogram>
<histogram name="MobileSignInPromo.BookmarkManager.ImpressionsTilXButton"
units="impressions" expires_after="2022-06-05">
<owner>jlebel@chromium.org</owner>
<owner>chrome-signin-team@google.com</owner>
<summary>
Counts how many times the explicit &quot;X&quot;-to-close button is clicked
per impression.
</summary>
</histogram>
<histogram name="MobileSignInPromo.NTPContentSuggestions.ImpressionsTilXButton"
units="impressions" expires_after="2022-06-05">
<owner>bsazonov@chromium.org</owner>
<owner>chrome-signin-team@google.com</owner>
<summary>
Counts how many times the explicit &quot;X&quot;-to-close button is clicked
per impression. Recorded when the signin promo is dismissed using the
&quot;X&quot;.
</summary>
</histogram>
<histogram name="MobileSignInPromo.SettingsManager.ImpressionsTilDismiss"
units="impressions" expires_after="2022-06-05">
<owner>jlebel@chromium.org</owner>
<owner>chrome-signin-team@google.com</owner>
<summary>
Counts how many times the signin promo is implicitly dismissed (by closing
the settings view) per impression.
</summary>
</histogram>
<histogram name="MobileSignInPromo.SettingsManager.ImpressionsTilSigninButtons"
units="impressions" expires_after="2022-06-05">
<owner>jlebel@chromium.org</owner>
<owner>chrome-signin-team@google.com</owner>
<summary>
Counts how many times one of the &quot;sign in&quot; buttons (any of the
signed-out &quot;Sign in to Chrome&quot; button, the &quot;Continue as
|name|&quot; button, or the &quot;Not |email|?&quot; button) is clicked per
impression.
</summary>
</histogram>
<histogram name="MobileSignInPromo.SettingsManager.ImpressionsTilXButton"
units="impressions" expires_after="2022-06-05">
<owner>jlebel@chromium.org</owner>
<owner>chrome-signin-team@google.com</owner>
<summary>
Counts how many times the explicit &quot;X&quot;-to-close button is clicked
per impression.
</summary>
</histogram>
<histogram name="MobileStartup.DailyLaunchCount" units="units"
expires_after="2022-06-19">
<owner>tedchoc@chromium.org</owner>
<owner>twellington@chromium.org</owner>
<summary>
Android only.
The number of times the tabbed mode of Chrome is launched within a given 24
hour window. Recall that custom tabs is not considered tabbed mode. A
&quot;launch&quot; here is defined as anytime the tabbed mode is made
visible (foregrounded), but all Chrome activities must be completely hidden
before we'll count an additional launch. It includes all kinds of intents,
such as MAIN and VIEW. By ensuring all Chrome activities are hidden, we
avoid overcounting by going to Settings and returning to Chrome.
This launch definition includes some items one might not expect: (i) click a
link in Chrome that opens in another app, then click back. (ii) have Chrome
in the foreground, then the screen times out (goes blank) or engages the
lock screen, then wake up/unlock the device. (iii) switch to
&quot;Recents&quot;, then re-select Chrome. In all these cases, Chrome has
gone to the background so returning to it counts as another launch.
The value reported reflects activity over a 24-hour window in the past,
possibly the distant past. Reporting is controlled by storing an initial
launch timestamp and counting all &quot;launches&quot; as a count until a
new launch happens after the 24hr window has elapsed (at this point, a new
24hr window is started). The count is reported at the start of the next 24hr
window, so this is a retroactive count. For example, if a user uses Chrome
in one day two months ago, then doesn't use Chrome at all, then when Chrome
launches today it'll report the value during that 24-hour window.
</summary>
</histogram>
<histogram name="MobileStartup.Experimental.LaunchCause" enum="LaunchCause"
expires_after="2022-01-07">
<obsolete>
Removed Experimental label in 02/2021.
</obsolete>
<owner>mthiesse@chromium.org</owner>
<owner>tedchoc@chromium.org</owner>
<owner>yfriedman@chromium.org</owner>
<summary>
Records what caused Chrome to be launched.
Recorded for all types of ChromeActivity, in all cases where Chrome becomes
visible to the user.
</summary>
</histogram>
<histogram name="MobileStartup.IntentToCreationTime" units="ms"
expires_after="2022-07-03">
<owner>tedchoc@chromium.org</owner>
<owner>twellington@chromium.org</owner>
<owner>yfriedman@chromium.org</owner>
<summary>
Android: The time it takes from creating an intent for ChromeActivity to
activity creation. This includes activity creation time spent in the
framework.
</summary>
</histogram>
<histogram name="MobileStartup.LaunchCause" enum="LaunchCause"
expires_after="2022-06-26">
<owner>mthiesse@chromium.org</owner>
<owner>tedchoc@chromium.org</owner>
<owner>yfriedman@chromium.org</owner>
<summary>
Records what caused Chrome to be launched.
Recorded for all types of ChromeActivity, in all cases where Chrome becomes
visible to the user, or intentionally transitions between Chrome Activities.
</summary>
</histogram>
<histogram name="MobileStartup.LaunchType" enum="LaunchType"
expires_after="2022-06-05">
<owner>tedchoc@chromium.org</owner>
<owner>twellington@chromium.org</owner>
<summary>
The type of launching Chrome mobile app, e.g launch by hitting icon.
Only recorded for tabbed mode launches of Chrome. Recall that custom tabs is
not considered tabbed mode.
</summary>
</histogram>
<histogram base="true" name="MobileStartup.ToolbarInflationTime" units="ms"
expires_after="M82">
<owner>pasko@chromium.org</owner>
<summary>
Android: The time spent performing toolbar layout inflation.
</summary>
</histogram>
</histograms>
</histogram-configuration>