iceraven-browser/app/metrics.yaml

# 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/.


$schema: moz://mozilla.org/schemas/glean/metrics/1-0-0

events:
  app_opened:
    type: event
    description: >
      A user opened the app
    extra_keys:
      source:
        description: "The method used to open Fenix. Possible values are: `app_icon`, `custom_tab` or `link`"
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/968
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
    notification_emails:
    - telemetry-client-dev@mozilla.com
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  search_bar_tapped:
    type: event
    description: >
      A user tapped the search bar
    extra_keys:
      source:
        description: "The view the user was on when they initiated the search (For example: `Home` or `Browser`)"
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/959
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  entered_url:
    type: event
    description: >
      A user entered a url
    extra_keys:
      autocomplete:
        description: "A boolean that tells us whether the URL was autofilled by an Autocomplete suggestion"
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/959
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  performed_search:
    type: event
    description: >
      A user performed a search
    extra_keys:
      source:
        description: >
          A string that tells us how the user performed the search. Possible values are:
          * default.action
          * default.suggestion
          * shortcut.action
          * shortcut.suggestion
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/959
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
    - https://github.com/mozilla-mobile/fenix/pull/1677
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  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:
          Settings, Library, Help, Desktop Site toggle on/off, Find in Page, New Tab,
          Private Tab, Share, Report Site Issue, Back/Forward button, Reload Button, Quit
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1024
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
    - https://github.com/mozilla-mobile/fenix/pull/5098#issuecomment-529658996
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  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:
    - baseline
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1301
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1785
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  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:
          show_search_suggestions, remote_debugging, telemetry, tracking_protection, search_bookmarks,
          search_browsing_history, and show_clipboard_suggestions"
      enabled:
        description: "Whether or not the preference is *now* enabled"
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/975
    - https://github.com/mozilla-mobile/fenix/issue/5094
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1896
    - https://github.com/mozilla-mobile/fenix/pull/5704
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  whats_new_tapped:
    type: event
    description: >
        A user opened the "what's new" page button
    extra_keys:
      source:
        description: "The location from which the user selected the what's new button. Either 'about' or 'home'"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5021
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5090
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

search_shortcuts:
  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:
      - https://github.com/mozilla-mobile/fenix/issue/793
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1202#issuecomment-476870449
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

crash_reporter:
  opened:
    type: event
    description: >
      The crash reporter was displayed
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1040
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
    notification_emails:
    - fenix-core@mozilla.com
    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:
    - https://github.com/mozilla-mobile/fenix/issue/1040
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

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:
    - https://github.com/mozilla-mobile/fenix/issue/957
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

find_in_page:
  opened:
    type: event
    description: >
      A user opened the find in page UI
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1036
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  closed:
    type: event
    description: >
      A user closed the find in page UI
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1036
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  next_result:
    type: event
    description: >
      A user clicked the "next result" button
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1036
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  previous_result:
    type: event
    description: >
      A user clicked the "previous result" button
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1036
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  searched_page:
    type: event
    description: >
      A user searched the page
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1036
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

quick_action_sheet:
  opened:
    type: event
    description: >
      A user opened the quick action sheet UI
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1195
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  closed:
    type: event
    description: >
      A user closed the quick action sheet UI
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1195
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  share_tapped:
    type: event
    description: >
      A user tapped the share button
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1195
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  bookmark_tapped:
    type: event
    description: >
      A user tapped the bookmark button
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1195
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  download_tapped:
    type: event
    description: >
      A user tapped the download button
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1195
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1362#issuecomment-479668466
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  open_app_tapped:
    type: event
    description: >
      A user tapped the open in app button
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/1195
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4629
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

metrics:
  default_browser:
    type: boolean
    lifetime: application
    description: >
      Is Fenix the default browser?
    send_in_pings:
    - metrics
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/960
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  search_count:
    type: labeled_counter
    description: >
      The labels for this counter are `<search-engine-name>.<source>`.

      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
    - baseline
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1158
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1677
    - https://github.com/mozilla-mobile/fenix/pull/5216
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  mozilla_products:
    type: string_list
    lifetime: application
    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 Lockwise.
    send_in_pings:
    - metrics
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1192
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1953/
    - https://github.com/mozilla-mobile/fenix/pull/5216
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  default_moz_browser:
    type: string
    lifetime: application
    description: >
      The name of the default browser on device if and only if it's a Mozilla owned product
    send_in_pings:
    - metrics
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1192
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1953/
    - https://github.com/mozilla-mobile/fenix/pull/5216
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  adjust_campaign:
    type: string
    lifetime: application
    description: >
      A string containing the Adjust campaign ID from which the user installed Fenix
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/1298
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5579
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"


