2019-03-22 07:05:28 +01:00
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
2019-03-18 21:30:25 +01:00
$schema : moz://mozilla.org/schemas/glean/metrics/1-0-0
2019-03-18 22:32:03 +01:00
events :
app_opened :
type : event
description : >
2019-03-18 22:54:36 +01:00
A user opened the app
2019-03-18 22:32:03 +01:00
extra_keys :
2019-03-22 07:05:28 +01:00
source :
description : "The method used to open Fenix. Possible values are: `app_icon`, `custom_tab` or `link`"
2019-03-18 22:32:03 +01:00
bugs :
2019-03-19 22:58:49 +01:00
- 968
2019-03-18 22:32:03 +01:00
data_reviews :
2019-03-19 22:58:49 +01:00
- https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
2019-03-18 22:32:03 +01:00
notification_emails :
- telemetry-client-dev@mozilla.com
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-22 07:05:28 +01:00
expires : "2020-03-01"
2019-03-18 22:54:36 +01:00
search_bar_tapped :
type : event
description : >
A user tapped the search bar
extra_keys :
2019-03-22 07:05:28 +01:00
source :
description : "The view the user was on when they initiated the search (For example: `Home` or `Browser`)"
2019-03-18 22:54:36 +01:00
bugs :
2019-03-19 22:58:49 +01:00
- 959
2019-03-18 22:54:36 +01:00
data_reviews :
2019-03-19 22:58:49 +01:00
- https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
2019-03-18 22:54:36 +01:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-22 07:05:28 +01:00
expires : "2020-03-01"
2019-03-19 00:09:27 +01:00
entered_url :
type : event
description : >
A user entered a url
extra_keys :
2019-03-22 07:05:28 +01:00
autocomplete :
description : "A boolean that tells us whether the URL was autofilled by an Autocomplete suggestion"
2019-03-19 00:09:27 +01:00
bugs :
2019-03-19 22:58:49 +01:00
- 959
2019-03-19 00:09:27 +01:00
data_reviews :
2019-03-19 22:58:49 +01:00
- https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
2019-03-19 00:09:27 +01:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-22 07:05:28 +01:00
expires : "2020-03-01"
2019-03-19 00:09:27 +01:00
performed_search :
type : event
description : >
A user performed a search
extra_keys :
2019-04-17 01:31:35 +02:00
source :
description : >
A string that tells us how the user performed the search. Possible values are :
2019-05-08 19:15:19 +02:00
* default_action
* default_suggestion
* shortcut_action
* shortcut_suggestion
2019-04-17 01:31:35 +02:00
2019-03-19 00:09:27 +01:00
bugs :
2019-03-19 22:58:49 +01:00
- 959
2019-03-19 00:09:27 +01:00
data_reviews :
2019-03-19 22:58:49 +01:00
- https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
2019-04-17 01:31:35 +02:00
- https://github.com/mozilla-mobile/fenix/pull/1677
2019-03-19 00:09:27 +01:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-22 07:05:28 +01:00
expires : "2020-03-01"
2019-03-27 03:08:16 +01:00
browser_menu_action :
type : event
description : >
A browser menu item was tapped
extra_keys :
item :
description : >
A string containing the name of the item the user tapped. These items include :
2019-04-06 15:55:26 +02:00
Settings, Library, Help, Desktop Site toggle on/off, Find in Page, New Tab,
2019-03-27 03:08:16 +01:00
Private Tab, Share, Report Site Issue, Back/Forward button, Reload Button
bugs :
- 1024
data_reviews :
- TBD
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-27 03:08:16 +01:00
expires : "2020-03-01"
2019-03-26 22:45:23 +01:00
ss_menu_opened :
type : event
description : >
A user opened the search shortcut menu in the search view by pressing the shortcuts button
bugs :
- 793
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1202#issuecomment-476870449
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-26 22:45:23 +01:00
expires : "2020-03-01"
ss_menu_closed :
type : event
description : >
A user closed the search shortcut menu in the search view by pressing the shortcuts button
bugs :
- 793
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1202#issuecomment-476870449
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-26 22:45:23 +01:00
expires : "2020-03-01"
ss_selected :
type : event
description : >
A user selected a search shortcut engine to use
extra_keys :
engine :
description : "The name of the built-in search engine the user selected as a string"
bugs :
- 793
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1202#issuecomment-476870449
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-26 22:45:23 +01:00
expires : "2020-03-01"
2019-04-26 09:43:02 +02:00
total_uri_count :
type : counter
description : >
A counter of URIs visited by the user in the current session, including page reloads. This does not include background page requests and URIs from embedded pages or private browsing.
send_in_pings :
- metrics
bugs :
- 1301
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1785
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
2019-03-18 22:32:03 +01:00
2019-03-27 02:36:58 +01:00
crash_reporter :
opened :
type : event
description : >
The crash reporter was displayed
bugs :
- 1040
data_reviews :
- TBD
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-27 02:36:58 +01:00
expires : "2020-03-01"
closed :
type : event
description : >
The crash reporter was closed
extra_keys :
crash_submitted :
description : "A boolean that tells us whether or not the user submitted a crash report"
bugs :
- 1040
data_reviews :
- TBD
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-03-27 02:36:58 +01:00
expires : "2020-03-01"
2019-04-03 03:18:14 +02:00
context_menu :
item_tapped :
type : event
description : >
A user tapped an item in the browsers context menu
extra_keys :
named :
description : >
The name of the item that was tapped. Available items are
```
open_in_new_tab, open_in_private_tab, open_image_in_new_tab,
save_image, share_link, copy_link, copy_image_location
```
bugs :
- 957
data_reviews :
2019-04-03 03:22:22 +02:00
- https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
2019-04-03 03:18:14 +02:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-03 03:18:14 +02:00
expires : "2020-03-01"
2019-04-03 01:47:11 +02:00
find_in_page :
opened :
type : event
description : >
A user opened the find in page UI
bugs :
- 1036
data_reviews :
2019-04-03 03:22:22 +02:00
- https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
2019-04-03 01:47:11 +02:00
notification_emails :
2019-04-12 21:57:11 +02:00
- fenix-core@mozilla.com
2019-04-03 01:47:11 +02:00
expires : "2020-03-01"
closed :
type : event
description : >
A user closed the find in page UI
bugs :
- 1036
data_reviews :
2019-04-03 03:22:22 +02:00
- https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
2019-04-03 01:47:11 +02:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-03 01:47:11 +02:00
expires : "2020-03-01"
next_result :
type : event
description : >
A user clicked the "next result" button
bugs :
- 1036
data_reviews :
2019-04-03 03:22:22 +02:00
- https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
2019-04-03 01:47:11 +02:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-03 01:47:11 +02:00
expires : "2020-03-01"
previous_result :
type : event
description : >
A user clicked the "previous result" button
bugs :
- 1036
data_reviews :
2019-04-03 03:22:22 +02:00
- https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
2019-04-03 01:47:11 +02:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-03 01:47:11 +02:00
expires : "2020-03-01"
searched_page :
type : event
description : >
A user searched the page
bugs :
- 1036
data_reviews :
2019-04-03 03:22:22 +02:00
- https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
2019-04-03 01:47:11 +02:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-03 01:47:11 +02:00
expires : "2020-03-01"
2019-04-06 00:08:55 +02:00
quick_action_sheet :
opened :
type : event
description : >
A user opened the quick action sheet UI
bugs :
- 1195
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-06 00:08:55 +02:00
expires : "2020-03-01"
closed :
type : event
description : >
A user closed the quick action sheet UI
bugs :
- 1195
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
notification_emails :
2019-04-12 21:57:11 +02:00
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-06 00:08:55 +02:00
expires : "2020-03-01"
share_tapped :
type : event
description : >
A user tapped the share button
bugs :
- 1195
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-06 00:08:55 +02:00
expires : "2020-03-01"
bookmark_tapped :
type : event
description : >
A user tapped the bookmark button
bugs :
- 1195
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-06 00:08:55 +02:00
expires : "2020-03-01"
download_tapped :
type : event
description : >
A user tapped the download button
bugs :
- 1195
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-06 00:08:55 +02:00
expires : "2020-03-01"
read_tapped :
type : event
description : >
A user tapped the read button
bugs :
- 1195
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-06 00:08:55 +02:00
expires : "2020-03-01"
2019-03-18 21:30:25 +01:00
metrics :
default_browser :
type : boolean
description : >
Is Fenix the default browser?
send_in_pings :
- metrics
bugs :
2019-03-19 22:58:49 +01:00
- 960
2019-03-18 21:30:25 +01:00
data_reviews :
2019-03-19 22:58:49 +01:00
- https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
2019-03-18 21:30:25 +01:00
notification_emails :
2019-04-08 18:26:14 +02:00
- fenix-core@mozilla.com
2019-04-12 21:57:11 +02:00
expires : "2020-03-01"
2019-04-17 01:31:35 +02:00
search_count :
type : labeled_counter
description : >
2019-05-08 19:15:19 +02:00
The labels for this counter are `<search-engine-name>_<source>`.
2019-04-17 01:31:35 +02:00
If the search engine is bundled with Fenix `search-engine-name` will be the name of the search engine. If it's a
custom search engine (defined : https://github.com/mozilla-mobile/fenix/issues/1607) the value will be `custom`.
`source` will either be `action` or `suggestion`
send_in_pings :
- metrics
bugs :
- 1158
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1677
notification_emails :
- fenix-core@mozilla.com
expires : "2019-09-01"
2019-04-25 21:33:15 +02:00
mozilla_products :
type : string_list
description : >
A list of all the Mozilla products installed on device. We currently scan for : Firefox, Firefox Beta,
Firefox Aurora, Firefox Nightly, Firefox Fdroid, Firefox Lite, Reference Browser, Reference Browser Debug,
Fenix, Focus, and Lockbox.
send_in_pings :
- metrics
bugs :
- 1192
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1953/
notification_emails :
- fenix-core@mozilla.com
expires : "2019-09-01"
default_moz_browser :
type : string
description : >
The name of the default browser on device if and only if it's a Mozilla owned product, otherwise empty string
send_in_pings :
- metrics
bugs :
- 1192
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1953/
notification_emails :
- fenix-core@mozilla.com
expires : "2019-09-01"
2019-04-12 21:57:11 +02:00
2019-04-12 22:25:16 +02:00
search.default_engine :
code :
type : string
description : >
If the search engine is pre-loaded with Fenix this value
will be the search engine identifier. If it's a custom search engine
(defined : https://github.com/mozilla-mobile/fenix/issues/1607) the
value will be "custom"
send_in_pings :
- metrics
bugs :
- 800
data_reviews :
- https://github.com/mozilla-mobile/fenix/issues/1607
notification_emails :
- fenix-core@mozilla.com
expires : "2019-09-01"
name :
type : string
description : >
If the search engine is pre-loaded with Fenix this value
will be the search engine name. If it's a custom search engine
(defined : https://github.com/mozilla-mobile/fenix/issues/1607) the
value will be "custom"
send_in_pings :
- metrics
bugs :
- 800
data_reviews :
- https://github.com/mozilla-mobile/fenix/issues/1607
notification_emails :
- fenix-core@mozilla.com
expires : "2019-09-01"
submission_url :
type : string
description : >
If the search engine is pre-loaded with Fenix this value
will be he base URL we use to build the search query for the search engine.
For example : https://mysearchengine.com/?query=%s. If it's a custom search engine
(defined : https://github.com/mozilla-mobile/fenix/issues/1607) the
value will be "custom"
send_in_pings :
- metrics
bugs :
- 800
data_reviews :
- https://github.com/mozilla-mobile/fenix/issues/1607
notification_emails :
- fenix-core@mozilla.com
2019-04-17 20:13:48 +02:00
expires : "2019-09-01"
2019-04-17 19:37:36 +02:00
bookmarks_management :
open_in_new_tab :
type : event
description : >
A user opened a bookmark in a new tab.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
open_in_new_tabs :
type : event
description : >
A user opened multiple bookmarks at once in new tabs.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
open_in_private_tab :
type : event
description : >
A user opened a bookmark in a new private tab.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
open_in_private_tabs :
type : event
description : >
A user opened multiple bookmarks at once in new private tabs.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
edited :
type : event
description : >
A user edited the title and/or URL of an existing bookmark.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
moved :
type : event
description : >
A user moved an existing bookmark or folder to another folder.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
removed :
type : event
description : >
A user removed a bookmark item.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
multi_removed :
type : event
description : >
A user removed multiple bookmarks at once.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
shared :
type : event
description : >
A user shared a bookmark.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
copied :
type : event
description : >
A user copied a bookmark.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
folder_add :
type : event
description : >
A user added a new bookmark folder.
bugs :
- 974
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1708
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
2019-04-17 20:13:48 +02:00
custom_tab :
closed :
type : event
description : >
A user closed the custom tab
bugs :
- 977
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1697
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
action_button :
type : event
description : >
A user pressed the action button provided by the launching app
bugs :
- 977
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1697
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
menu :
type : event
description : >
A user opened the custom tabs menu
bugs :
- 977
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1697
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
2019-04-26 17:42:20 +02:00
preferences :
preference_toggled :
type : event
description : >
A user toggled a preference switch in settings
extra_keys :
preference_key :
description : "The preference key for the switch preference the user toggled. We currently track: leakcanary,
make_default_browser, show_search_suggestions, show_visited_sites_bookmarks, remote_debugging, telemetry,
tracking_protection"
enabled :
description : "Whether or not the preference is *now* enabled"
bugs :
- 975
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1896
notification_emails :
- fenix-core@mozilla.com
2019-05-03 16:40:22 +02:00
expires : "2020-03-01"
activation :
identifier :
type : string
lifetime : ping
description : >
An hashed and salted version of the Google Advertising ID from the device.
This will never be sent in a ping that also contains the client_id.
send_in_pings :
- activation
bugs :
- 1538011
- 1501822
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
notification_emails :
- fenix-core@mozilla.com
expires : "2019-10-01"
activation_id :
type : uuid
lifetime : user
description : >
An alternate identifier, not correlated with the client_id, generated once
and only sent with the activation ping.
send_in_pings :
- activation
bugs :
- 1538011
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
notification_emails :
- fenix-core@mozilla.com
2019-05-15 19:01:26 +02:00
expires : "2019-10-01"
qr_scanner :
opened :
type : event
description : >
A user opened the QR scanner
bugs :
- 1857
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
prompt_displayed :
type : event
description : >
A user scanned a QR code, causing a confirmation prompt to display asking if they want to navigate to the page
bugs :
- 1857
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
navigation_allowed :
type : event
description : >
A user tapped "allow" on the prompt, directing the user to the website scanned
bugs :
- 1857
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"
navigation_denied :
type : event
description : >
A user tapped "deny" on the prompt, putting the user back to the scanning view
bugs :
- 1857
data_reviews :
- https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
notification_emails :
- fenix-core@mozilla.com
expires : "2020-03-01"