# 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/2-0-0

no_lint:
  - CATEGORY_GENERIC

events:
  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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11940/
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    notification_emails:
      - esmyth@mozilla.com
      - perf-android-fe@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - telemetry-client-dev@mozilla.com
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    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
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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:
          add_to_homescreen, add_to_top_sites, addons_manager, back, bookmark,
          bookmarks, desktop_view_off, desktop_view_on, downloads,
          find_in_page, forward, help, history, library, new_private_tab,
          new_tab, open_in_app, open_in_fenix, quit, reader_mode_appearance,
          reader_mode_off, reader_mode_on, reload, save_to_collection,
          set_default_browser, settings, share, stop, sync_account, and
          sync_tabs.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1024
      - https://github.com/mozilla-mobile/fenix/issues/19923
    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
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  default_browser_changed:
    type: event
    description: |
      Indicates the default browser was changed
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18857
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18895
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-01"
  default_browser_notif_tapped:
    type: event
    description: |
      User tapped on the default browser notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/19847
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/20311
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"
  toolbar_menu_visible:
    type: event
    description: |
      The browser menu was displayed from toolbar menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18855
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18895
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  normal_and_private_uri_count:
    type: counter
    description: |
      A counter of URIs visited by the user in the current session, including
      page reloads. This includes private browsing.  This does not include
      background page requests and URIs from embedded pages 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/17089
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17935
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    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
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5090
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5975
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11533
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  synced_tab_opened:
    type: event
    description: >
      An event that indicates that a synced tab was opened.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15369
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16727
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-10"
  recently_closed_tabs_opened:
    type: event
    description: |
      An event that indicates that the user
      has accessed recently closed tabs list.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15366
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16739
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-10"
  copy_url_tapped:
    type: event
    description: |
      An event that indicates that a user has selected
      copy option when long pressing on url bar.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16827
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16915
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-10"
  browser_toolbar_home_tapped:
    type: event
    description: |
      An event that indicates that a user has tapped
      home button on browser toolbar.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/19915
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19936
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-10"

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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

experiments_default_browser:
  toolbar_menu_clicked:
    type: event
    description: |
      Set default browser was clicked from toolbar menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18851
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18895
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

