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

no_lint:
  - CATEGORY_GENERIC

events:
  app_opened_all_startup:
    type: event
    description: |
      A user opened the app to the HomeActivity. The HomeActivity
      encompasses the home screen, browser screen, settings screen,
      collections and other screens in the nav_graph.
      This differs from the app_opened probe because it measures all
      startups, not just cold startup. Note: There is a short gap
      between the time application goes into background and the time
      android reports the application going into the background.
      Note: This metric does not record souce when app opened from
      task switcher: open application -> press home button -> open
      recent tasks -> choose fenix. In this case will report
      [source = unknown, type = hot, has_saved_instance_state = false].
    extra_keys:
      type:
        description: |
          the startup type for opening fenix. the application and HomeActivity
          either needs to be created or started again. possible values are
          `cold`, `warm`, `hot` or `error`. Error is for impossible cases.
          Please file a bug if you see the error case.
          app created AND HomeActivity created = cold
          app started AND HomeActivity created = warm
          app started AND HomeActivity started = hot
          app created AND HomeActivity started = error
      source:
        description: |
          The method used to open Fenix. Possible values are `app_icon`,
          `custom_tab`, `link` or `unknown`. unknown is for startup sources
          where we can't pinpoint the cause. One UNKNOWN case is the app
          switcher where we don't know what variables to check to ensure this
          startup wasn't caused by something else.
      has_saved_instance_state:
        description: |
          boolean value whether or not startup type has a savedInstance.
          using savedInstance, HomeActivity's previous state can be restored.
          This is an optional key since it is not applicable to all the cases.
          for example, when we are doing a hot start up, we cant have a
          savedInstanceState therefore we report only [APP_ICON, HOT] instead
          of [APP_ICON, HOT, false].
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11830
      - https://github.com/mozilla-mobile/fenix/issues/12573
      - https://github.com/mozilla-mobile/fenix/pull/13494
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12114#pullrequestreview-445245341
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/13494#pullrequestreview-474050499
    data_sensitivity:
      - interaction
    notification_emails:
      - esmyth@mozilla.com
      - perf-android-fe@mozilla.com
    expires: "2021-06-01"
  app_received_intent:
    type: event
    description: |
      The system received an Intent for the HomeActivity. An intent
      is received an external entity wants to the app to display
      content. Intents can be received when the app is closed – at
      which point the app will be opened – or when the app is
      already opened – at which point the already open app will make
      changes such as loading a url. This can be used loosely as a
      heuristic for when the user requested to open the app. The
      HomeActivity encompasses the home screen and browser screen but
      may include other screens. This differs from the app_opened
      probe because it measures all startups, not just cold startup.
    extra_keys:
      source:
        description: |
          The method used to open Fenix. Possible values are `app_icon`,
          `custom_tab`, `link` or `unknown`
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11830
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11940/
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    notification_emails:
      - esmyth@mozilla.com
      - perf-android-fe@mozilla.com
    expires: "2021-06-01"
  app_opened:
    type: event
    description: |
      A user opened the app (from cold start, to the homescreen or browser)
    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/issues/968
      - https://github.com/mozilla-mobile/fenix/issues/10616
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - telemetry-client-dev@mozilla.com
      - fenix-core@mozilla.com
    expires: "2021-04-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/issues/959
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-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/issues/959
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-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/issues/959
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
      - https://github.com/mozilla-mobile/fenix/pull/1677
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-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, Help, Desktop Site toggle on/off, Find in Page,
            New Tab, Private Tab, Share, Report Site Issue, Back/Forward button,
            Reload Button, Quit, Reader Mode On, Reader Mode Off, Open In app,
            Add To Top Sites, Add-ons Manager, Bookmarks, History
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1024
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
      - https://github.com/mozilla-mobile/fenix/pull/5098#issuecomment-529658996
      - https://github.com/mozilla-mobile/fenix/pull/6310
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-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 but may be incremented without user
      interaction by website scripts that programmatically redirect to a new
      location.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1301
      - https://github.com/mozilla-mobile/fenix/issues/4456
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1785
      - https://github.com/mozilla-mobile/fenix/pull/8314
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  preference_toggled:
    type: event
    description: |
      A user toggled a boolean preference in settings
    extra_keys:
      preference_key:
        description: |
          The preference key for the boolean (true/false) preference the user
          toggled.

          We currently track: show_search_suggestions, remote_debugging,
          telemetry, tracking_protection, search_bookmarks,
          search_browsing_history, show_clipboard_suggestions,
          show_search_shortcuts, open_links_in_a_private_tab (bug in
          implementation https://github.com/mozilla-mobile/fenix/issues/7384),
          pref_key_sync_logins, pref_key_sync_bookmarks, pref_key_sync_history,
          pref_key_show_voice_search,
          and pref_key_show_search_suggestions_in_private.
      enabled:
        description: "Whether or not the preference is *now* enabled"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/975
      - https://github.com/mozilla-mobile/fenix/issues/5094
      - https://github.com/mozilla-mobile/fenix/issues/5737
      - https://github.com/mozilla-mobile/fenix/issues/5586
      - https://github.com/mozilla-mobile/fenix/issues/6396
      - https://github.com/mozilla-mobile/fenix/issues/6070
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1896
      - https://github.com/mozilla-mobile/fenix/pull/5704
      - https://github.com/mozilla-mobile/fenix/pull/5886
      - https://github.com/mozilla-mobile/fenix/pull/5975
      - https://github.com/mozilla-mobile/fenix/pull/6352
      - https://github.com/mozilla-mobile/fenix/pull/6601
      - https://github.com/mozilla-mobile/fenix/pull/6746
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-06-01"
  whats_new_tapped:
    type: event
    description: |
        A user opened the "what's new" page button
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5021
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5090
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-01"
  opened_link:
    type: event
    description: |
      A user opened a link with Fenix
    extra_keys:
      mode:
        description: |
          The mode the link was opened in. Either 'PRIVATE' or 'NORMAL'. N.B.:
          this probe may be incorrectly implemented: see
          https://github.com/mozilla-mobile/fenix/issues/14133
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5737
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5975
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-01"
  tab_counter_menu_action:
    type: event
    description:
      A tab counter menu item was tapped
    extra_keys:
      item:
        description: |
          A string containing the name of the item the user tapped. These items
          are:

            New tab, New private tab, Close tab
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11442
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11533
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-01"

onboarding:
  fxa_auto_signin:
    type: event
    description:
      The onboarding automatic sign in card was tapped.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-01"
  fxa_manual_signin:
    type: event
    description:
      The onboarding manual sign in card was tapped.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-01"
  privacy_notice:
    type: event
    description:
      The onboarding privacy notice card was tapped.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-01"
  pref_toggled_private_browsing:
    type: event
    description:
      The private browsing preference was selected from the onboarding card.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-01"
  pref_toggled_toolbar_position:
    type: event
    description:
      The toolbar position preference was chosen from the onboarding card.
    extra_keys:
      position:
        description: |
          A string that indicates the position of the toolbar TOP or BOTTOM.
          Default: BOTTOM
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-01"
  pref_toggled_tracking_prot:
    type: event
    description:
      The tracking protection preference was chosen from the onboarding card.
    extra_keys:
      setting:
        description: |
          A string that indicates the Tracking Protection policy STANDARD
          or STRICT. Default: Toggle ON, STANDARD
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-01"
  whats_new:
    type: event
    description:
      The onboarding What\'s New card was tapped.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-01"
  pref_toggled_theme_picker:
    type: event
    description:
      The device theme was chosen using the theme picker onboarding card.
    extra_keys:
      theme:
        description: |
          A string that indicates the theme LIGHT, DARK, or FOLLOW DEVICE.
          Default: FOLLOW DEVICE
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-01"
  finish:
    type: event
    description:
      The user taps starts browsing and ends the onboarding experience.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10824
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11867
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
      - erichards@mozilla.com
    expires: "2021-08-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/issues/793
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1202#issuecomment-476870449
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"

toolbar_settings:
  changed_position:
    type: event
    description: |
      The user selected a new position for the toolbar
    extra_keys:
      position:
        description: |
          A string that indicates the new position of the toolbar TOP or BOTTOM
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6054
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6608
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"

crash_reporter:
  opened:
    type: event
    description: |
      The crash reporter was displayed
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1040
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-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/issues/1040
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-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/issues/957
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-04-01"

login_dialog:
  displayed:
    type: event
    description: |
      The login dialog prompt was displayed
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9730
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/13050
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-02-01"
  cancelled:
    type: event
    description: |
      The login dialog prompt was cancelled
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9730
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/13050
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-02-01"
  saved:
    type: event
    description: |
      The login dialog prompt "save" button was pressed
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9730
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/13050
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-02-01"
  never_save:
    type: event
    description: |
      The login dialog prompt "never save" button was pressed
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9730
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/13050
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-02-01"

find_in_page:
  opened:
    type: event
    description: |
      A user opened the find in page UI
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1036
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  closed:
    type: event
    description: |
      A user closed the find in page UI
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1036
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  searched_page:
    type: event
    description: |
      A user searched the page
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1036
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-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/issues/960
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  top_sites_count:
    type: counter
    lifetime: application
    description: |
      A counter that indicates how many top sites a user has. This value will
      only be set if the user has at least *one* top site. If they have 0,
      this ping will not get sent, resulting in a null value. To disambiguate
      between a failed `top_sites_count` ping and 0 top sites, please see
      `has_top_sites`.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8125
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9556
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  has_top_sites:
    type: boolean
    lifetime: application
    description: |
      A boolean that indicates if the user has top sites
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8125
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9556
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  recently_used_pwa_count:
    type: counter
    lifetime: application
    description: |
      A counter that indicates how many PWAs a user has recently used.
      Threshold for "recency" set in HomeActivity#PWA_RECENTLY_USED_THRESHOLD.
      Currently we are not told by the OS when a PWA is removed by the user,
      so we use the "recently used" heuristic to judge how many PWAs are still
      active, as a proxy for "installed". This value will only be set if the
      user has at least *one* recently used PWA. If they have 0, this metric
      will not be sent, resulting in a null value during analysis on the
      server-side. To disambiguate between a failed `recently_used_pwa_count`
      metric and 0 recent PWAs, please see `has_recent_pwas`.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11909
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11982#pullrequestreview-437963817
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  has_recent_pwas:
    type: boolean
    lifetime: application
    description: |
      A boolean that indicates if the user has recently used PWAs.
      See recently_used_pwa_count for the actual count.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11909
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11982#pullrequestreview-437963817
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-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 be: `action`, `suggestion`, `widget` or `shortcut`
      (depending on the source from which the search started). Also added the
      `other` option for the source but it should never enter on this case.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1158
      - https://github.com/mozilla-mobile/fenix/issues/6556
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1677
      - https://github.com/mozilla-mobile/fenix/pull/5216
      - https://github.com/mozilla-mobile/fenix/pull/7310
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-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/issues/1192
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1953/
      - https://github.com/mozilla-mobile/fenix/pull/5216
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-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/issues/1192
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1953/
      - https://github.com/mozilla-mobile/fenix/pull/5216
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  adjust_campaign:
    type: string
    lifetime: application
    description: |
      A string containing the Adjust campaign ID from which the user installed
      Fenix. This will not send on the first session the user runs. If the
      install is organic, this will be empty.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1298
      - https://github.com/mozilla-mobile/fenix/issues/9136
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5579
    data_sensitivity:
      - technical
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  adjust_ad_group:
    type: string
    lifetime: application
    description: |
      A string containing the Adjust ad group ID from which the user installed
      Fenix. This will not send on the first session the user runs. If the
      install is organic, this will be empty.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1298
      - https://github.com/mozilla-mobile/fenix/issues/9136
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9253
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  adjust_creative:
    type: string
    lifetime: application
    description: |
      A string containing the Adjust creative ID from which the user installed
      Fenix. This will not send on the first session the user runs. If the
      install is organic, this will be empty.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1298
      - https://github.com/mozilla-mobile/fenix/issues/9136
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9253
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  adjust_network:
    type: string
    lifetime: application
    description: |
      A string containing the Adjust network ID from which the user installed
      Fenix. This will not send on the first session the user runs. If the
      install is organic, this will be empty.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1298
      - https://github.com/mozilla-mobile/fenix/issues/9136
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9253
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  toolbar_position:
    type: string
    lifetime: application
    description: |
      A string that indicates the new position of the toolbar TOP or BOTTOM
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6054
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6608
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  search_widget_installed:
    type: boolean
    lifetime: application
    description: |
      Whether or not the search widget is installed
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9488
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10958
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  tabs_open_count:
    type: counter
    lifetime: application
    description: |
      A counter that indicates how many NORMAL tabs a user has open. This
      value will only be set if the user has at least *one* open tab. If they
      have 0, this ping will not get sent, resulting in a null value. To
      disambiguate between a failed `tabs_open_count` ping and 0 open tabs,
      please see `has_open_tabs`.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11479
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12024
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  has_open_tabs:
    type: boolean
    lifetime: application
    description: |
      A boolean that indicates if the user has any open NORMAL tabs.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11479
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12024
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"

preferences:
  show_search_suggestions:
    type: string_list
    description: >
      Whether or not the user has search suggestions enabled
      default: true
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11118
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11211
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  remote_debugging:
    type: string_list
    description: >
      Whether or not the user has remote debugging enabled
      default: false
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11118
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11211
    data_sensitivity:
      - interaction
    notification_emails:
      - fenix-core@mozilla.com
    expires: "2021-08-01"
  telemetry:
    type: string_list
    description: >
      Whether or not the user has telemetry enabled. Note we should
      never receive a "false" value for this since telemetry would
      not send in that case.