search.default_engine:
  code:
    type: string
    lifetime: application
    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:
    - https://github.com/mozilla-mobile/fenix/issue/800
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1606
    - https://github.com/mozilla-mobile/fenix/pull/5216
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  name:
    type: string
    lifetime: application
    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:
    - https://github.com/mozilla-mobile/fenix/issue/800
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1606
    - https://github.com/mozilla-mobile/fenix/pull/5216
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  submission_url:
    type: string
    lifetime: application
    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:
    - https://github.com/mozilla-mobile/fenix/issue/800
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1606
    - https://github.com/mozilla-mobile/fenix/pull/5216
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

bookmarks_management:
  open_in_new_tab:
    type: event
    description: >
      A user opened a bookmark in a new tab.
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/974
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1708
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  folder_remove:
    type: event
    description: >
      A user removed a bookmark folder.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/3174
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3724
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

custom_tab:
  closed:
    type: event
    description: >
      A user closed the custom tab
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/977
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1697
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

activation:
  identifier:
    type: string
    lifetime: ping
    description: >
      A 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:
    - https://bugzilla.mozilla.org/1538011
    - https://bugzilla.mozilla.org/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:
    - https://bugzilla.mozilla.org/1538011
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2019-10-01"

qr_scanner:
  opened:
    type: event
    description: >
      A user opened the QR scanner
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/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:
    - https://github.com/mozilla-mobile/fenix/issue/1857
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

library:
  opened:
    type: event
    description: >
      A user opened the library
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/976
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2538#issuecomment-492830242
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  closed:
    type: event
    description: >
      A user closed the library
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/976
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2538#issuecomment-492830242
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  selected_item:
    type: event
    description: >
      A user selected a library item
    extra_keys:
      item:
        description: "The library item the user selected"
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/976
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2538#issuecomment-492830242
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

error_page:
  visited_error:
    type: event
    description: >
      A user encountered an error page
    extra_keys:
      error_type:
        description: "The error type of the error page encountered"
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1242
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2491#issuecomment-492414486
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

sync_auth:
  opened:
    type: event
    description: >
      A user opened the sync authentication page
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1190
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  closed:
    type: event
    description: >
      A user closed the sync page
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1190
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  sign_in:
    type: event
    description: >
      A user pressed the sign in button on the sync authentication page and was successfully signed in to FxA
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1190
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  sign_out:
    type: event
    description: >
      A user pressed the sign out button on the sync account page and was successfully signed out of FxA
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/1190
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  sign_up:
    type: event
    description: >
      User registered a new Firefox Account, and was signed into it
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  paired:
    type: event
    description: >
      User signed into FxA by pairing with a different Firefox browser, using a QR code
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  auto_login:
    type: event
    description: >
      User signed into FxA via an account shared from another locally installed Mozilla application (e.g. Fennec)
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  recovered:
    type: event
    description: >
      Account manager automatically recovered FxA authentication state without direct user involvement
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  other_external:
    type: event
    description: >
      User authenticated via FxA using an unknown mechanism. "Known" mechanisms are currently sign-in, sign-up and pairing
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  scan_pairing:
    type: event
    description: >
      A user pressed the scan pairing button on the sync authentication page
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1190
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"

sync_account:
  opened:
    type: event
    description: >
      A user opened the sync account page
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1190
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  closed:
    type: event
    description: >
      A user closed the sync account page
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1190
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  sync_now:
    type: event
    description: >
      A user pressed the sync now button on the sync account page
    bugs:
    - https://github.com/mozilla-mobile/fenix/issue/1190
    data_reviews:
    - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
    notification_emails:
    - fenix-core@mozilla.com
    expires: "2020-03-01"
  send_tab:
    type: event
    description: >
      A user sent the current tab to another FxA device
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4908
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5106
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  sign_in_to_send_tab:
    type: event
    description: >
      A user pressed the "sign in to send tab" button inside the share tab menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4908
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5106
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

history:
  opened:
    type: event
    description: >
      A user opened the history screen
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  removed:
    type: event
    description: >
      A user removed a history item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  removed_all:
    type: event
    description: >
      A user removed all history items
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  shared:
    type: event
    description: >
      A user shared a history item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  opened_item:
    type: event
    description: >
      A user opened a history item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

reader_mode:
  available:
    type: event
    description: >
      Reader mode is available for the current page
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2267
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3941
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  opened:
    type: event
    description: >
      A user opened reader mode
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2267
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3941
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  closed:
    type: event
    description: >
      A user closed reader mode
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2267
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4328
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  appearance:
    type: event
    description: >
      A user tapped the appearance button
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/2267
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3941
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