crash_reporter:
  opened:
    type: event
    description: |
      The crash reporter was displayed
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1040
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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, share_image
          ```
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/957
      - https://github.com/mozilla-mobile/fenix/issues/16076
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/issues/16076#issuecomment-726216734
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-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
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-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
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-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
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  distribution_id:
    type: string
    lifetime: application
    description: |
      A string containing the distribution identifier. This is currently used
      to identify installs from Mozilla Online.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16075
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/issues/16075
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
    expires: never
  mobile_bookmarks_count:
    type: counter
    lifetime: application
    description: |
      A counter that indicates how many bookmarks a user has in the mobile
      folder. This value will only be set if the user has at least *one*
      bookmark. If they have 0, this ping will not get sent, resulting in
      a null value. To disambiguate between a failed `mobile_bookmarks_count`
      ping and 0 bookmarks, please see `has_mobile_bookmarks`.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16941
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16942
      - https://github.com/mozilla-mobile/fenix/pull/16942#issuecomment-742794701
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  has_mobile_bookmarks:
    type: boolean
    lifetime: application
    description: |
      A boolean that indicates if the user has bookmarks in the mobile folder
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16941
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16942
      - https://github.com/mozilla-mobile/fenix/pull/16942#issuecomment-742794701
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  desktop_bookmarks_count:
    type: counter
    lifetime: application
    description: |
      A counter that indicates how many bookmarks a user has in the desktop
      folder. This value will only be set if the user has at least *one*
      bookmark. If they have 0, this ping will not get sent, resulting in a
      null value. To disambiguate between a failed `desktop_bookmarks_count`
      ping and 0 bookmarks, please see `has_desktop_bookmarks`.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16941
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16942
      - https://github.com/mozilla-mobile/fenix/pull/16942#issuecomment-742794701
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  has_desktop_bookmarks:
    type: boolean
    lifetime: application
    description: |
      A boolean that indicates if the user has bookmarks in the desktop folder
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16941
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16942
      - https://github.com/mozilla-mobile/fenix/pull/16942#issuecomment-742794701
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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`, `shortcut`, `topsite`
      (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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  credit_cards_saved_count:
    type: counter
    lifetime: application
    description: |
      A counter that indicates the number of credit cards that have been
      saved manually by the user.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18711
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19548#issuecomment-848811030
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-01"
  credit_cards_deleted_count:
    type: counter
    lifetime: application
    description: |
      A counter that indicates the number of credit cards that have been
      deleted by the user.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18711
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19548#issuecomment-848811030
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-01"
  credit_cards_autofill_count:
    type: counter
    lifetime: application
    description: |
      A counter that indicates the number of times the user has autofilled
      a credit card.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18711
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19548#issuecomment-848811030
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  close_tab_setting:
    type: string
    lifetime: application
    description: |
      A string that indicates the setting for tab closing:
      MANUAL, ONE_DAY, ONE_WEEK, ONE_MONTH
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15347#issue-707408975
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/15811#issuecomment-706402952
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  tab_view_setting:
    type: string
    lifetime: application
    description: |
      A string that indicates the setting for tab view:
      GRID, LIST
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15347#issue-707408975
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/15811#issuecomment-706402952
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  start_reason_process_error:
    type: boolean
    description: |
      The `AppStartReasonProvider.ProcessLifecycleObserver.onCreate` was
      unexpectedly called twice. We can use this metric to validate our
      assumptions about how these APIs are called. This probe can be removed
      once we validate these assumptions.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  start_reason_activity_error:
    type: boolean
    description: |
      The `AppStartReasonProvider.ActivityLifecycleCallbacks.onActivityCreated`
      was unexpectedly called twice. We can use this metric to validate our
      assumptions about how these APIs are called. This probe can be removed
      once we validate these assumptions.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"

preferences:
  search_suggestions_enabled:
    type: boolean
    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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  remote_debugging_enabled:
    type: boolean
    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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  telemetry_enabled:
    type: boolean
    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.
      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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  enhanced_tracking_protection:
    type: string
    description: >
      What type of enhanced tracking protection the user has enabled.
      "standard," "strict," "custom," or "" (if disabled)
      default: "standard"
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11118
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11211
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  bookmarks_suggestion:
    type: boolean
    description: >
      Whether or not the user has enabled bookmark search suggestions
      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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  browsing_history_suggestion:
    type: boolean
    description: >
      Whether or not the user has enabled browsing history suggestions.
      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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  clipboard_suggestions_enabled:
    type: boolean
    description: >
      Whether or not the user has enabled clipboard search suggestions.
      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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  search_shortcuts_enabled:
    type: boolean
    description: >
      Whether or not the user has enabled search shortcuts.
      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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_links_in_private:
    type: boolean
    description: >
      Whether or not the user has enabled open links in a private tab.
      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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  signed_in_sync:
    type: boolean
    description: >
      Whether or not the user is signed into FxA
      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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  sync_items:
    type: string_list
    description: >
      The list of items the user has chosen to sync with FxA.
      default: "" if the user is signed out. Otherwise defaults to
      whatever is set in their FxA account. New accounts set:
      [bookmarks, history, passwords, tabs]
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11118
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11211
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  voice_search_enabled:
    type: boolean
    description: >
      Whether or not the user has enabled the voice search button.
      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
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  private_search_suggestions:
    type: boolean
    description: >
      Whether or not the user has enabled showing search suggestions
      in private mode.
      default: false (we prompt the user, asking them to make a selection)
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11118
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11211
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  toolbar_position_setting:
    type: string
    description: >
      The position of the toolbar
      default: bottom (defaults to top if the user has accessibility services)
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11118
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11211
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  accessibility_services:
    type: string_list
    description: >
      Whether or not the user has touch exploration or switch services enabled.
      These are built into the Android OS, not Fenix prefs.
      default: ""
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11118
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11211
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_links_in_app_enabled:
    type: boolean
    description: >
      Whether or not the user has the open links in apps feature 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/11446
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  user_theme:
    type: string
    description: >
      The theme the user has enabled. "light," "dark," "system," or "battery"
      default: "system" for API 28+, else "light"
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11118
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11446
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/800
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1606
      - https://github.com/mozilla-mobile/fenix/pull/5216
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/800
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1606
      - https://github.com/mozilla-mobile/fenix/pull/5216
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/800
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1606
      - https://github.com/mozilla-mobile/fenix/pull/5216
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

bookmarks_management:
  open:
    type: event
    description: |
      A user opened a bookmark.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18173
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18174
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"
  open_in_new_tab:
    type: event
    description: |
      A user opened a bookmark in a new tab.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/974
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/974
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  edited:
    type: event
    description: |
      A user edited the title and/or URL of an existing bookmark.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  moved:
    type: event
    description: |
      A user moved an existing bookmark or folder to another folder.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  removed:
    type: event
    description: |
      A user removed a bookmark item.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  multi_removed:
    type: event
    description: |
      A user removed multiple bookmarks at once.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  shared:
    type: event
    description: |
      A user shared a bookmark.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  copied:
    type: event
    description: |
      A user copied a bookmark.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  folder_add:
    type: event
    description: |
      A user added a new bookmark folder.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/974
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1708
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  folder_remove:
    type: event
    description: |
      A user removed a bookmark folder.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/3174
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3724
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"

custom_tab:
  closed:
    type: event
    description: |
      A user closed the custom tab
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/977
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1697
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  action_button:
    type: event
    description: |
      A user pressed the action button provided by the launching app
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/977
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1697
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  menu:
    type: event
    description: |
      A user opened the custom tabs menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/977
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1697
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - highly_sensitive
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - highly_sensitive
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
    no_lint:
      - USER_LIFETIME_EXPIRATION

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/issues/1242
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2491#issuecomment-492414486
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"

sync_auth:
  opened:
    type: event
    description: |
      A user opened the sync authentication page
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1190
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  closed:
    type: event
    description: |
      A user closed the sync page
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1190
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  use_email:
    type: event
    description: |
      A user chose to use their email to sign in instead of scanning a QR code,
      counterpart to "scan_pairing"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9834
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9835#pullrequestreview-398641844
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  use_email_problem:
    type: event
    description: |
      A user chose to use their email to sign in after an account problem
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9834
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9835#pullrequestreview-398641844
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/1190
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/1190
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  sign_up:
    type: event
    description: |
      User registered a new Firefox Account, and was signed into it
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  recovered:
    type: event
    description: |
      Account manager automatically recovered FxA authentication state without
      direct user involvement
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/4971
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/1190
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

sync_account:
  opened:
    type: event
    description: |
      A user opened the sync account page
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/1190
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/1190
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  send_tab:
    type: event
    description: |
      A user sent the current tab to another FxA device
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/4908
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5106
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/4908
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5106
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

history:
  opened:
    type: event
    description: |
      A user opened the history screen
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  removed:
    type: event
    description: |
      A user removed a history item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  removed_all:
    type: event
    description: |
      A user removed all history items
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  shared:
    type: event
    description: |
      A user shared a history item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/2362
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3940
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  opened_item:
    type: event
    description: |
      A user opened a history item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18178
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18261
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"
  opened_item_in_new_tab:
    type: event
    description: |
      A user opened a history item in a new tab
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18178
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18261
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"
  opened_items_in_new_tabs:
    type: event
    description: |
      A user opened multiple history items in new tabs
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18178
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18261
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"
  opened_item_in_private_tab:
    type: event
    description: |
      A user opened a history item in a private tab
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18178
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18261
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"
  opened_items_in_private_tabs:
    type: event
    description: |
      A user opened multiple history items in private tabs
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18178
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18261
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"

tip:
  displayed:
    type: event
    description: |
      The tip was displayed
    extra_keys:
      identifier:
        description: "The identifier of the tip displayed"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9328
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9836
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  pressed:
    type: event
    description: |
      The tip's button was pressed
    extra_keys:
      identifier:
        description: "The identifier of the tip the action was taken on"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9328
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9836
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  closed:
    type: event
    description: |
      The tip was closed
    extra_keys:
      identifier:
        description: "The identifier of the tip closed"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9328
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9836
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"

reader_mode:
  available:
    type: event
    description: |
      Reader mode is available for the current page
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/2267
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3941
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  opened:
    type: event
    description: |
      A user opened reader mode
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/2267
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3941
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  closed:
    type: event
    description: |
      A user closed reader mode
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/2267
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4328
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  appearance:
    type: event
    description: |
      A user tapped the appearance button
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/2267
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3941
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

tabs_tray.cfr:
  dismiss:
    type: event
    description: |
      A user dismisses the tabs tray CFR.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16485
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17442
      - https://github.com/mozilla-mobile/fenix/issues/16485#issuecomment-759641324
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  go_to_settings:
    type: event
    description: |
      A user selects the CFR option to navigate to settings.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16485
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17442
      - https://github.com/mozilla-mobile/fenix/issues/16485#issuecomment-759641324
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"

tabs_tray:
  opened:
    type: event
    description: |
      A user opened the tabs tray
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  closed:
    type: event
    description: |
      A user closed the tabs tray
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  opened_existing_tab:
    type: event
    description: |
      A user opened an existing tab
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  closed_existing_tab:
    type: event
    description: |
      A user closed an existing tab
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  private_mode_tapped:
    type: event
    description: |
      A user switched to private mode
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  normal_mode_tapped:
    type: event
    description: |
      A user switched to normal mode
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  synced_mode_tapped:
    type: event
    description: |
      A user switched to synced mode
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18948
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19004
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"
  new_tab_tapped:
    type: event
    description: |
      A user opened a new tab
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  new_private_tab_tapped:
    type: event
    description: |
      A user opened a new private tab
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  menu_opened:
    type: event
    description: |
      A user opened three three dot menu in the tabs tray
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  save_to_collection:
    type: event
    description: |
      A user tapped the save to collection button in the tabs tray
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  share_all_tabs:
    type: event
    description: |
      A user tapped the share all tabs button in the
      three dot menu within the tabs tray
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  close_all_tabs:
    type: event
    description: |
      A user tapped the close all tabs button in the
      three dot menu within the tabs tray
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11273
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12036
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

collections:
  renamed:
    type: event
    description: |
      A user renamed a collection
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  tab_restored:
    type: event
    description: |
      A user restored a tab from collection tab list
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  all_tabs_restored:
    type: event
    description: |
      A user tapped "open tabs" from collection menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  tab_removed:
    type: event
    description: |
      A user tapped remove tab from collection tab list
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  shared:
    type: event
    description: |
      A user tapped share collection
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  removed:
    type: event
    description: |
      A user tapped delete collection from collection menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/3935
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4358
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4358
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4358
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/969
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4539
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-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/issues/4457
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4714
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/4457
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4714
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

private_browsing_mode:
  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/issues/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4968
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  notification_tapped:
    type: event
    description: |
      A user pressed the private browsing mode notification itself.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/4968
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"

contextual_hint.tracking_protection:
  display:
    type: event
    description: |
      The enhanced tracking protection contextual hint was
      displayed.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9625
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11923
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  dismiss:
    type: event
    description: |
      The enhanced tracking protection contextual hint was
      dismissed
      by pressing the close button
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9625
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11923
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  outside_tap:
    type: event
    description: |
      The user tapped outside of the etp contextual hint
      (which has no effect).
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9625
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11923
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  inside_tap:
    type: event
    description: |
      The user tapped inside of the etp contextual hint
      (which brings up the etp panel for this site).
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/9625
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11923
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-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/issues/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  panel_settings:
    type: event
    description: |
      A user opened tracking protection settings from the panel.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  etp_shield:
    type: event
    description: |
      A user pressed the tracking protection shield icon in toolbar.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  etp_settings:
    type: event
    description: |
      A user opened tracking protection settings through settings.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5312
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  etp_setting_changed:
    type: event
    description: |
      A user changed their tracking protection level setting to either strict,
      standard, or custom.
    extra_keys:
      etp_setting:
        description: "The new setting for ETP: strict, standard, custom"
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5312
      - https://github.com/mozilla-mobile/fenix/issues/11063
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
      - https://github.com/mozilla-mobile/fenix/pull/11383
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-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/issues/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-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/issues/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-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/issues/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-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/issues/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-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/issues/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-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/issues/4658
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5194
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-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/issues/5197
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5266
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
    no_lint:
      - COMMON_PREFIX
  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/issues/5197
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5266
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

media_notification:
  play:
    type: event
    description: |
      A user pressed the play icon on the media notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5197
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5520
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  pause:
    type: event
    description: |
      A user pressed the pause icon on the media notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5197
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/5520
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

media_state:
  play:
    type: event
    description: |
      Media started playing.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5705
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6463
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  pause:
    type: event
    description: |
      Media playback was paused.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5705
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6463
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  stop:
    type: event
    description: |
      Media playback has ended.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5705
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6463
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  fullscreen:
    type: event
    description: |
      Video set to fullscreen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15368
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16833
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  picture_in_picture:
    type: event
    description: |
      Video set to picture in picture mode.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15368
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16833
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

logins:
  open_logins:
    type: event
    description: |
      A user accessed Logins in Settings
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5586
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6352
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_individual_login:
    type: event
    description: |
      A user accessed an individual login in saved logins
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5586
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6352
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  copy_login:
    type: event
    description: |
      A user copied a piece of a login in saved logins
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5586
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6352
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  view_password_login:
    type: event
    description: |
      A user viewed a password in an individual saved login
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5586
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6352
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  save_logins_setting_changed:
    type: event
    description: |
      A user changed their setting for asking to save logins
    extra_keys:
      setting:
        description: |
          The new setting for saving logins the user selected. Either
          `ask_to_save` or `never_save`
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5586
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/7767
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_login_editor:
    type: event
    description: |
      A user entered the edit screen for an individual saved login
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10173
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/issues/11208
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  delete_saved_login:
    type: event
    description: |
      A user confirms delete of a saved login
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10173
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/issues/11208
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  save_edited_login:
    type: event
    description: |
      A user saves changes made to an individual login
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10173
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/issues/11208
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

download_notification:
  resume:
    type: event
    description: |
      A user resumed a download in the download notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5583
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6554
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  pause:
    type: event
    description: |
      A user paused a download in the download notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5583
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6554
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  cancel:
    type: event
    description: |
      A user cancelled a download in the download notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5583
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6554
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  try_again:
    type: event
    description: |
      A user tapped on try again when a download fails in the download
      notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5583
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6554
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  open:
    type: event
    description: |
      A user opened a downloaded file in the download notification
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5583
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6554
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  in_app_open:
    type: event
    description: |
      A user opened a downloaded file in the in-app notification link
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5583
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6554
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  in_app_try_again:
    type: event
    description: |
      A user tapped on try again when a download fails in the in-app
      notification link
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5583
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6554
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"

downloads_misc:
  download_added:
    type: event
    description:
      A counter for how many times something is downloaded in the app.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11578
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16730
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"

downloads_management:
  downloads_screen_opened:
    type: event
    description: >
      A counter for the number of times users access the "Downloads" folder
      inside the app.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15367
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16728
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"

  item_opened:
    type: event
    description: >
      A counter for how often a user tap to opens a download from inside the
      "Downloads" folder.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15367
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16728
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"

  item_deleted:
    type: event
    description: >
      A counter for how often a user deletes one / more downloads at a time.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15367
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16728
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"

user_specified_search_engines:
  custom_engine_added:
    type: event
    description: |
      A user added a new custom search engine
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5884
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6918
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
    no_lint:
      - COMMON_PREFIX
  custom_engine_deleted:
    type: event
    description: |
      A user deleted a custom search engine
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/5884
      - https://github.com/mozilla-mobile/fenix/issues/7881
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6918
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"

search_suggestions:
  enable_in_private:
    type: event
    description: |
      A user enabled receiving search suggestions in private sessions
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6070
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/6746
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"

voice_search:
  tapped:
    type: event
    description: |
      A user selected the voice search button on the search screen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10465
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10785
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

top_sites:
  open_default:
    type: event
    description: |
      A user opened a default top site
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8125
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10752
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_google_search_attribution:
    type: event
    description: |
      A user opened the google top site
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17418
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17637
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_frecency:
    type: event
    description: |
      A user opened a frecency top site
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/14565
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/15136
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_pinned:
    type: event
    description: |
      A user opened a pinned top site
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/14565
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/15136
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  swipe_carousel:
    type: event
    description: |
      A user swiped to change the page of the top sites carousel
    extra_keys:
      page:
        description: |
          The page number the carousel is now on
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/14565
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/15136
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  long_press:
    type: event
    description: |
      A user long pressed on a top site
    extra_keys:
      type:
        description: |
          The type of top site. Options are: "FRECENCY," "DEFAULT," or "PINNED."
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/14565
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/15136
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_in_new_tab:
    type: event
    description: |
      A user opens a new tab based on a top site item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6757
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/7523
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  open_in_private_tab:
    type: event
    description: |
      A user opens a new private tab based on a top site item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6757
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/7523
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  remove:
    type: event
    description: |
      A user removes a top site item
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6757
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/7523
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

about_page:
  support_tapped:
    type: event
    description: |
      A user tapped on "Support" item from About page
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6834
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8047
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"
  privacy_notice_tapped:
    type: event
    description: |
      A user tapped on "Privacy notice" item from About page
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6834
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8047
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-07-01"

app_theme:
  dark_theme_selected:
    type: event
    description: |
      A user selected Dark Theme
    extra_keys:
      source:
        description: |
          The source from where dark theme was selected. The source can be
          'SETTINGS' or 'ONBOARDING'
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/7289
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/7968
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"

pocket:
  pocket_top_site_clicked:
    type: event
    description: |
      A user clicked on the trending Pocket top site
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8126
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8098
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
    no_lint:
      - COMMON_PREFIX
  pocket_top_site_removed:
    type: event
    description: |
      A user removed the trending Pocket top site
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8126
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8098
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

first_session:
  campaign:
    type: string
    send_in_pings:
      - first-session
    description: |
      The name of the campaign that is responsible for this installation.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/7295
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  network:
    type: string
    send_in_pings:
      - first-session
    description: |
      The name of the Network that sourced this installation.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/7295
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  adgroup:
    type: string
    send_in_pings:
      - first-session
    description: |
      The name of the AdGroup that was used to source this installation.
    bugs:
      - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586480836
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  creative:
    send_in_pings:
      - first-session
    type: string
    description: |
      The identifier of the creative material that the user interacted with.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/7295
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  timestamp:
    send_in_pings:
      - first-session
    type: datetime
    description: |
      The Glean generated date and time of the installation. This is
      unique per app install, though the rest of the data in this
      ping is from Adjust and will remain static across installs.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/7295
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

browser.search:
  with_ads:
    type: labeled_counter
    description: |
      Records counts of SERP pages with adverts displayed.
      The key format is `<provider-name>`.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6558
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10112
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/focus-android/pull/4968#issuecomment-879256443
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-07-01"
  ad_clicks:
    type: labeled_counter
    description: |
      Records clicks of adverts on SERP pages.
      The key format is `<provider-name>`.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6558
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10112
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/focus-android/pull/4968#issuecomment-879256443
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-07-01"
  in_content:
    type: labeled_counter
    description: |
      Records the type of interaction a user has on SERP pages.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6557
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10167
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/focus-android/pull/4968#issuecomment-879256443
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-07-01"

addons:
  open_addons_in_settings:
    type: event
    description: |
      A user accessed "Add-ons" from the Settings
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6174
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8318
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  open_addon_in_toolbar_menu:
    type: event
    description: |
      A user interacted with an installed add-on in the toolbar menu
    extra_keys:
      addon_id:
        description: |
          The id of the add-on that was interacted with in the toolbar menu
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6174
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8318
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  open_addon_setting:
    type: event
    description: |
      A user opened an add-on's setting
    extra_keys:
      addon_id:
        description: |
          The id of the add-on that was interacted with
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17644
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18504
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-08-01"
  has_installed_addons:
    type: boolean
    description: |
      Whether or not the user has installed add-ons on the device.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6174
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8318
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  has_enabled_addons:
    type: boolean
    description: |
      Whether or not the user has enabled add-ons on the device.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/6174
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/8318
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  installed_addons:
    type: string_list
    description: |
      A list of all installed add-ons on the device.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8920
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11080
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  enabled_addons:
    type: string_list
    description: |
      A list of all enabled add-ons on the device.
    send_in_pings:
      - metrics
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8920
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11080
      - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
      - https://github.com/mozilla-mobile/fenix/pull/18143
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"

startup.timeline:
  framework_primary:
    send_in_pings:
      - startup-timeline
    type: timespan
    time_unit: millisecond
    description: |
      The duration the Android framework takes to start before letting us run
      code in `*Application.init` when this device has
      `clock_ticks_per_second_v2` equal to 100: if it's not equal to 100, then
      this value is captured in `framework_secondary`. We split this into two
      metrics to make it easier to analyze in GLAM. We split on 100 because
      when we did our initial brief analysis -
      https://sql.telemetry.mozilla.org/queries/75591 - the results for clocks
      ticks were overwhelmingly 100.

      The duration is calculated from `appInitTimestamp -
      processStartTimestamp`. `processStartTimestamp` is derived from the clock
      tick time unit, which is expected to be less granular than nanoseconds.
      Therefore, we convert and round our timestamps to clock ticks before
      computing the difference and convert back to nanoseconds to report.

      For debugging purposes, `clock_ticks_per_second_v2`, which may vary
      between devices, is also reported as a metric
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8803
      - https://github.com/mozilla-mobile/fenix/issues/17972
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9788#pullrequestreview-394228626
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/18043#issue-575389284
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"
  framework_secondary:
    send_in_pings:
      - startup-timeline
    type: timespan
    time_unit: millisecond
    description: |
      The duration the Android framework takes to start before letting us run
      code in `*Application.init` when this device has
      `clock_ticks_per_second_v2` not equal to 100. For more details on this
      metric, see `framework_primary`
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17972
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18043#issue-575389284
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"
  framework_start_error:
    send_in_pings:
      - startup-timeline
    type: boolean
    description: |
      An error when attempting to record `framework_primary/secondary` - the
      application init timestamp returned a negative value - which is likely
      indicative of a bug in the implementation.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8803
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9788#pullrequestreview-394228626
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"
  framework_start_read_error:
    send_in_pings:
      - startup-timeline
    type: boolean
    description: |
      An error when attempting to read stats from /proc pseudo-filesystem -
      privacy managers can block access to reading these files -
      the application will catch a file reading exception.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10434
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10481
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"
  clock_ticks_per_second_v2:
    send_in_pings:
      - startup-timeline
    type: quantity
    unit: clock ticks per second
    description: |
      The number of clock tick time units that occur in one second on this
      particular device. This value is expected to be used in conjunction with
      the `framework_primary/secondary` metrics.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/8803
      - https://github.com/mozilla-mobile/fenix/issues/18157
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/9788#pullrequestreview-394228626
      - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
      - https://github.com/mozilla-mobile/fenix/pull/18158#issue-579593943
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"

perf.startup:
  cold_main_app_to_first_frame:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration from `*Application`'s initializer to the first Android frame
      being drawn in a [COLD MAIN start
      up](https://wiki.mozilla.org/index.php?title=Performance/Fenix/Glossary).
      Notably, this duration omits the time from process start to the
      initializer (which includes a lengthy dex operation) and the time from
      the first frame to visual completeness. This probe doesn't measure Custom
      Tabs or other uses of `ExternalAppBrowserActivity` to simplify result
      analysis. The methodology for determining this measurement is imperfect
      to simplify implementation. Issues may include:
      <br>- Not measuring Beta and Release channels (due to
      `MigrationDecisionActivity` interrupting the logic).
      <br>- Not distinguishing between MAIN to homescreen, onboarding, session
      restore, others?
      <br>- Not choosing to record a MAIN based on what the user would see and
      thus the core code path (i.e. the thing we want to measure) but rather on
      the initial `Intent` state.
      <br><br>
      The hope is that these cases will not have a significant impact on the end
      results but, if they appear to, we can replace it with a more complex
      implementation.
      <br><br>
      Around April 8, 2021 the implementation was refactored. Functionally, it
      should be the same but it's noted just in case there are bugs.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  cold_view_app_to_first_frame:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration from `*Application`'s initializer to the first Android frame
      being drawn in a [COLD VIEW start
      up](https://wiki.mozilla.org/index.php?title=Performance/Fenix/Glossary).
      The methodology for determining this measurement is imperfect to simplify
      implementation. Issues may include:
      <br>-Including VIEW intents that aren't valid so take code paths similar
      to MAIN (this is speculative)
      <br><br>
      See the `cold_main_app_to_first_frame` probe docs for other possible
      known issues and more details.
      <br><br>
      Around April 8, 2021 the implementation was refactored. Functionally, it
      should be the same but it's noted just in case there are bugs.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  cold_unknwn_app_to_first_frame:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration from `*Application`'s initializer to the first Android frame
      being drawn in a [COLD start
      up](https://wiki.mozilla.org/index.php?title=Performance/Fenix/Glossary)
      where we can't say it was a MAIN or VIEW start up. The methodology for
      determining this measurement is imperfect to simplify implementation.
      <br><br>
      See the `cold_main_app_to_first_frame` probe docs for known issues and
      more details.
      <br><br>
      Around April 8, 2021 the implementation was refactored. Functionally, it
      should be the same but it's noted just in case there are bugs.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  application_on_create:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration of `FenixApplication.onCreate` in the main process. This does
      not measure the duration of migration code (via
      `MigratingFenixApplication` included in the Beta and Release channels.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17973#issue-572183889
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  app_on_create_to_glean_init:
    type: timing_distribution
    time_unit: millisecond
    description: |
      A subsection of the duration of `FenixApplication.onCreate` and thus the
      `application_on_create` probe from the start of the method through when
      `initializeGlean` is called. Note: `initializeGlean` is a no-op for Beta
      and Release builds which instead initialize it during
      `MigratingFenixApplication`, which we don't currently measure.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18525#issue-594961170
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  app_on_create_to_megazord_init:
    type: timing_distribution
    time_unit: millisecond
    description: |
      A subsection of the duration of `FenixApplication.onCreate` and thus the
      `application_on_create` probe from after the `app_on_create_to_glean_init`
      probe until we block for the megazord to complete set up.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18525#issue-594961170
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  app_on_create_to_setup_in_main:
    type: timing_distribution
    time_unit: millisecond
    description: |
      A subsection of the duration of `FenixApplication.onCreate` and thus the
      `application_on_create` probe from after the
      `app_on_create_to_megazord_init` probe until the end of
      `setupInMainProcessOnly`, which is expected to be the end of the
      `onCreate` call (unless the implementation later changes).
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18525#issue-594961170
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  home_activity_on_create:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration of `HomeActivity.onCreate`.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17969
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17973#issue-572183889
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  home_activity_on_start:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration of `HomeActivity.onStart`. This may encapsulate
      `HomeFragment` or `BrowserFragment` creation, depending on the code path,
      so we expect this to take varying amounts of time. As such, this probe may
      not be easy to interpret directly but we believe collecting it may give us
      more information about different patterns we might see in performance
      data.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  home_fragment_on_create_view:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration of `HomeFragment.onCreateView`.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  home_fragment_on_view_created:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration of `HomeFragment.onViewCreated`.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  base_bfragment_on_create_view:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration of `BaseBrowserFragment.onCreateView`.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  base_bfragment_on_view_created:
    type: timing_distribution
    time_unit: millisecond
    description: |
      The duration of `BaseBrowserFragment.onViewCreated`.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18426
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
    data_sensitivity:
      - technical
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-11"
  startup_type:
    type: labeled_counter
    description: |
      Indicates how the browser was started. The label is divided into two
      variables. `state` is how cached the browser is when started. `path` is
      what code path we are expected to take. Together, they create a combined
      label: `state_path`. For brevity, the specific states are documented in
      the [Fenix perf
      glossary](https://wiki.mozilla.org/index.php?title=Performance/Fenix/Glossary).
      <br><br>
      This implementation is intended to be simple, not comprehensive. We list
      the implications below.

      <br><br>
      These ways of opening the app undesirably adds events to our primary
      buckets (non-`unknown` cases):
      <br>- App switcher cold/warm: `cold/warm_` + duplicates path from
      previous launch
      <br>- Home screen shortcuts: `*_view`
      <br>- An Intent is sent internally that's uses `ACTION_MAIN` or
      `ACTION_VIEW` could be: `*_main/view` (unknown if this ever happens)
      <br>- A command-line launch uses `ACTION_MAIN` or `ACTION_VIEW` could be:
      `*_main/view`

      <br><br>
      These ways of opening the app undesirably do not add their events to our
      primary buckets:
      <br>- Close and reopen the app very quickly: no event is recorded.

      <br><br>
      These ways of opening the app don't affect our primary buckets:
      <br>- App switcher hot: `hot_unknown`
      <br>- PWA (all states): `unknown_unknown`
      <br>- Custom tab: `unknown_view`
      <br>- Cold start where a service or other non-activity starts the process
      (not manually tested) - this seems to happen if you have the homescreen
      widget: `unknown_*`
      <br>- Another activity is drawn before HomeActivity (e.g. widget voice
      search): `unknown_*`
      <br>- Widget text search: `*_unknown`

      <br><br>
      In addition to the events above, the `unknown` state may be chosen when we
      were unable to determine a cause due to implementation details or the API
      was used incorrectly. We may be able to record the events listed above
      into different buckets but we kept the implementation simple for now.
      <br><br>
      N.B.: for implementation simplicity, we duplicate the logic in app that
      determines `path` so it's not perfectly accurate. In one way, we record we
      is intended to happen rather than what actually happened (e.g. the user
      may click a link so we record VIEW but the app does a MAIN by going to the
      homescreen because the link was invalid).
    labels:
      - cold_main
      - cold_view
      - cold_unknown
      - warm_main
      - warm_view
      - warm_unknown
      - hot_main
      - hot_view
      - hot_unknown
      - unknown_main
      - unknown_view
      - unknown_unknown
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18836
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19028
    data_sensitivity:
      - interaction
    notification_emails:
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-10-09"

perf.awesomebar:
  history_suggestions:
    send_in_pings:
      - metrics
    type: timing_distribution
    time_unit: millisecond
    description: >
      Duration of a history awesomebar suggestion query.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/4992
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - gkruglov@mozilla.com
    expires: "2021-11-15"
  bookmark_suggestions:
    send_in_pings:
      - metrics
    type: timing_distribution
    time_unit: millisecond
    description: >
      Duration of a bookmarks awesomebar suggestion query.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/4992
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - gkruglov@mozilla.com
    expires: "2021-11-15"
  search_engine_suggestions:
    send_in_pings:
      - metrics
    type: timing_distribution
    time_unit: millisecond
    description: >
      Duration of a search engine awesomebar suggestion query.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/4992
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - gkruglov@mozilla.com
    expires: "2021-11-15"
  session_suggestions:
    send_in_pings:
      - metrics
    type: timing_distribution
    time_unit: millisecond
    description: >
      Duration of a session awesomebar suggestion query.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/4992
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - gkruglov@mozilla.com
    expires: "2021-11-15"
  synced_tabs_suggestions:
    send_in_pings:
      - metrics
    type: timing_distribution
    time_unit: millisecond
    description: >
      Duration of a synced tabs awesomebar suggestion query.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/4992
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - gkruglov@mozilla.com
    expires: "2021-11-15"
  clipboard_suggestions:
    send_in_pings:
      - metrics
    type: timing_distribution
    time_unit: millisecond
    description: >
      Duration of a clipboard awesomebar suggestion query.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/4992
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - gkruglov@mozilla.com
    expires: "2021-11-15"
  shortcuts_suggestions:
    send_in_pings:
      - metrics
    type: timing_distribution
    time_unit: millisecond
    description: >
      Duration of a shortcuts awesomebar suggestion query.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/4992
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - gkruglov@mozilla.com
    expires: "2021-11-15"

autoplay:
  visited_setting:
    type: event
    description: A user visited the autoplay settings screen
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11579
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/13041#issuecomment-665777411
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  setting_changed:
    type: event
    description: |
      A user changed their autoplay setting to either block_cellular,
      block_audio, or block_all.
    extra_keys:
      autoplay_setting:
        description: |
          The new setting for autoplay: block_cellular,
          block_audio, or block_all.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11579
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/13041#issuecomment-665777411
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

storage.stats:
  query_stats_duration:
    send_in_pings:
      - metrics
    type: timing_distribution
    description: >
      How long it took to query the device for the StorageStats that contain the
      file size information. The docs say it may be expensive so we want to
      ensure it's not too expensive.  This value is only available on Android
      8+.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/12802
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12876#issuecomment-666770732
      - https://github.com/mozilla-mobile/fenix/pull/17704#issue-564299127
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"
  app_bytes:
    send_in_pings:
      - metrics
    type: memory_distribution
    description: >
      The size of the app's APK and related files as installed: this is expected
      to be larger than download size. This is the output of
      [StorageStats.getAppBytes](https://developer.android.com/reference/android/app/usage/StorageStats#getAppBytes())
      so see that for details. This value is only available on Android 8+. A
      similar value may be available on the Google Play dashboard: we can use
      this value to see if that value is reliable enough.
    memory_unit: byte
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/12802
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12876#issuecomment-666770732
      - https://github.com/mozilla-mobile/fenix/pull/17704#issue-564299127
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"
  cache_bytes:
    send_in_pings:
      - metrics
    type: memory_distribution
    description: >
      The size of all cached data in the app. This is the output of
      [StorageStats.getCacheBytes](https://developer.android.com/reference/android/app/usage/StorageStats#getCacheBytes())
      so see that for details. This value is only available on Android 8+.
    memory_unit: byte
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/12802
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12876#issuecomment-666770732
      - https://github.com/mozilla-mobile/fenix/pull/17704#issue-564299127
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"
  data_dir_bytes:
    send_in_pings:
      - metrics
    type: memory_distribution
    description: >
      The size of all data minus `cache_bytes`. This is the output of
      [StorageStats.getDataBytes](https://developer.android.com/reference/android/app/usage/StorageStats#getDataBytes())
      except we subtract the value of `cache_bytes` so the cache is not measured
      redundantly; see that method for details. This value is only available on
      Android 8+.
    memory_unit: byte
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/12802
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/12876#issuecomment-666770732
      - https://github.com/mozilla-mobile/fenix/pull/17704#issue-564299127
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - perf-android-fe@mozilla.com
      - mcomella@mozilla.com
    expires: "2021-08-01"

progressive_web_app:
  homescreen_tap:
    type: event
    description: |
      A user taps on PWA homescreen icon
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10261
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11859
      - https://github.com/mozilla-mobile/fenix/pull/18071
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2021-09-01"
  install_tap:
    type: event
    description: |
      A user installs a PWA. Could be a shortcut or added to homescreen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10261
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11859
      - https://github.com/mozilla-mobile/fenix/pull/18071
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2021-09-01"
  foreground:
    type: event
    description: |
      A user brings the PWA into the foreground.
    extra_keys:
      time_ms:
        description: |
          The current time in ms when the PWA was brought to the foreground.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10261
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11859
      - https://github.com/mozilla-mobile/fenix/pull/18071
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2021-09-01"
  background:
    type: event
    description: |
      A user puts the PWA into the background.
    extra_keys:
      time_ms:
        description: |
          The current time in ms when the PWA was backgrounded.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/10261
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/11859
      - https://github.com/mozilla-mobile/fenix/pull/18071
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
      - erichards@mozilla.com
    expires: "2021-09-01"

master_password:
  displayed:
    type: event
    description: |
      The master password migration dialog was displayed
    bugs:
      - https://github.com/mozilla-mobile/fenix/pull/14468#issuecomment-684114534
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/14468#issuecomment-684114534
      - https://github.com/mozilla-mobile/fenix/pull/18071
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-09-01"
  migration:
    type: event
    description: |
      Logins were successfully migrated using a master password.
    bugs:
      - https://github.com/mozilla-mobile/fenix/pull/14468#issuecomment-684114534
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/14468#issuecomment-684114534
      - https://github.com/mozilla-mobile/fenix/pull/18071
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-09-01"

tabs:
  setting_opened:
    type: event
    description: |
      The tab settings were opened.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/15347#issue-707408975
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/15811#issuecomment-706402952
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

banner_open_in_app:
  displayed:
    type: event
    description: |
      Open in App banner was shown.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16828
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17049
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  dismissed:
    type: event
    description: |
      User tapped 'dismiss' on Open in App banner.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16828
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17049
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"
  go_to_settings:
    type: event
    description: |
      User tapped 'go to settings' on Open in App banner.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/16828
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17049
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-08-01"

contextual_menu:
  copy_tapped:
    type: event
    description: |
      The context menu's 'copy' option was used.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11580
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16968
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  search_tapped:
    type: event
    description: |
      The context menu's 'search' option was used.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11580
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16968
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  select_all_tapped:
    type: event
    description: |
      The context menu's 'select all' option was used.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11580
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16968
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"
  share_tapped:
    type: event
    description: |
      The context menu's 'share' option was used.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/11580
      - https://github.com/mozilla-mobile/fenix/issues/19923
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/16968
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-12-01"

engine_tab:
  kills:
    type: labeled_counter
    labels:
      - foreground
      - background
    description: |
      How often was the content process of a foreground (selected) or
      background tab killed.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/9366
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17864
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
      - skaspari@mozilla.com
    expires: "2021-12-31"
  kill_foreground_age:
    type: timing_distribution
    time_unit: millisecond
    description: |
      Measures the age of the engine session of a foreground (selected) tab
      at the time its content process got killed.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/9366
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17864
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
      - skaspari@mozilla.com
    expires: "2021-12-31"
  kill_background_age:
    type: timing_distribution
    time_unit: millisecond
    description: |
      Measures the age of the engine session of a background tab at the
      time its content process got killed.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/9366
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/17864
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
      - skaspari@mozilla.com
    expires: "2021-12-31"
  foreground_metrics:
    type: event
    description: |
      Event collecting data about the state of tabs when the app comes back to
      the foreground.
    bugs:
      - https://github.com/mozilla-mobile/android-components/issues/9997
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18747#issuecomment-815731764
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
      - skaspari@mozilla.com
    expires: "2021-12-31"
    extra_keys:
      background_active_tabs:
        description: |
          Number of active tabs (with an engine session assigned) when the app
          went to the background.
      background_crashed_tabs:
        description: |
          Number of tabs marked as crashed when the app went to the background.
      background_total_tabs:
        description: |
          Number of total tabs when the app went to the background.
      foreground_active_tabs:
        description: |
          Number of active tabs (with an engine session assigned) when the
          app came back to the foreground.
      foreground_crashed_tabs:
        description: |
          Number of tabs marked as crashed when the app came back to the
          foreground.
      foreground_total_tabs:
        description: |
          Number of total tabs when the app came back to the foreground.
      time_in_background:
        description: |
          Time (in milliseconds) the app was in the background.

synced_tabs:
  synced_tabs_suggestion_clicked:
    type: event
    description: |
      The synced tab suggestion in awesomebar was clicked.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18163
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18172
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

awesomebar:
  bookmark_suggestion_clicked:
    type: event
    description: |
      The bookmark suggestion in awesomebar was clicked.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18068
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18090
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  clipboard_suggestion_clicked:
    type: event
    description: |
      The clipboard suggestion in awesomebar was clicked.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18068
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18090
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  history_suggestion_clicked:
    type: event
    description: |
      The history suggestion in awesomebar was clicked.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18068
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18090
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  search_action_clicked:
    type: event
    description: |
      The search action in awesomebar was clicked.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18068
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18090
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  search_suggestion_clicked:
    type: event
    description: |
      The search suggestion in awesomebar was clicked.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18068
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18090
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"
  opened_tab_suggestion_clicked:
    type: event
    description: |
      The opened tab suggestion in awesomebar was clicked.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18068
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18090
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
      - https://github.com/mozilla-mobile/fenix/pull/20517#pullrequestreview-718069041
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-02-01"

home_menu:
  settings_item_clicked:
    type: event
    description: The user clicked the settings option in home menu.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18856
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18987
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-01"

home_screen:
  home_screen_displayed:
    type: event
    description: The user clicked the settings option in home menu.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18856
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19025
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-01"

android_keystore_experiment:
  experiment_failure:
    type: event
    description: |
      Records an instance of an unexpected failure during the experiment
    extra_keys:
      failure_exception:
        description: |
          Exception class associated with an unexpected failure of this
          experiment, not caught by the other failure handlers.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17869
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-09-01"
  get_failure:
    type: event
    description: |
      Unexpected failure when trying to read from secure prefs.
    extra_keys:
      failure_exception:
        description: |
          Exception class associated with an unexpected failure of this
          experiment.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17869
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-09-01"
  get_result:
    type: event
    description: |
      Success when trying to read from secure prefs.
    extra_keys:
      result:
        description: |
          Result code identifying whether the read operation returned the
          expected value or not.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17869
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-09-01"
  write_failure:
    type: event
    description: |
      Unexpected failure when trying to write to secure prefs.
    extra_keys:
      failure_exception:
        description: |
          Exception class associated with an unexpected failure of this
          experiment.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17869
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-09-01"
  write_success:
    type: event
    description: |
      Success in writing to secure prefs.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17869
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-09-01"
  reset:
    type: event
    description: |
      An experiment failed, and was reset to run again in the future from a
      blank state.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/17869
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - technical
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-09-01"

set_default_newtab_experiment:
  set_default_browser_clicked:
    type: event
    description: |
      Set default browser was clicked from new tab screen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18853
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18895
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-01"
  close_experiment_card_clicked:
    type: event
    description: |
      Close experiment card was clicked from new tab screen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18853
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/18895
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-01"

set_default_setting_experiment:
  set_default_browser_clicked:
    type: event
    description: |
      Set default browser was clicked from settings screen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/18852
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19047
      - https://github.com/mozilla-mobile/fenix/pull/19924#issuecomment-861423789
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2021-10-01"
start_on_home:
  enter_home_screen:
    type: event
    description: |
      Know how often user lands on Homescreen upon opening the app.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/19881
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19885
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-06-16"
  open_tabs_tray:
    type: event
    description: |
      Know how often users open the tab tray.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/19881
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/19885
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-06-16"
recent_tabs:
  show_all_clicked:
    type: event
    description: |
      User has clicked show all button and opened tabs tray.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/19955
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/20138
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-06-23"
  recent_tab_opened:
    type: event
    description: |
      User has opened a recent tab from homescreen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/19955
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/20138
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-06-23"
  in_progress_media_tab_opened:
    type: event
    description: |
      User has opened a recent tab from homescreen.
    bugs:
      - https://github.com/mozilla-mobile/fenix/issues/20393
    data_reviews:
      - https://github.com/mozilla-mobile/fenix/pull/20138
    data_sensitivity:
      - interaction
    notification_emails:
      - android-probes@mozilla.com
    expires: "2022-06-23"