collections:
  renamed:
    type: event
    description: >
      A user renamed a collection
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  tab_restored:
    type: event
    description: >
      A user restored a tab from collection tab list
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  all_tabs_restored:
    type: event
    description: >
      A user tapped "open tabs" from collection menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  tab_removed:
    type: event
    description: >
      A user tapped remove tab from collection tab list
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  shared:
    type: event
    description: >
      A user tapped share collection
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  removed:
    type: event
    description: >
      A user tapped delete collection from collection menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  saved:
    type: event
    description: >
      A user saved a list of tabs to a new collection
    extra_keys:
      tabs_open:
        description: "The number of tabs open in the current session"
      tabs_selected:
        description: "The number of tabs added to the collection"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  tabs_added:
    type: event
    description: >
      A user saved a list of tabs to an existing collection
    extra_keys:
      tabs_open:
        description: "The number of tabs open in the current session"
      tabs_selected:
        description: "The number of tabs added to the collection"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  tab_select_opened:
    type: event
    description: >
      A user opened the select tabs screen (the first step of the collection creation flow)
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  add_tab_button:
    type: event
    description: >
      A user tapped the "add tab" button in the three dot menu of collections
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4358
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  long_press:
    type: event
    description: >
      A user long pressed on a tab, triggering the collection creation screen
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4358
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  save_button:
    type: event
    description: >
      A user pressed the "save to collection" button on either the home or browser screen, triggering the
      collection creation screen to open (tab_select_opened)
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4358
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
    extra_keys:
      from_screen:
        description: >
          A string representing the screen from which the user pressed the save button.
          Currently one of: `browserMenu`, `homeMenu` or `home`
  rename_button:
    type: event
    description: >
      A user pressed the "rename collection" button in the three dot menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4539
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

search_widget:
  new_tab_button:
    type: event
    description: >
      A user pressed anywhere from the Firefox logo until the start of the microphone icon, opening a
      new tab search screen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4457
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4714
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  voice_button:
    type: event
    description: >
      A user pressed the microphone icon, opening a new voice search screen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4457
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4714
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

private_browsing_mode:
  garbage_icon:
    type: event
    description: >
      A user pressed the garbage can icon on the private browsing home page,
      deleting all private tabs.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4968
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  snackbar_undo:
    type: event
    description: >
      A user pressed the "undo" button in the snackbar that is shown when the garbage icon is
      tapped.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4968
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  notification_tapped:
    type: event
    description: >
      A user pressed the private browsing mode notification itself.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4968
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  notification_open:
    type: event
    description: >
      A user pressed the private browsing mode notification's "Open" button.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4968
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  notification_delete:
    type: event
    description: >
      A user pressed the private browsing mode notification's "Delete and Open" button.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4968
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

tracking_protection:
  exception_added:
    type: event
    description: >
      A user added a tracking protection exception through the TP toggle in the panel.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  panel_settings:
    type: event
    description: >
      A user opened tracking protection settings from the panel.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  etp_shield:
    type: event
    description: >
      A user pressed the tracking protection shield icon in toolbar.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  etp_tracker_list:
    type: event
    description: >
      A user pressed into a list of categorized trackers in tracking protection panel.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  etp_settings:
    type: event
    description: >
      A user opened tracking protection settings through settings.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  etp_setting_changed:
    type: event
    description: >
      A user added a tracking protection exception through the TP toggle in the panel.
    extra_keys:
      etp_setting:
        description: "The new setting for ETP: strict, standard"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

private_browsing_shortcut:
  create_shortcut:
    type: event
    description: >
      A user pressed the "Add private browsing shortcut" button in settings.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  cfr_add_shortcut:
    type: event
    description: >
      A user pressed the "Add shortcut" button when the contextual feature recommender appeared.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  cfr_cancel:
    type: event
    description: >
      A user pressed the "No thanks" button when the contextual feature recommender appeared.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  pinned_shortcut_priv:
    type: event
    description: >
      A user pressed the pinned private shortcut in Android home screen, opening up a new private search.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  static_shortcut_tab:
    type: event
    description: >
      A user pressed the long-press shortcut "Open new tab", opening up a new search.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  static_shortcut_priv:
    type: event
    description: >
      A user pressed the long-press shortcut "Open new private tab", opening up a new private search.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

tab:
  media_play:
    type: event
    description: >
      A user pressed the play icon on a tab from the home screen
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5197
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5266
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  media_pause:
    type: event
    description: >
      A user pressed the pause icon on a tab from the home screen
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5197
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5266
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

media_notification:
  play:
    type: event
    description: >
      A user pressed the play icon on the media notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5197
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5520
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"
  pause:
    type: event
    description: >
      A user pressed the pause icon on the media notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issue/5197
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5520
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2020-03-01"

experiments.metrics:
  active_experiment:
    type: string
    description: >
      Records the branch name of the active experiment, if the client is enrolled in the
      `fenix-test-2019-08-05` experiment. This is intended to validate that the service-experiments
      library properly matches clients to experiments and can take action based on a multi-branched
      experiment. This is done by recording the experiment branch name in this string metric which
      allows the experiment to be transparent and unobtrusive to the user.
    bugs:
      - https://bugzilla.mozilla.org/1543986
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1543986#c4
    notification_emails:
      - mcooper@mozilla.com
    expires: 2019-11-01