mobile/android/fenix/app/metrics.yaml

   1 # This Source Code Form is subject to the terms of the Mozilla Public
   2 # License, v. 2.0. If a copy of the MPL was not distributed with this
   3 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
   4 ---
   5 $schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
   6
   7 no_lint:
   8   - CATEGORY_GENERIC
   9
  10 events:
  11   app_opened_all_startup:
  12     type: event
  13     description: |
  14       **This probe has a known flaw:** for COLD start up, it doesn't take into
  15       account if the process is already running when the app starts, possibly
  16       inflating results (e.g. a Service started the process 20min ago and only
  17       now is HomeActivity launching). See the `cold_*_app_to_first_frame` probes
  18       for a replacement.
  19       <br><br>
  20       A user opened the app to the HomeActivity. The HomeActivity
  21       encompasses the home screen, browser screen, settings screen,
  22       collections and other screens in the nav_graph.
  23       This differs from the app_opened probe because it measures all
  24       startups, not just cold startup. Note: There is a short gap
  25       between the time application goes into background and the time
  26       android reports the application going into the background.
  27       Note: This metric does not record souce when app opened from
  28       task switcher: open application -> press home button -> open
  29       recent tasks -> choose fenix. In this case will report
  30       [source = unknown, type = hot, has_saved_instance_state = false].
  31     extra_keys:
  32       type:
  33         description: |
  34           the startup type for opening fenix. the application and HomeActivity
  35           either needs to be created or started again. possible values are
  36           `cold`, `warm`, `hot` or `error`. Error is for impossible cases.
  37           Please file a bug if you see the error case.
  38           app created AND HomeActivity created = cold
  39           app started AND HomeActivity created = warm
  40           app started AND HomeActivity started = hot
  41           app created AND HomeActivity started = error
  42           Some applications such as gmail launches the default browser in the
  43           background. So when we eventually click a link, browser is already
  44           started in the background. This means that custom_tab will mostly
  45           report `warm` startup type.
  46       source:
  47         description: |
  48           The method used to open Fenix. Possible values are `app_icon`,
  49           `custom_tab`, `link` or `unknown`. unknown is for startup sources
  50           where we can't pinpoint the cause. One UNKNOWN case is the app
  51           switcher where we don't know what variables to check to ensure this
  52           startup wasn't caused by something else.
  53       has_saved_instance_state:
  54         description: |
  55           boolean value whether or not startup type has a savedInstance.
  56           using savedInstance, HomeActivity's previous state can be restored.
  57           This is an optional key since it is not applicable to all the cases.
  58           for example, when we are doing a hot start up, we cant have a
  59           savedInstanceState therefore we report only [APP_ICON, HOT] instead
  60           of [APP_ICON, HOT, false].
  61       first_frame_pre_draw_nanos:
  62         description: |
  63           the number of nanoseconds the application took to launch. This is the
  64           time difference between application launch(user pressing app_icon,
  65           launching a link) and until the first view is about to be drawn
  66           on the screen. If the time is not captured, this extra key will
  67           not be reported.
  68     bugs:
  69       - https://github.com/mozilla-mobile/fenix/issues/11830
  70       - https://github.com/mozilla-mobile/fenix/issues/12573
  71       - https://github.com/mozilla-mobile/fenix/pull/13494
  72       - https://github.com/mozilla-mobile/fenix/issues/10069
  73     data_reviews:
  74       - https://github.com/mozilla-mobile/fenix/pull/12114#pullrequestreview-445245341
  75       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
  76       - https://github.com/mozilla-mobile/fenix/pull/13494#pullrequestreview-474050499
  77       - https://github.com/mozilla-mobile/fenix/pull/15605#issuecomment-702365594
  78     data_sensitivity:
  79       - interaction
  80     notification_emails:
  81       - esmyth@mozilla.com
  82       - perf-android-fe@mozilla.com
  83     expires: "2021-06-01"
  84   app_received_intent:
  85     type: event
  86     description: |
  87       The system received an Intent for the HomeActivity. An intent
  88       is received an external entity wants to the app to display
  89       content. Intents can be received when the app is closed – at
  90       which point the app will be opened – or when the app is
  91       already opened – at which point the already open app will make
  92       changes such as loading a url. This can be used loosely as a
  93       heuristic for when the user requested to open the app. The
  94       HomeActivity encompasses the home screen and browser screen but
  95       may include other screens. This differs from the app_opened
  96       probe because it measures all startups, not just cold startup.
  97     extra_keys:
  98       source:
  99         description: |
 100           The method used to open Fenix. Possible values are `app_icon`,
 101           `custom_tab`, `link` or `unknown`
 102     bugs:
 103       - https://github.com/mozilla-mobile/fenix/issues/11830
 104     data_reviews:
 105       - https://github.com/mozilla-mobile/fenix/pull/11940/
 106       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 107     notification_emails:
 108       - esmyth@mozilla.com
 109       - perf-android-fe@mozilla.com
 110     expires: "2021-06-01"
 111   app_opened:
 112     type: event
 113     description: |
 114       A user opened the app (from cold start, to the homescreen or browser)
 115     extra_keys:
 116       source:
 117         description: |
 118           The method used to open Fenix. Possible values are: `app_icon`,
 119           `custom_tab` or `link`
 120     bugs:
 121       - https://github.com/mozilla-mobile/fenix/issues/968
 122       - https://github.com/mozilla-mobile/fenix/issues/10616
 123     data_reviews:
 124       - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
 125       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 126       - https://github.com/mozilla-mobile/fenix/pull/18143
 127     data_sensitivity:
 128       - interaction
 129     notification_emails:
 130       - telemetry-client-dev@mozilla.com
 131       - fenix-core@mozilla.com
 132     expires: "2021-07-01"
 133   search_bar_tapped:
 134     type: event
 135     description: |
 136       A user tapped the search bar
 137     extra_keys:
 138       source:
 139         description: |
 140           The view the user was on when they initiated the search (For example:
 141           `Home` or `Browser`)
 142     bugs:
 143       - https://github.com/mozilla-mobile/fenix/issues/959
 144     data_reviews:
 145       - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
 146       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 147       - https://github.com/mozilla-mobile/fenix/pull/18143
 148     data_sensitivity:
 149       - interaction
 150     notification_emails:
 151       - fenix-core@mozilla.com
 152     expires: "2021-07-01"
 153   entered_url:
 154     type: event
 155     description: |
 156       A user entered a url
 157     extra_keys:
 158       autocomplete:
 159         description: |
 160           A boolean that tells us whether the URL was autofilled by an
 161           Autocomplete suggestion
 162     bugs:
 163       - https://github.com/mozilla-mobile/fenix/issues/959
 164     data_reviews:
 165       - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
 166       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 167       - https://github.com/mozilla-mobile/fenix/pull/18143
 168     data_sensitivity:
 169       - interaction
 170     notification_emails:
 171       - fenix-core@mozilla.com
 172     expires: "2021-07-01"
 173   performed_search:
 174     type: event
 175     description: |
 176       A user performed a search
 177     extra_keys:
 178       source:
 179         description: |
 180           A string that tells us how the user performed the search. Possible
 181           values are:
 182
 183           * default.action
 184           * default.suggestion
 185           * shortcut.action
 186           * shortcut.suggestion
 187     bugs:
 188       - https://github.com/mozilla-mobile/fenix/issues/959
 189     data_reviews:
 190       - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
 191       - https://github.com/mozilla-mobile/fenix/pull/1677
 192       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 193       - https://github.com/mozilla-mobile/fenix/pull/18143
 194     data_sensitivity:
 195       - interaction
 196     notification_emails:
 197       - fenix-core@mozilla.com
 198     expires: "2021-07-01"
 199   browser_menu_action:
 200     type: event
 201     description: |
 202       A browser menu item was tapped
 203     extra_keys:
 204       item:
 205         description: |
 206           A string containing the name of the item the user tapped. These items
 207           include:
 208
 209             Settings, Help, Desktop Site toggle on/off, Find in Page,
 210             New Tab, Private Tab, Share, Report Site Issue, Back/Forward button,
 211             Reload Button, Quit, Reader Mode On, Reader Mode Off, Open In app,
 212             Add To Top Sites, Add-ons Manager, Bookmarks, History
 213     bugs:
 214       - https://github.com/mozilla-mobile/fenix/issues/1024
 215     data_reviews:
 216       - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
 217       - https://github.com/mozilla-mobile/fenix/pull/5098#issuecomment-529658996
 218       - https://github.com/mozilla-mobile/fenix/pull/6310
 219       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 220       - https://github.com/mozilla-mobile/fenix/pull/18143
 221     data_sensitivity:
 222       - interaction
 223     notification_emails:
 224       - fenix-core@mozilla.com
 225     expires: "2021-07-01"
 226   total_uri_count:
 227     type: counter
 228     description: |
 229       A counter of URIs visited by the user in the current session, including
 230       page reloads. This does not include background page requests and URIs from
 231       embedded pages or private browsing but may be incremented without user
 232       interaction by website scripts that programmatically redirect to a new
 233       location.
 234     send_in_pings:
 235       - metrics
 236     bugs:
 237       - https://github.com/mozilla-mobile/fenix/issues/1301
 238       - https://github.com/mozilla-mobile/fenix/issues/4456
 239     data_reviews:
 240       - https://github.com/mozilla-mobile/fenix/pull/1785
 241       - https://github.com/mozilla-mobile/fenix/pull/8314
 242       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 243     data_sensitivity:
 244       - interaction
 245     notification_emails:
 246       - fenix-core@mozilla.com
 247     expires: "2021-08-01"
 248   normal_and_private_uri_count:
 249     type: counter
 250     description: |
 251       A counter of URIs visited by the user in the current session, including
 252       page reloads. This includes private browsing.  This does not include
 253       background page requests and URIs from embedded pages but may be
 254       incremented without user interaction by website scripts that
 255       programmatically redirect to a new location.
 256     send_in_pings:
 257       - metrics
 258     bugs:
 259       - https://github.com/mozilla-mobile/fenix/issues/17089
 260     data_reviews:
 261       - https://github.com/mozilla-mobile/fenix/pull/17935
 262     data_sensitivity:
 263       - interaction
 264     notification_emails:
 265       - fenix-core@mozilla.com
 266     expires: "2022-08-01"
 267   preference_toggled:
 268     type: event
 269     description: |
 270       A user toggled a boolean preference in settings
 271     extra_keys:
 272       preference_key:
 273         description: |
 274           The preference key for the boolean (true/false) preference the user
 275           toggled.
 276
 277           We currently track: show_search_suggestions, remote_debugging,
 278           telemetry, tracking_protection, search_bookmarks,
 279           search_browsing_history, show_clipboard_suggestions,
 280           show_search_shortcuts, open_links_in_a_private_tab (bug in
 281           implementation https://github.com/mozilla-mobile/fenix/issues/7384),
 282           pref_key_sync_logins, pref_key_sync_bookmarks, pref_key_sync_history,
 283           pref_key_show_voice_search,
 284           and pref_key_show_search_suggestions_in_private.
 285       enabled:
 286         description: "Whether or not the preference is *now* enabled"
 287     bugs:
 288       - https://github.com/mozilla-mobile/fenix/issues/975
 289       - https://github.com/mozilla-mobile/fenix/issues/5094
 290       - https://github.com/mozilla-mobile/fenix/issues/5737
 291       - https://github.com/mozilla-mobile/fenix/issues/5586
 292       - https://github.com/mozilla-mobile/fenix/issues/6396
 293       - https://github.com/mozilla-mobile/fenix/issues/6070
 294     data_reviews:
 295       - https://github.com/mozilla-mobile/fenix/pull/1896
 296       - https://github.com/mozilla-mobile/fenix/pull/5704
 297       - https://github.com/mozilla-mobile/fenix/pull/5886
 298       - https://github.com/mozilla-mobile/fenix/pull/5975
 299       - https://github.com/mozilla-mobile/fenix/pull/6352
 300       - https://github.com/mozilla-mobile/fenix/pull/6601
 301       - https://github.com/mozilla-mobile/fenix/pull/6746
 302       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 303     data_sensitivity:
 304       - technical
 305       - interaction
 306     notification_emails:
 307       - fenix-core@mozilla.com
 308     expires: "2021-06-01"
 309   whats_new_tapped:
 310     type: event
 311     description: |
 312       A user opened the "what's new" page button
 313     bugs:
 314       - https://github.com/mozilla-mobile/fenix/issues/5021
 315     data_reviews:
 316       - https://github.com/mozilla-mobile/fenix/pull/5090
 317       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 318       - https://github.com/mozilla-mobile/fenix/pull/18143
 319     data_sensitivity:
 320       - interaction
 321     notification_emails:
 322       - fenix-core@mozilla.com
 323     expires: "2021-07-01"
 324   opened_link:
 325     type: event
 326     description: |
 327       A user opened a link with Fenix
 328     extra_keys:
 329       mode:
 330         description: |
 331           The mode the link was opened in. Either 'PRIVATE' or 'NORMAL'. N.B.:
 332           this probe may be incorrectly implemented: see
 333           https://github.com/mozilla-mobile/fenix/issues/14133
 334     bugs:
 335       - https://github.com/mozilla-mobile/fenix/issues/5737
 336     data_reviews:
 337       - https://github.com/mozilla-mobile/fenix/pull/5975
 338       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 339       - https://github.com/mozilla-mobile/fenix/pull/18143
 340     data_sensitivity:
 341       - interaction
 342     notification_emails:
 343       - fenix-core@mozilla.com
 344     expires: "2021-07-01"
 345   tab_counter_menu_action:
 346     type: event
 347     description:
 348       A tab counter menu item was tapped
 349     extra_keys:
 350       item:
 351         description: |
 352           A string containing the name of the item the user tapped. These items
 353           are:
 354
 355             New tab, New private tab, Close tab
 356     bugs:
 357       - https://github.com/mozilla-mobile/fenix/issues/11442
 358     data_reviews:
 359       - https://github.com/mozilla-mobile/fenix/pull/11533
 360       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 361       - https://github.com/mozilla-mobile/fenix/pull/18143
 362     data_sensitivity:
 363       - interaction
 364     notification_emails:
 365       - fenix-core@mozilla.com
 366     expires: "2021-07-01"
 367   synced_tab_opened:
 368     type: event
 369     description: >
 370       An event that indicates that a synced tab was opened.
 371     bugs:
 372       - https://github.com/mozilla-mobile/fenix/issues/15369
 373     data_reviews:
 374       - https://github.com/mozilla-mobile/fenix/pull/16727
 375     data_sensitivity:
 376       - interaction
 377     notification_emails:
 378       - fenix-core@mozilla.com
 379     expires: "2021-05-10"
 380   recently_closed_tabs_opened:
 381     type: event
 382     description: |
 383       An event that indicates that the user
 384       has accessed recently closed tabs list.
 385     bugs:
 386       - https://github.com/mozilla-mobile/fenix/issues/15366
 387     data_reviews:
 388       - https://github.com/mozilla-mobile/fenix/pull/16739
 389     data_sensitivity:
 390       - interaction
 391     notification_emails:
 392       - fenix-core@mozilla.com
 393     expires: "2021-05-10"
 394   copy_url_tapped:
 395     type: event
 396     description: |
 397       An event that indicates that a user has selected
 398       copy option when long pressing on url bar.
 399     bugs:
 400       - https://github.com/mozilla-mobile/fenix/issues/16827
 401     data_reviews:
 402       - https://github.com/mozilla-mobile/fenix/pull/16915
 403     data_sensitivity:
 404       - interaction
 405     notification_emails:
 406       - fenix-core@mozilla.com
 407     expires: "2021-05-10"
 408
 409 onboarding:
 410   fxa_auto_signin:
 411     type: event
 412     description:
 413       The onboarding automatic sign in card was tapped.
 414     bugs:
 415       - https://github.com/mozilla-mobile/fenix/issues/10824
 416     data_reviews:
 417       - https://github.com/mozilla-mobile/fenix/pull/11867
 418       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 419     data_sensitivity:
 420       - interaction
 421     notification_emails:
 422       - fenix-core@mozilla.com
 423       - erichards@mozilla.com
 424     expires: "2021-08-01"
 425   fxa_manual_signin:
 426     type: event
 427     description:
 428       The onboarding manual sign in card was tapped.
 429     bugs:
 430       - https://github.com/mozilla-mobile/fenix/issues/10824
 431     data_reviews:
 432       - https://github.com/mozilla-mobile/fenix/pull/11867
 433       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 434     data_sensitivity:
 435       - interaction
 436     notification_emails:
 437       - fenix-core@mozilla.com
 438       - erichards@mozilla.com
 439     expires: "2021-08-01"
 440   privacy_notice:
 441     type: event
 442     description:
 443       The onboarding privacy notice card was tapped.
 444     bugs:
 445       - https://github.com/mozilla-mobile/fenix/issues/10824
 446     data_reviews:
 447       - https://github.com/mozilla-mobile/fenix/pull/11867
 448       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 449     data_sensitivity:
 450       - interaction
 451     notification_emails:
 452       - fenix-core@mozilla.com
 453       - erichards@mozilla.com
 454     expires: "2021-08-01"
 455   pref_toggled_private_browsing:
 456     type: event
 457     description:
 458       The private browsing preference was selected from the onboarding card.
 459     bugs:
 460       - https://github.com/mozilla-mobile/fenix/issues/10824
 461     data_reviews:
 462       - https://github.com/mozilla-mobile/fenix/pull/11867
 463       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 464     data_sensitivity:
 465       - interaction
 466     notification_emails:
 467       - fenix-core@mozilla.com
 468       - erichards@mozilla.com
 469     expires: "2021-08-01"
 470   pref_toggled_toolbar_position:
 471     type: event
 472     description:
 473       The toolbar position preference was chosen from the onboarding card.
 474     extra_keys:
 475       position:
 476         description: |
 477           A string that indicates the position of the toolbar TOP or BOTTOM.
 478           Default: BOTTOM
 479     bugs:
 480       - https://github.com/mozilla-mobile/fenix/issues/10824
 481     data_reviews:
 482       - https://github.com/mozilla-mobile/fenix/pull/11867
 483       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 484     data_sensitivity:
 485       - interaction
 486     notification_emails:
 487       - fenix-core@mozilla.com
 488       - erichards@mozilla.com
 489     expires: "2021-08-01"
 490   pref_toggled_tracking_prot:
 491     type: event
 492     description:
 493       The tracking protection preference was chosen from the onboarding card.
 494     extra_keys:
 495       setting:
 496         description: |
 497           A string that indicates the Tracking Protection policy STANDARD
 498           or STRICT. Default: Toggle ON, STANDARD
 499     bugs:
 500       - https://github.com/mozilla-mobile/fenix/issues/10824
 501     data_reviews:
 502       - https://github.com/mozilla-mobile/fenix/pull/11867
 503       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 504     data_sensitivity:
 505       - interaction
 506     notification_emails:
 507       - fenix-core@mozilla.com
 508       - erichards@mozilla.com
 509     expires: "2021-08-01"
 510   pref_toggled_theme_picker:
 511     type: event
 512     description:
 513       The device theme was chosen using the theme picker onboarding card.
 514     extra_keys:
 515       theme:
 516         description: |
 517           A string that indicates the theme LIGHT, DARK, or FOLLOW DEVICE.
 518           Default: FOLLOW DEVICE
 519     bugs:
 520       - https://github.com/mozilla-mobile/fenix/issues/10824
 521     data_reviews:
 522       - https://github.com/mozilla-mobile/fenix/pull/11867
 523       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 524     data_sensitivity:
 525       - interaction
 526     notification_emails:
 527       - fenix-core@mozilla.com
 528       - erichards@mozilla.com
 529     expires: "2021-08-01"
 530   finish:
 531     type: event
 532     description:
 533       The user taps starts browsing and ends the onboarding experience.
 534     bugs:
 535       - https://github.com/mozilla-mobile/fenix/issues/10824
 536     data_reviews:
 537       - https://github.com/mozilla-mobile/fenix/pull/11867
 538       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 539     data_sensitivity:
 540       - interaction
 541     notification_emails:
 542       - fenix-core@mozilla.com
 543       - erichards@mozilla.com
 544     expires: "2021-08-01"
 545
 546 search_shortcuts:
 547   selected:
 548     type: event
 549     description: |
 550       A user selected a search shortcut engine to use
 551     extra_keys:
 552       engine:
 553         description: |
 554           The name of the built-in search engine the user selected as a string
 555     bugs:
 556       - https://github.com/mozilla-mobile/fenix/issues/793
 557     data_reviews:
 558       - https://github.com/mozilla-mobile/fenix/pull/1202#issuecomment-476870449
 559       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 560     notification_emails:
 561       - fenix-core@mozilla.com
 562     expires: "2021-08-01"
 563
 564 toolbar_settings:
 565   changed_position:
 566     type: event
 567     description: |
 568       The user selected a new position for the toolbar
 569     extra_keys:
 570       position:
 571         description: |
 572           A string that indicates the new position of the toolbar TOP or BOTTOM
 573     bugs:
 574       - https://github.com/mozilla-mobile/fenix/issues/6054
 575     data_reviews:
 576       - https://github.com/mozilla-mobile/fenix/pull/6608
 577       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 578     data_sensitivity:
 579       - interaction
 580     notification_emails:
 581       - fenix-core@mozilla.com
 582     expires: "2021-08-01"
 583
 584 crash_reporter:
 585   opened:
 586     type: event
 587     description: |
 588       The crash reporter was displayed
 589     bugs:
 590       - https://github.com/mozilla-mobile/fenix/issues/1040
 591     data_reviews:
 592       - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
 593       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 594       - https://github.com/mozilla-mobile/fenix/pull/18143
 595     data_sensitivity:
 596       - interaction
 597     notification_emails:
 598       - fenix-core@mozilla.com
 599     expires: "2021-07-01"
 600   closed:
 601     type: event
 602     description: |
 603       The crash reporter was closed
 604     extra_keys:
 605       crash_submitted:
 606         description: |
 607           A boolean that tells us whether or not the user submitted a crash
 608           report
 609     bugs:
 610       - https://github.com/mozilla-mobile/fenix/issues/1040
 611     data_reviews:
 612       - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
 613       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 614       - https://github.com/mozilla-mobile/fenix/pull/18143
 615     data_sensitivity:
 616       - interaction
 617     notification_emails:
 618       - fenix-core@mozilla.com
 619     expires: "2021-07-01"
 620
 621 context_menu:
 622   item_tapped:
 623     type: event
 624     description: |
 625       A user tapped an item in the browsers context menu
 626     extra_keys:
 627       named:
 628         description: |
 629           The name of the item that was tapped. Available items are:
 630
 631           ```
 632           open_in_new_tab, open_in_private_tab, open_image_in_new_tab,
 633           save_image, share_link, copy_link, copy_image_location, share_image
 634           ```
 635     bugs:
 636       - https://github.com/mozilla-mobile/fenix/issues/957
 637       - https://github.com/mozilla-mobile/fenix/issues/16076
 638     data_reviews:
 639       - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
 640       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
 641       - https://github.com/mozilla-mobile/fenix/issues/16076#issuecomment-726216734
 642       - https://github.com/mozilla-mobile/fenix/pull/18143
 643     data_sensitivity:
 644       - interaction
 645     notification_emails:
 646       - fenix-core@mozilla.com
 647     expires: "2021-07-01"
 648
 649 login_dialog:
 650   displayed:
 651     type: event
 652     description: |
 653       The login dialog prompt was displayed
 654     bugs:
 655       - https://github.com/mozilla-mobile/fenix/issues/9730
 656     data_reviews:
 657       - https://github.com/mozilla-mobile/fenix/pull/13050
 658     data_sensitivity:
 659       - interaction
 660     notification_emails:
 661       - fenix-core@mozilla.com
 662     expires: "2021-08-01"
 663   cancelled:
 664     type: event
 665     description: |
 666       The login dialog prompt was cancelled
 667     bugs:
 668       - https://github.com/mozilla-mobile/fenix/issues/9730
 669     data_reviews:
 670       - https://github.com/mozilla-mobile/fenix/pull/13050
 671     data_sensitivity:
 672       - interaction
 673     notification_emails:
 674       - fenix-core@mozilla.com
 675     expires: "2021-08-01"
 676   saved:
 677     type: event
 678     description: |
 679       The login dialog prompt "save" button was pressed
 680     bugs:
 681       - https://github.com/mozilla-mobile/fenix/issues/9730
 682     data_reviews:
 683       - https://github.com/mozilla-mobile/fenix/pull/13050
 684     data_sensitivity:
 685       - interaction
 686     notification_emails:
 687       - fenix-core@mozilla.com
 688     expires: "2021-08-01"
 689   never_save:
 690     type: event
 691     description: |
 692       The login dialog prompt "never save" button was pressed
 693     bugs:
 694       - https://github.com/mozilla-mobile/fenix/issues/9730
 695     data_reviews:
 696       - https://github.com/mozilla-mobile/fenix/pull/13050
 697     data_sensitivity:
 698       - interaction
 699     notification_emails:
 700       - fenix-core@mozilla.com
 701     expires: "2021-08-01"
 702
 703 find_in_page:
 704   opened:
 705     type: event
 706     description: |
 707       A user opened the find in page UI
 708     bugs:
 709       - https://github.com/mozilla-mobile/fenix/issues/1036
 710     data_reviews:
 711       - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
 712       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 713     data_sensitivity:
 714       - interaction
 715     notification_emails:
 716       - fenix-core@mozilla.com
 717     expires: "2021-08-01"
 718   closed:
 719     type: event
 720     description: |
 721       A user closed the find in page UI
 722     bugs:
 723       - https://github.com/mozilla-mobile/fenix/issues/1036
 724     data_reviews:
 725       - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
 726       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 727     data_sensitivity:
 728       - interaction
 729     notification_emails:
 730       - fenix-core@mozilla.com
 731     expires: "2021-08-01"
 732   searched_page:
 733     type: event
 734     description: |
 735       A user searched the page
 736     bugs:
 737       - https://github.com/mozilla-mobile/fenix/issues/1036
 738     data_reviews:
 739       - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
 740       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 741     data_sensitivity:
 742       - interaction
 743     notification_emails:
 744       - fenix-core@mozilla.com
 745     expires: "2021-08-01"
 746
 747 metrics:
 748   default_browser:
 749     type: boolean
 750     lifetime: application
 751     description: |
 752       Is Fenix the default browser?
 753     send_in_pings:
 754       - metrics
 755     bugs:
 756       - https://github.com/mozilla-mobile/fenix/issues/960
 757     data_reviews:
 758       - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
 759       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 760     data_sensitivity:
 761       - interaction
 762     notification_emails:
 763       - fenix-core@mozilla.com
 764     expires: "2021-08-01"
 765   distribution_id:
 766     type: string
 767     lifetime: application
 768     description: |
 769       A string containing the distribution identifier. This is currently used
 770       to identify installs from Mozilla Online.
 771     send_in_pings:
 772       - metrics
 773     bugs:
 774       - https://github.com/mozilla-mobile/fenix/issues/16075
 775     data_reviews:
 776       - https://github.com/mozilla-mobile/fenix/issues/16075
 777     data_sensitivity:
 778       - technical
 779     notification_emails:
 780       - fenix-core@mozilla.com
 781     expires: never
 782   mobile_bookmarks_count:
 783     type: counter
 784     lifetime: application
 785     description: |
 786       A counter that indicates how many bookmarks a user has in the mobile
 787       folder. This value will only be set if the user has at least *one*
 788       bookmark. If they have 0, this ping will not get sent, resulting in
 789       a null value. To disambiguate between a failed `mobile_bookmarks_count`
 790       ping and 0 bookmarks, please see `has_mobile_bookmarks`.
 791     send_in_pings:
 792       - metrics
 793     bugs:
 794       - https://github.com/mozilla-mobile/fenix/issues/16941
 795     data_reviews:
 796       - https://github.com/mozilla-mobile/fenix/pull/16942
 797       - https://github.com/mozilla-mobile/fenix/pull/16942#issuecomment-742794701
 798     data_sensitivity:
 799       - interaction
 800     notification_emails:
 801       - fenix-core@mozilla.com
 802     expires: "2021-08-01"
 803   has_mobile_bookmarks:
 804     type: boolean
 805     lifetime: application
 806     description: |
 807       A boolean that indicates if the user has bookmarks in the mobile folder
 808     send_in_pings:
 809       - metrics
 810     bugs:
 811       - https://github.com/mozilla-mobile/fenix/issues/16941
 812     data_reviews:
 813       - https://github.com/mozilla-mobile/fenix/pull/16942
 814       - https://github.com/mozilla-mobile/fenix/pull/16942#issuecomment-742794701
 815     data_sensitivity:
 816       - interaction
 817     notification_emails:
 818       - fenix-core@mozilla.com
 819     expires: "2021-08-01"
 820   desktop_bookmarks_count:
 821     type: counter
 822     lifetime: application
 823     description: |
 824       A counter that indicates how many bookmarks a user has in the desktop
 825       folder. This value will only be set if the user has at least *one*
 826       bookmark. If they have 0, this ping will not get sent, resulting in a
 827       null value. To disambiguate between a failed `desktop_bookmarks_count`
 828       ping and 0 bookmarks, please see `has_desktop_bookmarks`.
 829     send_in_pings:
 830       - metrics
 831     bugs:
 832       - https://github.com/mozilla-mobile/fenix/issues/16941
 833     data_reviews:
 834       - https://github.com/mozilla-mobile/fenix/pull/16942
 835       - https://github.com/mozilla-mobile/fenix/pull/16942#issuecomment-742794701
 836     data_sensitivity:
 837       - interaction
 838     notification_emails:
 839       - fenix-core@mozilla.com
 840     expires: "2021-08-01"
 841   has_desktop_bookmarks:
 842     type: boolean
 843     lifetime: application
 844     description: |
 845       A boolean that indicates if the user has bookmarks in the desktop folder
 846     send_in_pings:
 847       - metrics
 848     bugs:
 849       - https://github.com/mozilla-mobile/fenix/issues/16941
 850     data_reviews:
 851       - https://github.com/mozilla-mobile/fenix/pull/16942
 852       - https://github.com/mozilla-mobile/fenix/pull/16942#issuecomment-742794701
 853     data_sensitivity:
 854       - interaction
 855     notification_emails:
 856       - fenix-core@mozilla.com
 857     expires: "2021-08-01"
 858   top_sites_count:
 859     type: counter
 860     lifetime: application
 861     description: |
 862       A counter that indicates how many top sites a user has. This value will
 863       only be set if the user has at least *one* top site. If they have 0,
 864       this ping will not get sent, resulting in a null value. To disambiguate
 865       between a failed `top_sites_count` ping and 0 top sites, please see
 866       `has_top_sites`.
 867     send_in_pings:
 868       - metrics
 869     bugs:
 870       - https://github.com/mozilla-mobile/fenix/issues/8125
 871     data_reviews:
 872       - https://github.com/mozilla-mobile/fenix/pull/9556
 873       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 874     data_sensitivity:
 875       - interaction
 876     notification_emails:
 877       - fenix-core@mozilla.com
 878     expires: "2021-08-01"
 879   has_top_sites:
 880     type: boolean
 881     lifetime: application
 882     description: |
 883       A boolean that indicates if the user has top sites
 884     send_in_pings:
 885       - metrics
 886     bugs:
 887       - https://github.com/mozilla-mobile/fenix/issues/8125
 888     data_reviews:
 889       - https://github.com/mozilla-mobile/fenix/pull/9556
 890       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 891     data_sensitivity:
 892       - interaction
 893     notification_emails:
 894       - fenix-core@mozilla.com
 895     expires: "2021-08-01"
 896   recently_used_pwa_count:
 897     type: counter
 898     lifetime: application
 899     description: |
 900       A counter that indicates how many PWAs a user has recently used.
 901       Threshold for "recency" set in HomeActivity#PWA_RECENTLY_USED_THRESHOLD.
 902       Currently we are not told by the OS when a PWA is removed by the user,
 903       so we use the "recently used" heuristic to judge how many PWAs are still
 904       active, as a proxy for "installed". This value will only be set if the
 905       user has at least *one* recently used PWA. If they have 0, this metric
 906       will not be sent, resulting in a null value during analysis on the
 907       server-side. To disambiguate between a failed `recently_used_pwa_count`
 908       metric and 0 recent PWAs, please see `has_recent_pwas`.
 909     send_in_pings:
 910       - metrics
 911     bugs:
 912       - https://github.com/mozilla-mobile/fenix/issues/11909
 913     data_reviews:
 914       - https://github.com/mozilla-mobile/fenix/pull/11982#pullrequestreview-437963817
 915       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 916     data_sensitivity:
 917       - interaction
 918     notification_emails:
 919       - fenix-core@mozilla.com
 920     expires: "2021-08-01"
 921   has_recent_pwas:
 922     type: boolean
 923     lifetime: application
 924     description: |
 925       A boolean that indicates if the user has recently used PWAs.
 926       See recently_used_pwa_count for the actual count.
 927     send_in_pings:
 928       - metrics
 929     bugs:
 930       - https://github.com/mozilla-mobile/fenix/issues/11909
 931     data_reviews:
 932       - https://github.com/mozilla-mobile/fenix/pull/11982#pullrequestreview-437963817
 933       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 934     data_sensitivity:
 935       - interaction
 936     notification_emails:
 937       - fenix-core@mozilla.com
 938     expires: "2021-08-01"
 939   search_count:
 940     type: labeled_counter
 941     description: |
 942       The labels for this counter are `<search-engine-name>.<source>`.
 943
 944       If the search engine is bundled with Fenix `search-engine-name` will be
 945       the name of the search engine. If it's a custom search engine (defined:
 946       https://github.com/mozilla-mobile/fenix/issues/1607) the value will be
 947       `custom`.
 948
 949       `source` will be: `action`, `suggestion`, `widget`, `shortcut`, `topsite`
 950       (depending on the source from which the search started). Also added the
 951       `other` option for the source but it should never enter on this case.
 952     send_in_pings:
 953       - metrics
 954     bugs:
 955       - https://github.com/mozilla-mobile/fenix/issues/1158
 956       - https://github.com/mozilla-mobile/fenix/issues/6556
 957     data_reviews:
 958       - https://github.com/mozilla-mobile/fenix/pull/1677
 959       - https://github.com/mozilla-mobile/fenix/pull/5216
 960       - https://github.com/mozilla-mobile/fenix/pull/7310
 961       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 962     data_sensitivity:
 963       - technical
 964       - interaction
 965     notification_emails:
 966       - fenix-core@mozilla.com
 967     expires: "2021-08-01"
 968   mozilla_products:
 969     type: string_list
 970     lifetime: application
 971     description: |
 972       A list of all the Mozilla products installed on device. We currently scan
 973       for: Firefox, Firefox Beta, Firefox Aurora, Firefox Nightly, Firefox
 974       Fdroid, Firefox Lite, Reference Browser, Reference Browser Debug, Fenix,
 975       Focus, and Lockwise.
 976     send_in_pings:
 977       - metrics
 978     bugs:
 979       - https://github.com/mozilla-mobile/fenix/issues/1192
 980     data_reviews:
 981       - https://github.com/mozilla-mobile/fenix/pull/1953/
 982       - https://github.com/mozilla-mobile/fenix/pull/5216
 983       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
 984     data_sensitivity:
 985       - technical
 986       - interaction
 987     notification_emails:
 988       - fenix-core@mozilla.com
 989     expires: "2021-08-01"
 990   default_moz_browser:
 991     type: string
 992     lifetime: application
 993     description: |
 994       The name of the default browser on device if and only if it's a Mozilla
 995       owned product
 996     send_in_pings:
 997       - metrics
 998     bugs:
 999       - https://github.com/mozilla-mobile/fenix/issues/1192
1000     data_reviews:
1001       - https://github.com/mozilla-mobile/fenix/pull/1953/
1002       - https://github.com/mozilla-mobile/fenix/pull/5216
1003       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1004     data_sensitivity:
1005       - technical
1006       - interaction
1007     notification_emails:
1008       - fenix-core@mozilla.com
1009     expires: "2021-08-01"
1010   adjust_campaign:
1011     type: string
1012     lifetime: application
1013     description: |
1014       A string containing the Adjust campaign ID from which the user installed
1015       Fenix. This will not send on the first session the user runs. If the
1016       install is organic, this will be empty.
1017     send_in_pings:
1018       - metrics
1019     bugs:
1020       - https://github.com/mozilla-mobile/fenix/issues/1298
1021       - https://github.com/mozilla-mobile/fenix/issues/9136
1022     data_reviews:
1023       - https://github.com/mozilla-mobile/fenix/pull/5579
1024       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1025     data_sensitivity:
1026       - technical
1027     notification_emails:
1028       - fenix-core@mozilla.com
1029     expires: "2021-08-01"
1030   adjust_ad_group:
1031     type: string
1032     lifetime: application
1033     description: |
1034       A string containing the Adjust ad group ID from which the user installed
1035       Fenix. This will not send on the first session the user runs. If the
1036       install is organic, this will be empty.
1037     send_in_pings:
1038       - metrics
1039     bugs:
1040       - https://github.com/mozilla-mobile/fenix/issues/1298
1041       - https://github.com/mozilla-mobile/fenix/issues/9136
1042     data_reviews:
1043       - https://github.com/mozilla-mobile/fenix/pull/9253
1044       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1045     data_sensitivity:
1046       - interaction
1047     notification_emails:
1048       - fenix-core@mozilla.com
1049     expires: "2021-08-01"
1050   adjust_creative:
1051     type: string
1052     lifetime: application
1053     description: |
1054       A string containing the Adjust creative ID from which the user installed
1055       Fenix. This will not send on the first session the user runs. If the
1056       install is organic, this will be empty.
1057     send_in_pings:
1058       - metrics
1059     bugs:
1060       - https://github.com/mozilla-mobile/fenix/issues/1298
1061       - https://github.com/mozilla-mobile/fenix/issues/9136
1062     data_reviews:
1063       - https://github.com/mozilla-mobile/fenix/pull/9253
1064       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1065     data_sensitivity:
1066       - interaction
1067     notification_emails:
1068       - fenix-core@mozilla.com
1069     expires: "2021-08-01"
1070   adjust_network:
1071     type: string
1072     lifetime: application
1073     description: |
1074       A string containing the Adjust network ID from which the user installed
1075       Fenix. This will not send on the first session the user runs. If the
1076       install is organic, this will be empty.
1077     send_in_pings:
1078       - metrics
1079     bugs:
1080       - https://github.com/mozilla-mobile/fenix/issues/1298
1081       - https://github.com/mozilla-mobile/fenix/issues/9136
1082     data_reviews:
1083       - https://github.com/mozilla-mobile/fenix/pull/9253
1084       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1085     data_sensitivity:
1086       - interaction
1087     notification_emails:
1088       - fenix-core@mozilla.com
1089     expires: "2021-08-01"
1090   toolbar_position:
1091     type: string
1092     lifetime: application
1093     description: |
1094       A string that indicates the new position of the toolbar TOP or BOTTOM
1095     send_in_pings:
1096       - metrics
1097     bugs:
1098       - https://github.com/mozilla-mobile/fenix/issues/6054
1099     data_reviews:
1100       - https://github.com/mozilla-mobile/fenix/pull/6608
1101       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1102     data_sensitivity:
1103       - interaction
1104     notification_emails:
1105       - fenix-core@mozilla.com
1106     expires: "2021-08-01"
1107   close_tab_setting:
1108     type: string
1109     lifetime: application
1110     description: |
1111       A string that indicates the setting for tab closing:
1112       MANUAL, ONE_DAY, ONE_WEEK, ONE_MONTH
1113     send_in_pings:
1114       - metrics
1115     bugs:
1116       - https://github.com/mozilla-mobile/fenix/issues/15347#issue-707408975
1117     data_reviews:
1118       - https://github.com/mozilla-mobile/fenix/pull/15811#issuecomment-706402952
1119     data_sensitivity:
1120       - interaction
1121     notification_emails:
1122       - fenix-core@mozilla.com
1123     expires: "2021-08-01"
1124   tab_view_setting:
1125     type: string
1126     lifetime: application
1127     description: |
1128       A string that indicates the setting for tab view:
1129       GRID, LIST
1130     send_in_pings:
1131       - metrics
1132     bugs:
1133       - https://github.com/mozilla-mobile/fenix/issues/15347#issue-707408975
1134     data_reviews:
1135       - https://github.com/mozilla-mobile/fenix/pull/15811#issuecomment-706402952
1136     data_sensitivity:
1137       - interaction
1138     notification_emails:
1139       - fenix-core@mozilla.com
1140     expires: "2021-08-01"
1141   search_widget_installed:
1142     type: boolean
1143     lifetime: application
1144     description: |
1145       Whether or not the search widget is installed
1146     send_in_pings:
1147       - metrics
1148     bugs:
1149       - https://github.com/mozilla-mobile/fenix/issues/9488
1150     data_reviews:
1151       - https://github.com/mozilla-mobile/fenix/pull/10958
1152       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1153     data_sensitivity:
1154       - interaction
1155     notification_emails:
1156       - fenix-core@mozilla.com
1157     expires: "2021-08-01"
1158   tabs_open_count:
1159     type: counter
1160     lifetime: application
1161     description: |
1162       A counter that indicates how many NORMAL tabs a user has open. This
1163       value will only be set if the user has at least *one* open tab. If they
1164       have 0, this ping will not get sent, resulting in a null value. To
1165       disambiguate between a failed `tabs_open_count` ping and 0 open tabs,
1166       please see `has_open_tabs`.
1167     send_in_pings:
1168       - metrics
1169     bugs:
1170       - https://github.com/mozilla-mobile/fenix/issues/11479
1171     data_reviews:
1172       - https://github.com/mozilla-mobile/fenix/pull/12024
1173       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1174     data_sensitivity:
1175       - interaction
1176     notification_emails:
1177       - fenix-core@mozilla.com
1178     expires: "2021-08-01"
1179   has_open_tabs:
1180     type: boolean
1181     lifetime: application
1182     description: |
1183       A boolean that indicates if the user has any open NORMAL tabs.
1184     send_in_pings:
1185       - metrics
1186     bugs:
1187       - https://github.com/mozilla-mobile/fenix/issues/11479
1188     data_reviews:
1189       - https://github.com/mozilla-mobile/fenix/pull/12024
1190       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1191     data_sensitivity:
1192       - interaction
1193     notification_emails:
1194       - fenix-core@mozilla.com
1195     expires: "2021-08-01"
1196   start_reason_process_error:
1197     type: boolean
1198     description: |
1199       The `AppStartReasonProvider.ProcessLifecycleObserver.onCreate` was
1200       unexpectedly called twice. We can use this metric to validate our
1201       assumptions about how these APIs are called. This probe can be removed
1202       once we validate these assumptions.
1203     bugs:
1204       - https://github.com/mozilla-mobile/fenix/issues/18426
1205     data_reviews:
1206       - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
1207     data_sensitivity:
1208       - technical
1209     notification_emails:
1210       - perf-android-fe@mozilla.com
1211       - mcomella@mozilla.com
1212     expires: "2021-08-11"
1213   start_reason_activity_error:
1214     type: boolean
1215     description: |
1216       The `AppStartReasonProvider.ActivityLifecycleCallbacks.onActivityCreated`
1217       was unexpectedly called twice. We can use this metric to validate our
1218       assumptions about how these APIs are called. This probe can be removed
1219       once we validate these assumptions.
1220     bugs:
1221       - https://github.com/mozilla-mobile/fenix/issues/18426
1222     data_reviews:
1223       - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
1224     data_sensitivity:
1225       - technical
1226     notification_emails:
1227       - perf-android-fe@mozilla.com
1228       - mcomella@mozilla.com
1229     expires: "2021-08-11"
1230
1231 preferences:
1232   show_search_suggestions:
1233     type: string_list
1234     description: >
1235       Whether or not the user has search suggestions enabled
1236       default: true
1237     send_in_pings:
1238       - metrics
1239     bugs:
1240       - https://github.com/mozilla-mobile/fenix/issues/11118
1241     data_reviews:
1242       - https://github.com/mozilla-mobile/fenix/pull/11211
1243       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1244     data_sensitivity:
1245       - interaction
1246     notification_emails:
1247       - fenix-core@mozilla.com
1248     expires: "2021-08-01"
1249   remote_debugging:
1250     type: string_list
1251     description: >
1252       Whether or not the user has remote debugging enabled
1253       default: false
1254     send_in_pings:
1255       - metrics
1256     bugs:
1257       - https://github.com/mozilla-mobile/fenix/issues/11118
1258     data_reviews:
1259       - https://github.com/mozilla-mobile/fenix/pull/11211
1260       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1261     data_sensitivity:
1262       - interaction
1263     notification_emails:
1264       - fenix-core@mozilla.com
1265     expires: "2021-08-01"
1266   telemetry:
1267     type: string_list
1268     description: >
1269       Whether or not the user has telemetry enabled. Note we should
1270       never receive a "false" value for this since telemetry would
1271       not send in that case.
1272       default: true
1273     send_in_pings:
1274       - metrics
1275     bugs:
1276       - https://github.com/mozilla-mobile/fenix/issues/11118
1277     data_reviews:
1278       - https://github.com/mozilla-mobile/fenix/pull/11211
1279       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1280     data_sensitivity:
1281       - interaction
1282     notification_emails:
1283       - fenix-core@mozilla.com
1284     expires: "2021-08-01"
1285   tracking_protection:
1286     type: string_list
1287     description: >
1288       What type of enhanced tracking protection the user has enabled.
1289       "standard," "strict," "custom," or "" (if disabled)
1290       default: "standard"
1291     send_in_pings:
1292       - metrics
1293     bugs:
1294       - https://github.com/mozilla-mobile/fenix/issues/11118
1295     data_reviews:
1296       - https://github.com/mozilla-mobile/fenix/pull/11211
1297       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1298     data_sensitivity:
1299       - interaction
1300     notification_emails:
1301       - fenix-core@mozilla.com
1302     expires: "2021-08-01"
1303   search_bookmarks:
1304     type: string_list
1305     description: >
1306       Whether or not the user has enabled bookmark search suggestions
1307       default: true
1308     send_in_pings:
1309       - metrics
1310     bugs:
1311       - https://github.com/mozilla-mobile/fenix/issues/11118
1312     data_reviews:
1313       - https://github.com/mozilla-mobile/fenix/pull/11211
1314       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1315     data_sensitivity:
1316       - interaction
1317     notification_emails:
1318       - fenix-core@mozilla.com
1319     expires: "2021-08-01"
1320   search_browsing_history:
1321     type: string_list
1322     description: >
1323       Whether or not the user has enabled browsing history suggestions.
1324       default: true
1325     send_in_pings:
1326       - metrics
1327     bugs:
1328       - https://github.com/mozilla-mobile/fenix/issues/11118
1329     data_reviews:
1330       - https://github.com/mozilla-mobile/fenix/pull/11211
1331       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1332     data_sensitivity:
1333       - interaction
1334     notification_emails:
1335       - fenix-core@mozilla.com
1336     expires: "2021-08-01"
1337   show_clipboard_suggestions:
1338     type: string_list
1339     description: >
1340       Whether or not the user has enabled clipboard search suggestions.
1341       default: true
1342     send_in_pings:
1343       - metrics
1344     bugs:
1345       - https://github.com/mozilla-mobile/fenix/issues/11118
1346     data_reviews:
1347       - https://github.com/mozilla-mobile/fenix/pull/11211
1348       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1349     data_sensitivity:
1350       - interaction
1351     notification_emails:
1352       - fenix-core@mozilla.com
1353     expires: "2021-08-01"
1354   show_search_shortcuts:
1355     type: string_list
1356     description: >
1357       Whether or not the user has enabled search shortcuts.
1358       default: true
1359     send_in_pings:
1360       - metrics
1361     bugs:
1362       - https://github.com/mozilla-mobile/fenix/issues/11118
1363     data_reviews:
1364       - https://github.com/mozilla-mobile/fenix/pull/11211
1365       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1366     data_sensitivity:
1367       - interaction
1368     notification_emails:
1369       - fenix-core@mozilla.com
1370     expires: "2021-08-01"
1371   open_links_in_a_private_tab:
1372     type: string_list
1373     description: >
1374       Whether or not the user has enabled open links in a private tab.
1375       default: false
1376     send_in_pings:
1377       - metrics
1378     bugs:
1379       - https://github.com/mozilla-mobile/fenix/issues/11118
1380     data_reviews:
1381       - https://github.com/mozilla-mobile/fenix/pull/11211
1382       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1383     data_sensitivity:
1384       - interaction
1385     notification_emails:
1386       - fenix-core@mozilla.com
1387     expires: "2021-08-01"
1388   sync:
1389     type: string_list
1390     description: >
1391       Whether or not the user is signed into FxA
1392       default: false
1393     send_in_pings:
1394       - metrics
1395     bugs:
1396       - https://github.com/mozilla-mobile/fenix/issues/11118
1397     data_reviews:
1398       - https://github.com/mozilla-mobile/fenix/pull/11211
1399       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1400     data_sensitivity:
1401       - interaction
1402     notification_emails:
1403       - fenix-core@mozilla.com
1404     expires: "2021-08-01"
1405   sync_items:
1406     type: string_list
1407     description: >
1408       The list of items the user has chosen to sync with FxA.
1409       default: "" if the user is signed out. Otherwise defaults to
1410       whatever is set in their FxA account. New accounts set:
1411       [bookmarks, history, passwords, tabs]
1412     send_in_pings:
1413       - metrics
1414     bugs:
1415       - https://github.com/mozilla-mobile/fenix/issues/11118
1416     data_reviews:
1417       - https://github.com/mozilla-mobile/fenix/pull/11211
1418       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1419     data_sensitivity:
1420       - interaction
1421     notification_emails:
1422       - fenix-core@mozilla.com
1423     expires: "2021-08-01"
1424   show_voice_search:
1425     type: string_list
1426     description: >
1427       Whether or not the user has enabled the voice search button.
1428       default: true
1429     send_in_pings:
1430       - metrics
1431     bugs:
1432       - https://github.com/mozilla-mobile/fenix/issues/11118
1433     data_reviews:
1434       - https://github.com/mozilla-mobile/fenix/pull/11211
1435       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1436     data_sensitivity:
1437       - interaction
1438     notification_emails:
1439       - fenix-core@mozilla.com
1440     expires: "2021-08-01"
1441   search_suggestions_private:
1442     type: string_list
1443     description: >
1444       Whether or not the user has enabled showing search suggestions
1445       in private mode.
1446       default: false (we prompt the user, asking them to make a selection)
1447     send_in_pings:
1448       - metrics
1449     bugs:
1450       - https://github.com/mozilla-mobile/fenix/issues/11118
1451     data_reviews:
1452       - https://github.com/mozilla-mobile/fenix/pull/11211
1453       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1454     data_sensitivity:
1455       - interaction
1456     notification_emails:
1457       - fenix-core@mozilla.com
1458     expires: "2021-08-01"
1459   toolbar_position:
1460     type: string_list
1461     description: >
1462       The position of the toolbar
1463       default: bottom (defaults to top if the user has accessibility services)
1464     send_in_pings:
1465       - metrics
1466     bugs:
1467       - https://github.com/mozilla-mobile/fenix/issues/11118
1468     data_reviews:
1469       - https://github.com/mozilla-mobile/fenix/pull/11211
1470       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1471     data_sensitivity:
1472       - interaction
1473     notification_emails:
1474       - fenix-core@mozilla.com
1475     expires: "2021-08-01"
1476   accessibility_services:
1477     type: string_list
1478     description: >
1479       Whether or not the user has touch exploration or switch services enabled.
1480       These are built into the Android OS, not Fenix prefs.
1481       default: ""
1482     send_in_pings:
1483       - metrics
1484     bugs:
1485       - https://github.com/mozilla-mobile/fenix/issues/11118
1486     data_reviews:
1487       - https://github.com/mozilla-mobile/fenix/pull/11211
1488       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1489     data_sensitivity:
1490       - interaction
1491     notification_emails:
1492       - fenix-core@mozilla.com
1493     expires: "2021-08-01"
1494   open_links_in_app:
1495     type: string_list
1496     description: >
1497       Whether or not the user has the open links in apps feature enabled.
1498       default: false
1499     send_in_pings:
1500       - metrics
1501     bugs:
1502       - https://github.com/mozilla-mobile/fenix/issues/11118
1503     data_reviews:
1504       - https://github.com/mozilla-mobile/fenix/pull/11446
1505       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1506     data_sensitivity:
1507       - interaction
1508     notification_emails:
1509       - fenix-core@mozilla.com
1510     expires: "2021-08-01"
1511   theme:
1512     type: string_list
1513     description: >
1514       The theme the user has enabled. "light," "dark," "system," or "battery"
1515       default: "system" for API 28+, else "light"
1516     send_in_pings:
1517       - metrics
1518     bugs:
1519       - https://github.com/mozilla-mobile/fenix/issues/11118
1520     data_reviews:
1521       - https://github.com/mozilla-mobile/fenix/pull/11446
1522       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1523     data_sensitivity:
1524       - interaction
1525     notification_emails:
1526       - fenix-core@mozilla.com
1527     expires: "2021-08-01"
1528
1529 search.default_engine:
1530   code:
1531     type: string
1532     lifetime: application
1533     description: |
1534       If the search engine is pre-loaded with Fenix this value
1535       will be the search engine identifier. If it's a custom search engine
1536       (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the
1537       value will be "custom"
1538     send_in_pings:
1539       - metrics
1540     bugs:
1541       - https://github.com/mozilla-mobile/fenix/issues/800
1542     data_reviews:
1543       - https://github.com/mozilla-mobile/fenix/pull/1606
1544       - https://github.com/mozilla-mobile/fenix/pull/5216
1545       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1546     data_sensitivity:
1547       - technical
1548       - interaction
1549     notification_emails:
1550       - fenix-core@mozilla.com
1551     expires: "2021-08-01"
1552   name:
1553     type: string
1554     lifetime: application
1555     description: |
1556       If the search engine is pre-loaded with Fenix this value
1557       will be the search engine name. If it's a custom search engine
1558       (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the
1559       value will be "custom"
1560     send_in_pings:
1561       - metrics
1562     bugs:
1563       - https://github.com/mozilla-mobile/fenix/issues/800
1564     data_reviews:
1565       - https://github.com/mozilla-mobile/fenix/pull/1606
1566       - https://github.com/mozilla-mobile/fenix/pull/5216
1567       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1568     data_sensitivity:
1569       - technical
1570       - interaction
1571     notification_emails:
1572       - fenix-core@mozilla.com
1573     expires: "2021-08-01"
1574   submission_url:
1575     type: string
1576     lifetime: application
1577     description: |
1578       If the search engine is pre-loaded with Fenix this value will be he base
1579       URL we use to build the search query for the search engine. For example:
1580       https://mysearchengine.com/?query=%s. If it's a custom search engine
1581       (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the value
1582       will be "custom"
1583     send_in_pings:
1584       - metrics
1585     bugs:
1586       - https://github.com/mozilla-mobile/fenix/issues/800
1587     data_reviews:
1588       - https://github.com/mozilla-mobile/fenix/pull/1606
1589       - https://github.com/mozilla-mobile/fenix/pull/5216
1590       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1591     data_sensitivity:
1592       - technical
1593       - interaction
1594     notification_emails:
1595       - fenix-core@mozilla.com
1596     expires: "2021-08-01"
1597
1598 bookmarks_management:
1599   open:
1600     type: event
1601     description: |
1602       A user opened a bookmark.
1603     bugs:
1604       - https://github.com/mozilla-mobile/fenix/issues/18173
1605     data_reviews:
1606       - https://github.com/mozilla-mobile/fenix/pull/18174
1607     data_sensitivity:
1608       - interaction
1609     notification_emails:
1610       - fenix-core@mozilla.com
1611     expires: "2022-08-01"
1612   open_in_new_tab:
1613     type: event
1614     description: |
1615       A user opened a bookmark in a new tab.
1616     bugs:
1617       - https://github.com/mozilla-mobile/fenix/issues/974
1618     data_reviews:
1619       - https://github.com/mozilla-mobile/fenix/pull/1708
1620       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1621       - https://github.com/mozilla-mobile/fenix/pull/18143
1622     data_sensitivity:
1623       - interaction
1624     notification_emails:
1625       - fenix-core@mozilla.com
1626     expires: "2021-07-01"
1627   open_in_new_tabs:
1628     type: event
1629     description: |
1630       A user opened multiple bookmarks at once in new tabs.
1631     bugs:
1632       - https://github.com/mozilla-mobile/fenix/issues/974
1633     data_reviews:
1634       - https://github.com/mozilla-mobile/fenix/pull/1708
1635       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1636       - https://github.com/mozilla-mobile/fenix/pull/18143
1637     data_sensitivity:
1638       - interaction
1639     notification_emails:
1640       - fenix-core@mozilla.com
1641     expires: "2021-07-01"
1642   open_in_private_tab:
1643     type: event
1644     description: |
1645       A user opened a bookmark in a new private tab.
1646     bugs:
1647       - https://github.com/mozilla-mobile/fenix/issues/974
1648     data_reviews:
1649       - https://github.com/mozilla-mobile/fenix/pull/1708
1650       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1651       - https://github.com/mozilla-mobile/fenix/pull/18143
1652     data_sensitivity:
1653       - interaction
1654     notification_emails:
1655       - fenix-core@mozilla.com
1656     expires: "2021-07-01"
1657   open_in_private_tabs:
1658     type: event
1659     description: |
1660       A user opened multiple bookmarks at once in new private tabs.
1661     bugs:
1662       - https://github.com/mozilla-mobile/fenix/issues/974
1663     data_reviews:
1664       - https://github.com/mozilla-mobile/fenix/pull/1708
1665       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1666       - https://github.com/mozilla-mobile/fenix/pull/18143
1667     data_sensitivity:
1668       - interaction
1669     notification_emails:
1670       - fenix-core@mozilla.com
1671     expires: "2021-07-01"
1672   edited:
1673     type: event
1674     description: |
1675       A user edited the title and/or URL of an existing bookmark.
1676     bugs:
1677       - https://github.com/mozilla-mobile/fenix/issues/974
1678     data_reviews:
1679       - https://github.com/mozilla-mobile/fenix/pull/1708
1680       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1681       - https://github.com/mozilla-mobile/fenix/pull/18143
1682     data_sensitivity:
1683       - interaction
1684     notification_emails:
1685       - fenix-core@mozilla.com
1686     expires: "2021-07-01"
1687   moved:
1688     type: event
1689     description: |
1690       A user moved an existing bookmark or folder to another folder.
1691     bugs:
1692       - https://github.com/mozilla-mobile/fenix/issues/974
1693     data_reviews:
1694       - https://github.com/mozilla-mobile/fenix/pull/1708
1695       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1696       - https://github.com/mozilla-mobile/fenix/pull/18143
1697     data_sensitivity:
1698       - interaction
1699     notification_emails:
1700       - fenix-core@mozilla.com
1701     expires: "2021-07-01"
1702   removed:
1703     type: event
1704     description: |
1705       A user removed a bookmark item.
1706     bugs:
1707       - https://github.com/mozilla-mobile/fenix/issues/974
1708     data_reviews:
1709       - https://github.com/mozilla-mobile/fenix/pull/1708
1710       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1711       - https://github.com/mozilla-mobile/fenix/pull/18143
1712     data_sensitivity:
1713       - interaction
1714     notification_emails:
1715       - fenix-core@mozilla.com
1716     expires: "2021-07-01"
1717   multi_removed:
1718     type: event
1719     description: |
1720       A user removed multiple bookmarks at once.
1721     bugs:
1722       - https://github.com/mozilla-mobile/fenix/issues/974
1723     data_reviews:
1724       - https://github.com/mozilla-mobile/fenix/pull/1708
1725       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1726       - https://github.com/mozilla-mobile/fenix/pull/18143
1727     data_sensitivity:
1728       - interaction
1729     notification_emails:
1730       - fenix-core@mozilla.com
1731     expires: "2021-07-01"
1732   shared:
1733     type: event
1734     description: |
1735       A user shared a bookmark.
1736     bugs:
1737       - https://github.com/mozilla-mobile/fenix/issues/974
1738     data_reviews:
1739       - https://github.com/mozilla-mobile/fenix/pull/1708
1740       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1741       - https://github.com/mozilla-mobile/fenix/pull/18143
1742     data_sensitivity:
1743       - interaction
1744     notification_emails:
1745       - fenix-core@mozilla.com
1746     expires: "2021-07-01"
1747   copied:
1748     type: event
1749     description: |
1750       A user copied a bookmark.
1751     bugs:
1752       - https://github.com/mozilla-mobile/fenix/issues/974
1753     data_reviews:
1754       - https://github.com/mozilla-mobile/fenix/pull/1708
1755       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1756       - https://github.com/mozilla-mobile/fenix/pull/18143
1757     data_sensitivity:
1758       - interaction
1759     notification_emails:
1760       - fenix-core@mozilla.com
1761     expires: "2021-07-01"
1762   folder_add:
1763     type: event
1764     description: |
1765       A user added a new bookmark folder.
1766     bugs:
1767       - https://github.com/mozilla-mobile/fenix/issues/974
1768     data_reviews:
1769       - https://github.com/mozilla-mobile/fenix/pull/1708
1770       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1771       - https://github.com/mozilla-mobile/fenix/pull/18143
1772     data_sensitivity:
1773       - interaction
1774     notification_emails:
1775       - fenix-core@mozilla.com
1776     expires: "2021-07-01"
1777   folder_remove:
1778     type: event
1779     description: |
1780       A user removed a bookmark folder.
1781     bugs:
1782       - https://github.com/mozilla-mobile/fenix/issues/3174
1783     data_reviews:
1784       - https://github.com/mozilla-mobile/fenix/pull/3724
1785       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1786       - https://github.com/mozilla-mobile/fenix/pull/18143
1787     data_sensitivity:
1788       - interaction
1789     notification_emails:
1790       - fenix-core@mozilla.com
1791     expires: "2021-07-01"
1792
1793 custom_tab:
1794   closed:
1795     type: event
1796     description: |
1797       A user closed the custom tab
1798     bugs:
1799       - https://github.com/mozilla-mobile/fenix/issues/977
1800     data_reviews:
1801       - https://github.com/mozilla-mobile/fenix/pull/1697
1802       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1803       - https://github.com/mozilla-mobile/fenix/pull/18143
1804     data_sensitivity:
1805       - interaction
1806     notification_emails:
1807       - fenix-core@mozilla.com
1808     expires: "2021-07-01"
1809   action_button:
1810     type: event
1811     description: |
1812       A user pressed the action button provided by the launching app
1813     bugs:
1814       - https://github.com/mozilla-mobile/fenix/issues/977
1815     data_reviews:
1816       - https://github.com/mozilla-mobile/fenix/pull/1697
1817       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1818       - https://github.com/mozilla-mobile/fenix/pull/18143
1819     data_sensitivity:
1820       - interaction
1821     notification_emails:
1822       - fenix-core@mozilla.com
1823     expires: "2021-07-01"
1824   menu:
1825     type: event
1826     description: |
1827       A user opened the custom tabs menu
1828     bugs:
1829       - https://github.com/mozilla-mobile/fenix/issues/977
1830     data_reviews:
1831       - https://github.com/mozilla-mobile/fenix/pull/1697
1832       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1833       - https://github.com/mozilla-mobile/fenix/pull/18143
1834     data_sensitivity:
1835       - interaction
1836     notification_emails:
1837       - fenix-core@mozilla.com
1838     expires: "2021-07-01"
1839
1840 activation:
1841   identifier:
1842     type: string
1843     lifetime: ping
1844     description: |
1845       A hashed and salted version of the Google Advertising ID from the device.
1846       This will never be sent in a ping that also contains the client_id.
1847     send_in_pings:
1848       - activation
1849     bugs:
1850       - https://bugzilla.mozilla.org/1538011
1851       - https://bugzilla.mozilla.org/1501822
1852     data_reviews:
1853       - https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
1854       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1855       - https://github.com/mozilla-mobile/fenix/pull/18143
1856     data_sensitivity:
1857       - highly_sensitive
1858     notification_emails:
1859       - fenix-core@mozilla.com
1860     expires: "2021-07-01"
1861   activation_id:
1862     type: uuid
1863     lifetime: user
1864     description: |
1865       An alternate identifier, not correlated with the client_id, generated once
1866       and only sent with the activation ping.
1867     send_in_pings:
1868       - activation
1869     bugs:
1870       - https://bugzilla.mozilla.org/1538011
1871     data_reviews:
1872       - https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
1873       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1874       - https://github.com/mozilla-mobile/fenix/pull/18143
1875     data_sensitivity:
1876       - highly_sensitive
1877     notification_emails:
1878       - fenix-core@mozilla.com
1879     expires: "2021-07-01"
1880     no_lint:
1881       - USER_LIFETIME_EXPIRATION
1882
1883 error_page:
1884   visited_error:
1885     type: event
1886     description: |
1887       A user encountered an error page
1888     extra_keys:
1889       error_type:
1890         description: "The error type of the error page encountered"
1891     bugs:
1892       - https://github.com/mozilla-mobile/fenix/issues/1242
1893     data_reviews:
1894       - https://github.com/mozilla-mobile/fenix/pull/2491#issuecomment-492414486
1895       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
1896       - https://github.com/mozilla-mobile/fenix/pull/18143
1897     data_sensitivity:
1898       - interaction
1899     notification_emails:
1900       - fenix-core@mozilla.com
1901     expires: "2021-07-01"
1902
1903 sync_auth:
1904   opened:
1905     type: event
1906     description: |
1907       A user opened the sync authentication page
1908     bugs:
1909       - https://github.com/mozilla-mobile/fenix/issues/1190
1910     data_reviews:
1911       - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
1912       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1913     data_sensitivity:
1914       - interaction
1915     notification_emails:
1916       - fenix-core@mozilla.com
1917     expires: "2021-08-01"
1918   closed:
1919     type: event
1920     description: |
1921       A user closed the sync page
1922     bugs:
1923       - https://github.com/mozilla-mobile/fenix/issues/1190
1924     data_reviews:
1925       - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
1926       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1927     data_sensitivity:
1928       - interaction
1929     notification_emails:
1930       - fenix-core@mozilla.com
1931     expires: "2021-08-01"
1932   use_email:
1933     type: event
1934     description: |
1935       A user chose to use their email to sign in instead of scanning a QR code,
1936       counterpart to "scan_pairing"
1937     bugs:
1938       - https://github.com/mozilla-mobile/fenix/issues/9834
1939     data_reviews:
1940       - https://github.com/mozilla-mobile/fenix/pull/9835#pullrequestreview-398641844
1941       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1942     data_sensitivity:
1943       - interaction
1944     notification_emails:
1945       - fenix-core@mozilla.com
1946     expires: "2021-08-01"
1947   use_email_problem:
1948     type: event
1949     description: |
1950       A user chose to use their email to sign in after an account problem
1951     bugs:
1952       - https://github.com/mozilla-mobile/fenix/issues/9834
1953     data_reviews:
1954       - https://github.com/mozilla-mobile/fenix/pull/9835#pullrequestreview-398641844
1955       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1956     data_sensitivity:
1957       - interaction
1958     notification_emails:
1959       - fenix-core@mozilla.com
1960     expires: "2021-08-01"
1961   sign_in:
1962     type: event
1963     description: |
1964       A user pressed the sign in button on the sync authentication page and was
1965       successfully signed in to FxA
1966     bugs:
1967       - https://github.com/mozilla-mobile/fenix/issues/1190
1968     data_reviews:
1969       - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
1970       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1971     data_sensitivity:
1972       - interaction
1973     notification_emails:
1974       - fenix-core@mozilla.com
1975     expires: "2021-08-01"
1976   sign_out:
1977     type: event
1978     description: |
1979       A user pressed the sign out button on the sync account page and was
1980       successfully signed out of FxA
1981     bugs:
1982       - https://github.com/mozilla-mobile/fenix/issues/1190
1983     data_reviews:
1984       - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
1985       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
1986     data_sensitivity:
1987       - interaction
1988     notification_emails:
1989       - fenix-core@mozilla.com
1990     expires: "2021-08-01"
1991   sign_up:
1992     type: event
1993     description: |
1994       User registered a new Firefox Account, and was signed into it
1995     bugs:
1996       - https://github.com/mozilla-mobile/fenix/issues/4971
1997     data_reviews:
1998       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
1999       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2000     data_sensitivity:
2001       - technical
2002       - interaction
2003     notification_emails:
2004       - fenix-core@mozilla.com
2005     expires: "2021-08-01"
2006   paired:
2007     type: event
2008     description: |
2009       User signed into FxA by pairing with a different Firefox browser, using a
2010       QR code
2011     bugs:
2012       - https://github.com/mozilla-mobile/fenix/issues/4971
2013     data_reviews:
2014       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
2015       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2016     data_sensitivity:
2017       - technical
2018       - interaction
2019     notification_emails:
2020       - fenix-core@mozilla.com
2021     expires: "2021-08-01"
2022   recovered:
2023     type: event
2024     description: |
2025       Account manager automatically recovered FxA authentication state without
2026       direct user involvement
2027     bugs:
2028       - https://github.com/mozilla-mobile/fenix/issues/4971
2029     data_reviews:
2030       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
2031       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2032     data_sensitivity:
2033       - technical
2034       - interaction
2035     notification_emails:
2036       - fenix-core@mozilla.com
2037     expires: "2021-08-01"
2038   other_external:
2039     type: event
2040     description: |
2041       User authenticated via FxA using an unknown mechanism. "Known" mechanisms
2042       are currently sign-in, sign-up and pairing
2043     bugs:
2044       - https://github.com/mozilla-mobile/fenix/issues/4971
2045     data_reviews:
2046       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
2047       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2048     data_sensitivity:
2049       - technical
2050       - interaction
2051     notification_emails:
2052       - fenix-core@mozilla.com
2053     expires: "2021-08-01"
2054   scan_pairing:
2055     type: event
2056     description: |
2057       A user pressed the scan pairing button on the sync authentication page
2058     bugs:
2059       - https://github.com/mozilla-mobile/fenix/issues/1190
2060     data_reviews:
2061       - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
2062       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2063     data_sensitivity:
2064       - interaction
2065     notification_emails:
2066       - fenix-core@mozilla.com
2067     expires: "2021-08-01"
2068
2069 sync_account:
2070   opened:
2071     type: event
2072     description: |
2073       A user opened the sync account page
2074     bugs:
2075       - https://github.com/mozilla-mobile/fenix/issues/1190
2076     data_reviews:
2077       - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
2078       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2079     data_sensitivity:
2080       - interaction
2081     notification_emails:
2082       - fenix-core@mozilla.com
2083     expires: "2021-08-01"
2084   sync_now:
2085     type: event
2086     description: |
2087       A user pressed the sync now button on the sync account page
2088     bugs:
2089       - https://github.com/mozilla-mobile/fenix/issues/1190
2090     data_reviews:
2091       - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
2092       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2093     data_sensitivity:
2094       - interaction
2095     notification_emails:
2096       - fenix-core@mozilla.com
2097     expires: "2021-08-01"
2098   send_tab:
2099     type: event
2100     description: |
2101       A user sent the current tab to another FxA device
2102     bugs:
2103       - https://github.com/mozilla-mobile/fenix/issues/4908
2104     data_reviews:
2105       - https://github.com/mozilla-mobile/fenix/pull/5106
2106       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2107     data_sensitivity:
2108       - interaction
2109     notification_emails:
2110       - fenix-core@mozilla.com
2111     expires: "2021-08-01"
2112   sign_in_to_send_tab:
2113     type: event
2114     description: |
2115       A user pressed the "sign in to send tab" button inside the share tab menu
2116     bugs:
2117       - https://github.com/mozilla-mobile/fenix/issues/4908
2118     data_reviews:
2119       - https://github.com/mozilla-mobile/fenix/pull/5106
2120       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2121     data_sensitivity:
2122       - interaction
2123     notification_emails:
2124       - fenix-core@mozilla.com
2125     expires: "2021-08-01"
2126
2127 history:
2128   opened:
2129     type: event
2130     description: |
2131       A user opened the history screen
2132     bugs:
2133       - https://github.com/mozilla-mobile/fenix/issues/2362
2134     data_reviews:
2135       - https://github.com/mozilla-mobile/fenix/pull/3940
2136       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2137     data_sensitivity:
2138       - interaction
2139     notification_emails:
2140       - fenix-core@mozilla.com
2141     expires: "2021-08-01"
2142   removed:
2143     type: event
2144     description: |
2145       A user removed a history item
2146     bugs:
2147       - https://github.com/mozilla-mobile/fenix/issues/2362
2148     data_reviews:
2149       - https://github.com/mozilla-mobile/fenix/pull/3940
2150       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2151     data_sensitivity:
2152       - interaction
2153     notification_emails:
2154       - fenix-core@mozilla.com
2155     expires: "2021-08-01"
2156   removed_all:
2157     type: event
2158     description: |
2159       A user removed all history items
2160     bugs:
2161       - https://github.com/mozilla-mobile/fenix/issues/2362
2162     data_reviews:
2163       - https://github.com/mozilla-mobile/fenix/pull/3940
2164       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2165     data_sensitivity:
2166       - interaction
2167     notification_emails:
2168       - fenix-core@mozilla.com
2169     expires: "2021-08-01"
2170   shared:
2171     type: event
2172     description: |
2173       A user shared a history item
2174     bugs:
2175       - https://github.com/mozilla-mobile/fenix/issues/2362
2176     data_reviews:
2177       - https://github.com/mozilla-mobile/fenix/pull/3940
2178       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2179     data_sensitivity:
2180       - interaction
2181     notification_emails:
2182       - fenix-core@mozilla.com
2183     expires: "2021-08-01"
2184   opened_item:
2185     type: event
2186     description: |
2187       A user opened a history item
2188     bugs:
2189       - https://github.com/mozilla-mobile/fenix/issues/18178
2190     data_reviews:
2191       - https://github.com/mozilla-mobile/fenix/pull/18261
2192     data_sensitivity:
2193       - interaction
2194     notification_emails:
2195       - fenix-core@mozilla.com
2196     expires: "2022-08-01"
2197   opened_item_in_new_tab:
2198     type: event
2199     description: |
2200       A user opened a history item in a new tab
2201     bugs:
2202       - https://github.com/mozilla-mobile/fenix/issues/18178
2203     data_reviews:
2204       - https://github.com/mozilla-mobile/fenix/pull/18261
2205     data_sensitivity:
2206       - interaction
2207     notification_emails:
2208       - fenix-core@mozilla.com
2209     expires: "2022-08-01"
2210   opened_items_in_new_tabs:
2211     type: event
2212     description: |
2213       A user opened multiple history items in new tabs
2214     bugs:
2215       - https://github.com/mozilla-mobile/fenix/issues/18178
2216     data_reviews:
2217       - https://gith ub.com/mozilla-mobile/fenix/pull/18261
2218     data_sensitivity:
2219       - interaction
2220     notification_emails:
2221       - fenix-core@mozilla.com
2222     expires: "2022-08-01"
2223   opened_item_in_private_tab:
2224     type: event
2225     description: |
2226       A user opened a history item in a private tab
2227     bugs:
2228       - https://github.com/mozilla-mobile/fenix/issues/18178
2229     data_reviews:
2230       - https://github.com/mozilla-mobile/fenix/pull/18261
2231     data_sensitivity:
2232       - interaction
2233     notification_emails:
2234       - fenix-core@mozilla.com
2235     expires: "2022-08-01"
2236   opened_items_in_private_tabs:
2237     type: event
2238     description: |
2239       A user opened multiple history items in private tabs
2240     bugs:
2241       - https://github.com/mozilla-mobile/fenix/issues/18178
2242     data_reviews:
2243       - https://github.com/mozilla-mobile/fenix/pull/18261
2244     data_sensitivity:
2245       - interaction
2246     notification_emails:
2247       - fenix-core@mozilla.com
2248     expires: "2022-08-01"
2249
2250 tip:
2251   displayed:
2252     type: event
2253     description: |
2254       The tip was displayed
2255     extra_keys:
2256       identifier:
2257         description: "The identifier of the tip displayed"
2258     bugs:
2259       - https://github.com/mozilla-mobile/fenix/issues/9328
2260     data_reviews:
2261       - https://github.com/mozilla-mobile/fenix/pull/9836
2262       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2263     data_sensitivity:
2264       - interaction
2265     notification_emails:
2266       - fenix-core@mozilla.com
2267     expires: "2021-08-01"
2268   pressed:
2269     type: event
2270     description: |
2271       The tip's button was pressed
2272     extra_keys:
2273       identifier:
2274         description: "The identifier of the tip the action was taken on"
2275     bugs:
2276       - https://github.com/mozilla-mobile/fenix/issues/9328
2277     data_reviews:
2278       - https://github.com/mozilla-mobile/fenix/pull/9836
2279       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2280     data_sensitivity:
2281       - interaction
2282     notification_emails:
2283       - fenix-core@mozilla.com
2284     expires: "2021-08-01"
2285   closed:
2286     type: event
2287     description: |
2288       The tip was closed
2289     extra_keys:
2290       identifier:
2291         description: "The identifier of the tip closed"
2292     bugs:
2293       - https://github.com/mozilla-mobile/fenix/issues/9328
2294     data_reviews:
2295       - https://github.com/mozilla-mobile/fenix/pull/9836
2296       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2297     data_sensitivity:
2298       - interaction
2299     notification_emails:
2300       - fenix-core@mozilla.com
2301     expires: "2021-08-01"
2302
2303 reader_mode:
2304   available:
2305     type: event
2306     description: |
2307       Reader mode is available for the current page
2308     bugs:
2309       - https://github.com/mozilla-mobile/fenix/issues/2267
2310     data_reviews:
2311       - https://github.com/mozilla-mobile/fenix/pull/3941
2312       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2313     data_sensitivity:
2314       - interaction
2315     notification_emails:
2316       - fenix-core@mozilla.com
2317     expires: "2021-08-01"
2318   opened:
2319     type: event
2320     description: |
2321       A user opened reader mode
2322     bugs:
2323       - https://github.com/mozilla-mobile/fenix/issues/2267
2324     data_reviews:
2325       - https://github.com/mozilla-mobile/fenix/pull/3941
2326       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2327     data_sensitivity:
2328       - interaction
2329     notification_emails:
2330       - fenix-core@mozilla.com
2331     expires: "2021-08-01"
2332   closed:
2333     type: event
2334     description: |
2335       A user closed reader mode
2336     bugs:
2337       - https://github.com/mozilla-mobile/fenix/issues/2267
2338     data_reviews:
2339       - https://github.com/mozilla-mobile/fenix/pull/4328
2340       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2341     data_sensitivity:
2342       - interaction
2343     notification_emails:
2344       - fenix-core@mozilla.com
2345     expires: "2021-08-01"
2346   appearance:
2347     type: event
2348     description: |
2349       A user tapped the appearance button
2350     bugs:
2351       - https://github.com/mozilla-mobile/fenix/issues/2267
2352     data_reviews:
2353       - https://github.com/mozilla-mobile/fenix/pull/3941
2354       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2355     data_sensitivity:
2356       - interaction
2357     notification_emails:
2358       - fenix-core@mozilla.com
2359     expires: "2021-08-01"
2360
2361 tabs_tray.cfr:
2362   dismiss:
2363     type: event
2364     description: |
2365       A user dismisses the tabs tray CFR.
2366     bugs:
2367       - https://github.com/mozilla-mobile/fenix/issues/16485
2368     data_reviews:
2369       - https://github.com/mozilla-mobile/fenix/pull/17442
2370       - https://github.com/mozilla-mobile/fenix/issues/16485#issuecomment-759641324
2371     data_sensitivity:
2372       - interaction
2373     notification_emails:
2374       - fenix-core@mozilla.com
2375     expires: "2021-08-01"
2376   go_to_settings:
2377     type: event
2378     description: |
2379       A user selects the CFR option to navigate to settings.
2380     bugs:
2381       - https://github.com/mozilla-mobile/fenix/issues/16485
2382     data_reviews:
2383       - https://github.com/mozilla-mobile/fenix/pull/17442
2384       - https://github.com/mozilla-mobile/fenix/issues/16485#issuecomment-759641324
2385     data_sensitivity:
2386       - interaction
2387     notification_emails:
2388       - fenix-core@mozilla.com
2389     expires: "2021-08-01"
2390
2391 tabs_tray:
2392   opened:
2393     type: event
2394     description: |
2395       A user opened the tabs tray
2396     bugs:
2397       - https://github.com/mozilla-mobile/fenix/issues/11273
2398     data_reviews:
2399       - https://github.com/mozilla-mobile/fenix/pull/12036
2400       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2401     data_sensitivity:
2402       - interaction
2403     notification_emails:
2404       - fenix-core@mozilla.com
2405     expires: "2021-08-01"
2406   closed:
2407     type: event
2408     description: |
2409       A user closed the tabs tray
2410     bugs:
2411       - https://github.com/mozilla-mobile/fenix/issues/11273
2412     data_reviews:
2413       - https://github.com/mozilla-mobile/fenix/pull/12036
2414       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2415     data_sensitivity:
2416       - interaction
2417     notification_emails:
2418       - fenix-core@mozilla.com
2419     expires: "2021-08-01"
2420   opened_existing_tab:
2421     type: event
2422     description: |
2423       A user opened an existing tab
2424     bugs:
2425       - https://github.com/mozilla-mobile/fenix/issues/11273
2426     data_reviews:
2427       - https://github.com/mozilla-mobile/fenix/pull/12036
2428       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2429     data_sensitivity:
2430       - interaction
2431     notification_emails:
2432       - fenix-core@mozilla.com
2433     expires: "2021-08-01"
2434   closed_existing_tab:
2435     type: event
2436     description: |
2437       A user closed an existing tab
2438     bugs:
2439       - https://github.com/mozilla-mobile/fenix/issues/11273
2440     data_reviews:
2441       - https://github.com/mozilla-mobile/fenix/pull/12036
2442       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2443     data_sensitivity:
2444       - interaction
2445     notification_emails:
2446       - fenix-core@mozilla.com
2447     expires: "2021-08-01"
2448   private_mode_tapped:
2449     type: event
2450     description: |
2451       A user switched to private mode
2452     bugs:
2453       - https://github.com/mozilla-mobile/fenix/issues/11273
2454     data_reviews:
2455       - https://github.com/mozilla-mobile/fenix/pull/12036
2456       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2457     data_sensitivity:
2458       - interaction
2459     notification_emails:
2460       - fenix-core@mozilla.com
2461     expires: "2021-08-01"
2462   normal_mode_tapped:
2463     type: event
2464     description: |
2465       A user switched to normal mode
2466     bugs:
2467       - https://github.com/mozilla-mobile/fenix/issues/11273
2468     data_reviews:
2469       - https://github.com/mozilla-mobile/fenix/pull/12036
2470       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2471     data_sensitivity:
2472       - interaction
2473     notification_emails:
2474       - fenix-core@mozilla.com
2475     expires: "2021-08-01"
2476   new_tab_tapped:
2477     type: event
2478     description: |
2479       A user opened a new tab
2480     bugs:
2481       - https://github.com/mozilla-mobile/fenix/issues/11273
2482     data_reviews:
2483       - https://github.com/mozilla-mobile/fenix/pull/12036
2484       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2485     data_sensitivity:
2486       - interaction
2487     notification_emails:
2488       - fenix-core@mozilla.com
2489     expires: "2021-08-01"
2490   new_private_tab_tapped:
2491     type: event
2492     description: |
2493       A user opened a new private tab
2494     bugs:
2495       - https://github.com/mozilla-mobile/fenix/issues/11273
2496     data_reviews:
2497       - https://github.com/mozilla-mobile/fenix/pull/12036
2498       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2499     data_sensitivity:
2500       - interaction
2501     notification_emails:
2502       - fenix-core@mozilla.com
2503     expires: "2021-08-01"
2504   menu_opened:
2505     type: event
2506     description: |
2507       A user opened three three dot menu in the tabs tray
2508     bugs:
2509       - https://github.com/mozilla-mobile/fenix/issues/11273
2510     data_reviews:
2511       - https://github.com/mozilla-mobile/fenix/pull/12036
2512       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2513     data_sensitivity:
2514       - interaction
2515     notification_emails:
2516       - fenix-core@mozilla.com
2517     expires: "2021-08-01"
2518   save_to_collection:
2519     type: event
2520     description: |
2521       A user tapped the save to collection button in the tabs tray
2522     bugs:
2523       - https://github.com/mozilla-mobile/fenix/issues/11273
2524     data_reviews:
2525       - https://github.com/mozilla-mobile/fenix/pull/12036
2526       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2527     data_sensitivity:
2528       - interaction
2529     notification_emails:
2530       - fenix-core@mozilla.com
2531     expires: "2021-08-01"
2532   share_all_tabs:
2533     type: event
2534     description: |
2535       A user tapped the share all tabs button in the
2536       three dot menu within the tabs tray
2537     bugs:
2538       - https://github.com/mozilla-mobile/fenix/issues/11273
2539     data_reviews:
2540       - https://github.com/mozilla-mobile/fenix/pull/12036
2541       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2542     data_sensitivity:
2543       - interaction
2544     notification_emails:
2545       - fenix-core@mozilla.com
2546     expires: "2021-08-01"
2547   close_all_tabs:
2548     type: event
2549     description: |
2550       A user tapped the close all tabs button in the
2551       three dot menu within the tabs tray
2552     bugs:
2553       - https://github.com/mozilla-mobile/fenix/issues/11273
2554     data_reviews:
2555       - https://github.com/mozilla-mobile/fenix/pull/12036
2556       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2557     data_sensitivity:
2558       - interaction
2559     notification_emails:
2560       - fenix-core@mozilla.com
2561     expires: "2021-08-01"
2562
2563 collections:
2564   renamed:
2565     type: event
2566     description: |
2567       A user renamed a collection
2568     bugs:
2569       - https://github.com/mozilla-mobile/fenix/issues/969
2570     data_reviews:
2571       - https://github.com/mozilla-mobile/fenix/pull/3935
2572       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2573       - https://github.com/mozilla-mobile/fenix/pull/18143
2574     data_sensitivity:
2575       - technical
2576       - interaction
2577     notification_emails:
2578       - fenix-core@mozilla.com
2579     expires: "2021-07-01"
2580   tab_restored:
2581     type: event
2582     description: |
2583       A user restored a tab from collection tab list
2584     bugs:
2585       - https://github.com/mozilla-mobile/fenix/issues/969
2586     data_reviews:
2587       - https://github.com/mozilla-mobile/fenix/pull/3935
2588       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2589       - https://github.com/mozilla-mobile/fenix/pull/18143
2590     data_sensitivity:
2591       - technical
2592       - interaction
2593     notification_emails:
2594       - fenix-core@mozilla.com
2595     expires: "2021-07-01"
2596   all_tabs_restored:
2597     type: event
2598     description: |
2599       A user tapped "open tabs" from collection menu
2600     bugs:
2601       - https://github.com/mozilla-mobile/fenix/issues/969
2602     data_reviews:
2603       - https://github.com/mozilla-mobile/fenix/pull/3935
2604       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2605       - https://github.com/mozilla-mobile/fenix/pull/18143
2606     data_sensitivity:
2607       - technical
2608       - interaction
2609     notification_emails:
2610       - fenix-core@mozilla.com
2611     expires: "2021-07-01"
2612   tab_removed:
2613     type: event
2614     description: |
2615       A user tapped remove tab from collection tab list
2616     bugs:
2617       - https://github.com/mozilla-mobile/fenix/issues/969
2618     data_reviews:
2619       - https://github.com/mozilla-mobile/fenix/pull/3935
2620       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2621       - https://github.com/mozilla-mobile/fenix/pull/18143
2622     data_sensitivity:
2623       - technical
2624       - interaction
2625     notification_emails:
2626       - fenix-core@mozilla.com
2627     expires: "2021-07-01"
2628   shared:
2629     type: event
2630     description: |
2631       A user tapped share collection
2632     bugs:
2633       - https://github.com/mozilla-mobile/fenix/issues/969
2634     data_reviews:
2635       - https://github.com/mozilla-mobile/fenix/pull/3935
2636       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2637       - https://github.com/mozilla-mobile/fenix/pull/18143
2638     data_sensitivity:
2639       - technical
2640       - interaction
2641     notification_emails:
2642       - fenix-core@mozilla.com
2643     expires: "2021-07-01"
2644   removed:
2645     type: event
2646     description: |
2647       A user tapped delete collection from collection menu
2648     bugs:
2649       - https://github.com/mozilla-mobile/fenix/issues/969
2650     data_reviews:
2651       - https://github.com/mozilla-mobile/fenix/pull/3935
2652       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2653       - https://github.com/mozilla-mobile/fenix/pull/18143
2654     data_sensitivity:
2655       - technical
2656       - interaction
2657     notification_emails:
2658       - fenix-core@mozilla.com
2659     expires: "2021-07-01"
2660   saved:
2661     type: event
2662     description: |
2663       A user saved a list of tabs to a new collection
2664     extra_keys:
2665       tabs_open:
2666         description: "The number of tabs open in the current session"
2667       tabs_selected:
2668         description: "The number of tabs added to the collection"
2669     bugs:
2670       - https://github.com/mozilla-mobile/fenix/issues/969
2671     data_reviews:
2672       - https://github.com/mozilla-mobile/fenix/pull/3935
2673       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2674       - https://github.com/mozilla-mobile/fenix/pull/18143
2675     data_sensitivity:
2676       - technical
2677       - interaction
2678     notification_emails:
2679       - fenix-core@mozilla.com
2680     expires: "2021-07-01"
2681   tabs_added:
2682     type: event
2683     description: |
2684       A user saved a list of tabs to an existing collection
2685     extra_keys:
2686       tabs_open:
2687         description: "The number of tabs open in the current session"
2688       tabs_selected:
2689         description: "The number of tabs added to the collection"
2690     bugs:
2691       - https://github.com/mozilla-mobile/fenix/issues/969
2692     data_reviews:
2693       - https://github.com/mozilla-mobile/fenix/pull/3935
2694       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2695       - https://github.com/mozilla-mobile/fenix/pull/18143
2696     data_sensitivity:
2697       - technical
2698       - interaction
2699     notification_emails:
2700       - fenix-core@mozilla.com
2701     expires: "2021-07-01"
2702   tab_select_opened:
2703     type: event
2704     description: |
2705       A user opened the select tabs screen (the first step of the collection
2706       creation flow)
2707     bugs:
2708       - https://github.com/mozilla-mobile/fenix/issues/969
2709     data_reviews:
2710       - https://github.com/mozilla-mobile/fenix/pull/3935
2711       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2712       - https://github.com/mozilla-mobile/fenix/pull/18143
2713     data_sensitivity:
2714       - technical
2715       - interaction
2716     notification_emails:
2717       - fenix-core@mozilla.com
2718     expires: "2021-07-01"
2719   add_tab_button:
2720     type: event
2721     description: |
2722       A user tapped the "add tab" button in the three dot menu of collections
2723     bugs:
2724       - https://github.com/mozilla-mobile/fenix/issues/969
2725     data_reviews:
2726       - https://github.com/mozilla-mobile/fenix/pull/4358
2727       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2728       - https://github.com/mozilla-mobile/fenix/pull/18143
2729     data_sensitivity:
2730       - interaction
2731     notification_emails:
2732       - fenix-core@mozilla.com
2733     expires: "2021-07-01"
2734   long_press:
2735     type: event
2736     description: |
2737       A user long pressed on a tab, triggering the collection creation screen
2738     bugs:
2739       - https://github.com/mozilla-mobile/fenix/issues/969
2740     data_reviews:
2741       - https://github.com/mozilla-mobile/fenix/pull/4358
2742       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2743       - https://github.com/mozilla-mobile/fenix/pull/18143
2744     data_sensitivity:
2745       - interaction
2746     notification_emails:
2747       - fenix-core@mozilla.com
2748     expires: "2021-07-01"
2749   save_button:
2750     type: event
2751     description: |
2752       A user pressed the "save to collection" button on either the home or
2753       browser screen, triggering the collection creation screen to open
2754       (tab_select_opened)
2755     bugs:
2756       - https://github.com/mozilla-mobile/fenix/issues/969
2757     data_reviews:
2758       - https://github.com/mozilla-mobile/fenix/pull/4358
2759       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2760       - https://github.com/mozilla-mobile/fenix/pull/18143
2761     data_sensitivity:
2762       - interaction
2763     notification_emails:
2764       - fenix-core@mozilla.com
2765     expires: "2021-07-01"
2766     extra_keys:
2767       from_screen:
2768         description: |
2769           A string representing the screen from which the user pressed the save
2770           button. Currently one of: `browserMenu`, `homeMenu` or `home`
2771   rename_button:
2772     type: event
2773     description: |
2774       A user pressed the "rename collection" button in the three dot menu
2775     bugs:
2776       - https://github.com/mozilla-mobile/fenix/issues/969
2777     data_reviews:
2778       - https://github.com/mozilla-mobile/fenix/pull/4539
2779       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2780       - https://github.com/mozilla-mobile/fenix/pull/18143
2781     data_sensitivity:
2782       - interaction
2783     notification_emails:
2784       - fenix-core@mozilla.com
2785     expires: "2021-07-01"
2786
2787 search_widget:
2788   new_tab_button:
2789     type: event
2790     description: |
2791       A user pressed anywhere from the Firefox logo until the start of the
2792       microphone icon, opening a new tab search screen.
2793     bugs:
2794       - https://github.com/mozilla-mobile/fenix/issues/4457
2795     data_reviews:
2796       - https://github.com/mozilla-mobile/fenix/pull/4714
2797       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2798     data_sensitivity:
2799       - interaction
2800     notification_emails:
2801       - fenix-core@mozilla.com
2802     expires: "2021-08-01"
2803   voice_button:
2804     type: event
2805     description: |
2806       A user pressed the microphone icon, opening a new voice search screen.
2807     bugs:
2808       - https://github.com/mozilla-mobile/fenix/issues/4457
2809     data_reviews:
2810       - https://github.com/mozilla-mobile/fenix/pull/4714
2811       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2812     data_sensitivity:
2813       - interaction
2814     notification_emails:
2815       - fenix-core@mozilla.com
2816     expires: "2021-08-01"
2817
2818 private_browsing_mode:
2819   snackbar_undo:
2820     type: event
2821     description: |
2822       A user pressed the "undo" button in the snackbar that is shown when the
2823       garbage icon is tapped.
2824     bugs:
2825       - https://github.com/mozilla-mobile/fenix/issues/4658
2826     data_reviews:
2827       - https://github.com/mozilla-mobile/fenix/pull/4968
2828       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2829     data_sensitivity:
2830       - interaction
2831     notification_emails:
2832       - fenix-core@mozilla.com
2833     expires: "2021-08-01"
2834   notification_tapped:
2835     type: event
2836     description: |
2837       A user pressed the private browsing mode notification itself.
2838     bugs:
2839       - https://github.com/mozilla-mobile/fenix/issues/4658
2840     data_reviews:
2841       - https://github.com/mozilla-mobile/fenix/pull/4968
2842       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2843     data_sensitivity:
2844       - interaction
2845     notification_emails:
2846       - fenix-core@mozilla.com
2847     expires: "2021-08-01"
2848
2849 contextual_hint.tracking_protection:
2850   display:
2851     type: event
2852     description: |
2853       The enhanced tracking protection contextual hint was
2854       displayed.
2855     bugs:
2856       - https://github.com/mozilla-mobile/fenix/issues/9625
2857     data_reviews:
2858       - https://github.com/mozilla-mobile/fenix/pull/11923
2859       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2860       - https://github.com/mozilla-mobile/fenix/pull/18143
2861     data_sensitivity:
2862       - interaction
2863     notification_emails:
2864       - fenix-core@mozilla.com
2865     expires: "2021-07-01"
2866   dismiss:
2867     type: event
2868     description: |
2869       The enhanced tracking protection contextual hint was
2870       dismissed
2871       by pressing the close button
2872     bugs:
2873       - https://github.com/mozilla-mobile/fenix/issues/9625
2874     data_reviews:
2875       - https://github.com/mozilla-mobile/fenix/pull/11923
2876       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2877       - https://github.com/mozilla-mobile/fenix/pull/18143
2878     data_sensitivity:
2879       - interaction
2880     notification_emails:
2881       - fenix-core@mozilla.com
2882     expires: "2021-07-01"
2883   outside_tap:
2884     type: event
2885     description: |
2886       The user tapped outside of the etp contextual hint
2887       (which has no effect).
2888     bugs:
2889       - https://github.com/mozilla-mobile/fenix/issues/9625
2890     data_reviews:
2891       - https://github.com/mozilla-mobile/fenix/pull/11923
2892       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2893       - https://github.com/mozilla-mobile/fenix/pull/18143
2894     data_sensitivity:
2895       - interaction
2896     notification_emails:
2897       - fenix-core@mozilla.com
2898     expires: "2021-07-01"
2899   inside_tap:
2900     type: event
2901     description: |
2902       The user tapped inside of the etp contextual hint
2903       (which brings up the etp panel for this site).
2904     bugs:
2905       - https://github.com/mozilla-mobile/fenix/issues/9625
2906     data_reviews:
2907       - https://github.com/mozilla-mobile/fenix/pull/11923
2908       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
2909       - https://github.com/mozilla-mobile/fenix/pull/18143
2910     data_sensitivity:
2911       - interaction
2912     notification_emails:
2913       - fenix-core@mozilla.com
2914     expires: "2021-07-01"
2915
2916 tracking_protection:
2917   exception_added:
2918     type: event
2919     description: |
2920       A user added a tracking protection exception through the TP toggle in the
2921       panel.
2922     bugs:
2923       - https://github.com/mozilla-mobile/fenix/issues/5312
2924     data_reviews:
2925       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
2926       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2927     data_sensitivity:
2928       - interaction
2929     notification_emails:
2930       - fenix-core@mozilla.com
2931     expires: "2021-08-01"
2932   panel_settings:
2933     type: event
2934     description: |
2935       A user opened tracking protection settings from the panel.
2936     bugs:
2937       - https://github.com/mozilla-mobile/fenix/issues/5312
2938     data_reviews:
2939       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
2940       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2941     data_sensitivity:
2942       - interaction
2943     notification_emails:
2944       - fenix-core@mozilla.com
2945     expires: "2021-08-01"
2946   etp_shield:
2947     type: event
2948     description: |
2949       A user pressed the tracking protection shield icon in toolbar.
2950     bugs:
2951       - https://github.com/mozilla-mobile/fenix/issues/5312
2952     data_reviews:
2953       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
2954       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2955     data_sensitivity:
2956       - interaction
2957     notification_emails:
2958       - fenix-core@mozilla.com
2959     expires: "2021-08-01"
2960   etp_tracker_list:
2961     type: event
2962     description: |
2963       A user pressed into a list of categorized trackers in tracking protection
2964       panel.
2965     bugs:
2966       - https://github.com/mozilla-mobile/fenix/issues/5312
2967     data_reviews:
2968       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
2969       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2970     data_sensitivity:
2971       - interaction
2972     notification_emails:
2973       - fenix-core@mozilla.com
2974     expires: "2021-08-01"
2975   etp_settings:
2976     type: event
2977     description: |
2978       A user opened tracking protection settings through settings.
2979     bugs:
2980       - https://github.com/mozilla-mobile/fenix/issues/5312
2981     data_reviews:
2982       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
2983       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
2984     data_sensitivity:
2985       - interaction
2986     notification_emails:
2987       - fenix-core@mozilla.com
2988     expires: "2021-08-01"
2989   etp_setting_changed:
2990     type: event
2991     description: |
2992       A user changed their tracking protection level setting to either strict,
2993       standard, or custom.
2994     extra_keys:
2995       etp_setting:
2996         description: "The new setting for ETP: strict, standard, custom"
2997     bugs:
2998       - https://github.com/mozilla-mobile/fenix/issues/5312
2999       - https://github.com/mozilla-mobile/fenix/issues/11063
3000     data_reviews:
3001       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
3002       - https://github.com/mozilla-mobile/fenix/pull/11383
3003       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3004     data_sensitivity:
3005       - interaction
3006     notification_emails:
3007       - fenix-core@mozilla.com
3008     expires: "2021-08-01"
3009
3010 private_browsing_shortcut:
3011   create_shortcut:
3012     type: event
3013     description: |
3014       A user pressed the "Add private browsing shortcut" button in settings.
3015     bugs:
3016       - https://github.com/mozilla-mobile/fenix/issues/4658
3017     data_reviews:
3018       - https://github.com/mozilla-mobile/fenix/pull/5194
3019       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3020     data_sensitivity:
3021       - interaction
3022     notification_emails:
3023       - fenix-core@mozilla.com
3024     expires: "2021-08-01"
3025   cfr_add_shortcut:
3026     type: event
3027     description: |
3028       A user pressed the "Add shortcut" button when the contextual feature
3029       recommender appeared.
3030     bugs:
3031       - https://github.com/mozilla-mobile/fenix/issues/4658
3032     data_reviews:
3033       - https://github.com/mozilla-mobile/fenix/pull/5194
3034       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3035     data_sensitivity:
3036       - interaction
3037     notification_emails:
3038       - fenix-core@mozilla.com
3039     expires: "2021-08-01"
3040   cfr_cancel:
3041     type: event
3042     description: |
3043       A user pressed the "No thanks" button when the contextual feature
3044       recommender appeared.
3045     bugs:
3046       - https://github.com/mozilla-mobile/fenix/issues/4658
3047     data_reviews:
3048       - https://github.com/mozilla-mobile/fenix/pull/5194
3049       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3050     data_sensitivity:
3051       - interaction
3052     notification_emails:
3053       - fenix-core@mozilla.com
3054     expires: "2021-08-01"
3055   pinned_shortcut_priv:
3056     type: event
3057     description: |
3058       A user pressed the pinned private shortcut in Android home screen, opening
3059       up a new private search.
3060     bugs:
3061       - https://github.com/mozilla-mobile/fenix/issues/4658
3062     data_reviews:
3063       - https://github.com/mozilla-mobile/fenix/pull/5194
3064       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3065     data_sensitivity:
3066       - interaction
3067     notification_emails:
3068       - fenix-core@mozilla.com
3069     expires: "2021-08-01"
3070   static_shortcut_tab:
3071     type: event
3072     description: |
3073       A user pressed the long-press shortcut "Open new tab", opening up a new
3074       search.
3075     bugs:
3076       - https://github.com/mozilla-mobile/fenix/issues/4658
3077     data_reviews:
3078       - https://github.com/mozilla-mobile/fenix/pull/5194
3079       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3080     data_sensitivity:
3081       - interaction
3082     notification_emails:
3083       - fenix-core@mozilla.com
3084     expires: "2021-08-01"
3085   static_shortcut_priv:
3086     type: event
3087     description: |
3088       A user pressed the long-press shortcut "Open new private tab", opening up
3089       a new private search.
3090     bugs:
3091       - https://github.com/mozilla-mobile/fenix/issues/4658
3092     data_reviews:
3093       - https://github.com/mozilla-mobile/fenix/pull/5194
3094       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3095     data_sensitivity:
3096       - interaction
3097     notification_emails:
3098       - fenix-core@mozilla.com
3099     expires: "2021-08-01"
3100
3101 tab:
3102   media_play:
3103     type: event
3104     description: |
3105       A user pressed the play icon on a tab from the home screen
3106     bugs:
3107       - https://github.com/mozilla-mobile/fenix/issues/5197
3108     data_reviews:
3109       - https://github.com/mozilla-mobile/fenix/pull/5266
3110       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3111     data_sensitivity:
3112       - interaction
3113     notification_emails:
3114       - fenix-core@mozilla.com
3115     expires: "2021-08-01"
3116     no_lint:
3117       - COMMON_PREFIX
3118   media_pause:
3119     type: event
3120     description: |
3121       A user pressed the pause icon on a tab from the home screen
3122     bugs:
3123       - https://github.com/mozilla-mobile/fenix/issues/5197
3124     data_reviews:
3125       - https://github.com/mozilla-mobile/fenix/pull/5266
3126       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3127     data_sensitivity:
3128       - interaction
3129     notification_emails:
3130       - fenix-core@mozilla.com
3131     expires: "2021-08-01"
3132
3133 media_notification:
3134   play:
3135     type: event
3136     description: |
3137       A user pressed the play icon on the media notification
3138     bugs:
3139       - https://github.com/mozilla-mobile/fenix/issues/5197
3140     data_reviews:
3141       - https://github.com/mozilla-mobile/fenix/pull/5520
3142       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3143     data_sensitivity:
3144       - interaction
3145     notification_emails:
3146       - fenix-core@mozilla.com
3147     expires: "2021-08-01"
3148   pause:
3149     type: event
3150     description: |
3151       A user pressed the pause icon on the media notification
3152     bugs:
3153       - https://github.com/mozilla-mobile/fenix/issues/5197
3154     data_reviews:
3155       - https://github.com/mozilla-mobile/fenix/pull/5520
3156       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3157     data_sensitivity:
3158       - interaction
3159     notification_emails:
3160       - fenix-core@mozilla.com
3161     expires: "2021-08-01"
3162
3163 media_state:
3164   play:
3165     type: event
3166     description: |
3167       Media started playing.
3168     bugs:
3169       - https://github.com/mozilla-mobile/fenix/issues/5705
3170     data_reviews:
3171       - https://github.com/mozilla-mobile/fenix/pull/6463
3172       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3173     data_sensitivity:
3174       - interaction
3175     notification_emails:
3176       - fenix-core@mozilla.com
3177     expires: "2021-08-01"
3178   pause:
3179     type: event
3180     description: |
3181       Media playback was paused.
3182     bugs:
3183       - https://github.com/mozilla-mobile/fenix/issues/5705
3184     data_reviews:
3185       - https://github.com/mozilla-mobile/fenix/pull/6463
3186       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3187     data_sensitivity:
3188       - interaction
3189     notification_emails:
3190       - fenix-core@mozilla.com
3191     expires: "2021-08-01"
3192   stop:
3193     type: event
3194     description: |
3195       Media playback has ended.
3196     bugs:
3197       - https://github.com/mozilla-mobile/fenix/issues/5705
3198     data_reviews:
3199       - https://github.com/mozilla-mobile/fenix/pull/6463
3200       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3201     data_sensitivity:
3202       - interaction
3203     notification_emails:
3204       - fenix-core@mozilla.com
3205     expires: "2021-08-01"
3206   fullscreen:
3207     type: event
3208     description: |
3209       Video set to fullscreen.
3210     bugs:
3211       - https://github.com/mozilla-mobile/fenix/issues/15368
3212     data_reviews:
3213       - https://github.com/mozilla-mobile/fenix/pull/16833
3214     data_sensitivity:
3215       - interaction
3216     notification_emails:
3217       - fenix-core@mozilla.com
3218     expires: "2021-08-01"
3219   picture_in_picture:
3220     type: event
3221     description: |
3222       Video set to picture in picture mode.
3223     bugs:
3224       - https://github.com/mozilla-mobile/fenix/issues/15368
3225     data_reviews:
3226       - https://github.com/mozilla-mobile/fenix/pull/16833
3227     data_sensitivity:
3228       - interaction
3229     notification_emails:
3230       - fenix-core@mozilla.com
3231     expires: "2021-08-01"
3232
3233 logins:
3234   open_logins:
3235     type: event
3236     description: |
3237       A user accessed Logins in Settings
3238     bugs:
3239       - https://github.com/mozilla-mobile/fenix/issues/5586
3240     data_reviews:
3241       - https://github.com/mozilla-mobile/fenix/pull/6352
3242       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3243     data_sensitivity:
3244       - interaction
3245     notification_emails:
3246       - fenix-core@mozilla.com
3247     expires: "2021-08-01"
3248   open_individual_login:
3249     type: event
3250     description: |
3251       A user accessed an individual login in saved logins
3252     bugs:
3253       - https://github.com/mozilla-mobile/fenix/issues/5586
3254     data_reviews:
3255       - https://github.com/mozilla-mobile/fenix/pull/6352
3256       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3257     data_sensitivity:
3258       - interaction
3259     notification_emails:
3260       - fenix-core@mozilla.com
3261     expires: "2021-08-01"
3262   copy_login:
3263     type: event
3264     description: |
3265       A user copied a piece of a login in saved logins
3266     bugs:
3267       - https://github.com/mozilla-mobile/fenix/issues/5586
3268     data_reviews:
3269       - https://github.com/mozilla-mobile/fenix/pull/6352
3270       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3271     data_sensitivity:
3272       - interaction
3273     notification_emails:
3274       - fenix-core@mozilla.com
3275     expires: "2021-08-01"
3276   view_password_login:
3277     type: event
3278     description: |
3279       A user viewed a password in an individual saved login
3280     bugs:
3281       - https://github.com/mozilla-mobile/fenix/issues/5586
3282     data_reviews:
3283       - https://github.com/mozilla-mobile/fenix/pull/6352
3284       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3285     data_sensitivity:
3286       - interaction
3287     notification_emails:
3288       - fenix-core@mozilla.com
3289     expires: "2021-08-01"
3290   save_logins_setting_changed:
3291     type: event
3292     description: |
3293       A user changed their setting for asking to save logins
3294     extra_keys:
3295       setting:
3296         description: |
3297           The new setting for saving logins the user selected. Either
3298           `ask_to_save` or `never_save`
3299     bugs:
3300       - https://github.com/mozilla-mobile/fenix/issues/5586
3301     data_reviews:
3302       - https://github.com/mozilla-mobile/fenix/pull/7767
3303       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3304     data_sensitivity:
3305       - interaction
3306     notification_emails:
3307       - fenix-core@mozilla.com
3308     expires: "2021-08-01"
3309   open_login_editor:
3310     type: event
3311     description: |
3312       A user entered the edit screen for an individual saved login
3313     bugs:
3314       - https://github.com/mozilla-mobile/fenix/issues/10173
3315     data_reviews:
3316       - https://github.com/mozilla-mobile/fenix/issues/11208
3317       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3318     data_sensitivity:
3319       - interaction
3320     notification_emails:
3321       - fenix-core@mozilla.com
3322     expires: "2021-08-01"
3323   delete_saved_login:
3324     type: event
3325     description: |
3326       A user confirms delete of a saved login
3327     bugs:
3328       - https://github.com/mozilla-mobile/fenix/issues/10173
3329     data_reviews:
3330       - https://github.com/mozilla-mobile/fenix/issues/11208
3331       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3332     data_sensitivity:
3333       - interaction
3334     notification_emails:
3335       - fenix-core@mozilla.com
3336     expires: "2021-08-01"
3337   save_edited_login:
3338     type: event
3339     description: |
3340       A user saves changes made to an individual login
3341     bugs:
3342       - https://github.com/mozilla-mobile/fenix/issues/10173
3343     data_reviews:
3344       - https://github.com/mozilla-mobile/fenix/issues/11208
3345       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3346     data_sensitivity:
3347       - interaction
3348     notification_emails:
3349       - fenix-core@mozilla.com
3350     expires: "2021-08-01"
3351
3352 download_notification:
3353   resume:
3354     type: event
3355     description: |
3356       A user resumed a download in the download notification
3357     bugs:
3358       - https://github.com/mozilla-mobile/fenix/issues/5583
3359     data_reviews:
3360       - https://github.com/mozilla-mobile/fenix/pull/6554
3361       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3362       - https://github.com/mozilla-mobile/fenix/pull/18143
3363     data_sensitivity:
3364       - interaction
3365     notification_emails:
3366       - fenix-core@mozilla.com
3367     expires: "2021-07-01"
3368   pause:
3369     type: event
3370     description: |
3371       A user paused a download in the download notification
3372     bugs:
3373       - https://github.com/mozilla-mobile/fenix/issues/5583
3374     data_reviews:
3375       - https://github.com/mozilla-mobile/fenix/pull/6554
3376       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3377       - https://github.com/mozilla-mobile/fenix/pull/18143
3378     data_sensitivity:
3379       - interaction
3380     notification_emails:
3381       - fenix-core@mozilla.com
3382     expires: "2021-07-01"
3383   cancel:
3384     type: event
3385     description: |
3386       A user cancelled a download in the download notification
3387     bugs:
3388       - https://github.com/mozilla-mobile/fenix/issues/5583
3389     data_reviews:
3390       - https://github.com/mozilla-mobile/fenix/pull/6554
3391       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3392       - https://github.com/mozilla-mobile/fenix/pull/18143
3393     data_sensitivity:
3394       - interaction
3395     notification_emails:
3396       - fenix-core@mozilla.com
3397     expires: "2021-07-01"
3398   try_again:
3399     type: event
3400     description: |
3401       A user tapped on try again when a download fails in the download
3402       notification
3403     bugs:
3404       - https://github.com/mozilla-mobile/fenix/issues/5583
3405     data_reviews:
3406       - https://github.com/mozilla-mobile/fenix/pull/6554
3407       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3408       - https://github.com/mozilla-mobile/fenix/pull/18143
3409     data_sensitivity:
3410       - interaction
3411     notification_emails:
3412       - fenix-core@mozilla.com
3413     expires: "2021-07-01"
3414   open:
3415     type: event
3416     description: |
3417       A user opened a downloaded file in the download notification
3418     bugs:
3419       - https://github.com/mozilla-mobile/fenix/issues/5583
3420     data_reviews:
3421       - https://github.com/mozilla-mobile/fenix/pull/6554
3422       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3423       - https://github.com/mozilla-mobile/fenix/pull/18143
3424     data_sensitivity:
3425       - interaction
3426     notification_emails:
3427       - fenix-core@mozilla.com
3428     expires: "2021-07-01"
3429   in_app_open:
3430     type: event
3431     description: |
3432       A user opened a downloaded file in the in-app notification link
3433     bugs:
3434       - https://github.com/mozilla-mobile/fenix/issues/5583
3435     data_reviews:
3436       - https://github.com/mozilla-mobile/fenix/pull/6554
3437       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3438       - https://github.com/mozilla-mobile/fenix/pull/18143
3439     data_sensitivity:
3440       - interaction
3441     notification_emails:
3442       - fenix-core@mozilla.com
3443     expires: "2021-07-01"
3444   in_app_try_again:
3445     type: event
3446     description: |
3447       A user tapped on try again when a download fails in the in-app
3448       notification link
3449     bugs:
3450       - https://github.com/mozilla-mobile/fenix/issues/5583
3451     data_reviews:
3452       - https://github.com/mozilla-mobile/fenix/pull/6554
3453       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3454       - https://github.com/mozilla-mobile/fenix/pull/18143
3455     data_sensitivity:
3456       - interaction
3457     notification_emails:
3458       - fenix-core@mozilla.com
3459     expires: "2021-07-01"
3460
3461 downloads_misc:
3462   download_added:
3463     type: event
3464     description:
3465       A counter for how many times something is downloaded in the app.
3466     bugs:
3467       - https://github.com/mozilla-mobile/fenix/issues/11578
3468     data_reviews:
3469       - https://github.com/mozilla-mobile/fenix/pull/16730
3470       - https://github.com/mozilla-mobile/fenix/pull/18143
3471     notification_emails:
3472       - fenix-core@mozilla.com
3473     expires: "2021-07-01"
3474
3475 downloads_management:
3476   downloads_screen_opened:
3477     type: event
3478     description: >
3479       A counter for the number of times users access the "Downloads" folder
3480       inside the app.
3481     bugs:
3482       - https://github.com/mozilla-mobile/fenix/issues/15367
3483     data_reviews:
3484       - https://github.com/mozilla-mobile/fenix/pull/16728
3485       - https://github.com/mozilla-mobile/fenix/pull/18143
3486     notification_emails:
3487       - fenix-core@mozilla.com
3488     expires: "2021-07-01"
3489
3490   item_opened:
3491     type: event
3492     description: >
3493       A counter for how often a user tap to opens a download from inside the
3494       "Downloads" folder.
3495     bugs:
3496       - https://github.com/mozilla-mobile/fenix/issues/15367
3497     data_reviews:
3498       - https://github.com/mozilla-mobile/fenix/pull/16728
3499       - https://github.com/mozilla-mobile/fenix/pull/18143
3500     notification_emails:
3501       - fenix-core@mozilla.com
3502     expires: "2021-07-01"
3503
3504   item_deleted:
3505     type: event
3506     description: >
3507       A counter for how often a user deletes one / more downloads at a time.
3508     bugs:
3509       - https://github.com/mozilla-mobile/fenix/issues/15367
3510     data_reviews:
3511       - https://github.com/mozilla-mobile/fenix/pull/16728
3512       - https://github.com/mozilla-mobile/fenix/pull/18143
3513     notification_emails:
3514       - fenix-core@mozilla.com
3515     expires: "2021-07-01"
3516
3517 user_specified_search_engines:
3518   custom_engine_added:
3519     type: event
3520     description: |
3521       A user added a new custom search engine
3522     bugs:
3523       - https://github.com/mozilla-mobile/fenix/issues/5884
3524     data_reviews:
3525       - https://github.com/mozilla-mobile/fenix/pull/6918
3526       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3527     data_sensitivity:
3528       - interaction
3529     notification_emails:
3530       - fenix-core@mozilla.com
3531     expires: "2021-08-01"
3532     no_lint:
3533       - COMMON_PREFIX
3534   custom_engine_deleted:
3535     type: event
3536     description: |
3537       A user deleted a custom search engine
3538     bugs:
3539       - https://github.com/mozilla-mobile/fenix/issues/5884
3540       - https://github.com/mozilla-mobile/fenix/issues/7881
3541     data_reviews:
3542       - https://github.com/mozilla-mobile/fenix/pull/6918
3543       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3544     data_sensitivity:
3545       - interaction
3546     notification_emails:
3547       - fenix-core@mozilla.com
3548     expires: "2021-08-01"
3549
3550 search_suggestions:
3551   enable_in_private:
3552     type: event
3553     description: |
3554       A user enabled receiving search suggestions in private sessions
3555     bugs:
3556       - https://github.com/mozilla-mobile/fenix/issues/6070
3557     data_reviews:
3558       - https://github.com/mozilla-mobile/fenix/pull/6746
3559       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3560     data_sensitivity:
3561       - technical
3562       - interaction
3563     notification_emails:
3564       - fenix-core@mozilla.com
3565     expires: "2021-08-01"
3566
3567 voice_search:
3568   tapped:
3569     type: event
3570     description: |
3571       A user selected the voice search button on the search screen.
3572     bugs:
3573       - https://github.com/mozilla-mobile/fenix/issues/10465
3574     data_reviews:
3575       - https://github.com/mozilla-mobile/fenix/pull/10785
3576       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3577     data_sensitivity:
3578       - interaction
3579     notification_emails:
3580       - fenix-core@mozilla.com
3581     expires: "2021-08-01"
3582
3583 top_sites:
3584   open_default:
3585     type: event
3586     description: |
3587       A user opened a default top site
3588     bugs:
3589       - https://github.com/mozilla-mobile/fenix/issues/8125
3590     data_reviews:
3591       - https://github.com/mozilla-mobile/fenix/pull/10752
3592       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3593     data_sensitivity:
3594       - interaction
3595     notification_emails:
3596       - fenix-core@mozilla.com
3597     expires: "2021-08-01"
3598   open_google_search_attribution:
3599     type: event
3600     description: |
3601       A user opened the google top site
3602     bugs:
3603       - https://github.com/mozilla-mobile/fenix/issues/17418
3604     data_reviews:
3605       - https://github.com/mozilla-mobile/fenix/pull/17637
3606     data_sensitivity:
3607       - interaction
3608     notification_emails:
3609       - fenix-core@mozilla.com
3610     expires: "2021-08-01"
3611   open_frecency:
3612     type: event
3613     description: |
3614       A user opened a frecency top site
3615     bugs:
3616       - https://github.com/mozilla-mobile/fenix/issues/14565
3617     data_reviews:
3618       - https://github.com/mozilla-mobile/fenix/pull/15136
3619       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3620     data_sensitivity:
3621       - interaction
3622     notification_emails:
3623       - fenix-core@mozilla.com
3624     expires: "2021-08-01"
3625   open_pinned:
3626     type: event
3627     description: |
3628       A user opened a pinned top site
3629     bugs:
3630       - https://github.com/mozilla-mobile/fenix/issues/14565
3631     data_reviews:
3632       - https://github.com/mozilla-mobile/fenix/pull/15136
3633       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3634     data_sensitivity:
3635       - interaction
3636     notification_emails:
3637       - fenix-core@mozilla.com
3638     expires: "2021-08-01"
3639   swipe_carousel:
3640     type: event
3641     description: |
3642       A user swiped to change the page of the top sites carousel
3643     extra_keys:
3644       page:
3645         description: |
3646           The page number the carousel is now on
3647     bugs:
3648       - https://github.com/mozilla-mobile/fenix/issues/14565
3649     data_reviews:
3650       - https://github.com/mozilla-mobile/fenix/pull/15136
3651       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3652     data_sensitivity:
3653       - interaction
3654     notification_emails:
3655       - fenix-core@mozilla.com
3656     expires: "2021-08-01"
3657   long_press:
3658     type: event
3659     description: |
3660       A user long pressed on a top site
3661     extra_keys:
3662       type:
3663         description: |
3664           The type of top site. Options are: "FRECENCY," "DEFAULT," or "PINNED."
3665     bugs:
3666       - https://github.com/mozilla-mobile/fenix/issues/14565
3667     data_reviews:
3668       - https://github.com/mozilla-mobile/fenix/pull/15136
3669       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3670     data_sensitivity:
3671       - interaction
3672     notification_emails:
3673       - fenix-core@mozilla.com
3674     expires: "2021-08-01"
3675   open_in_new_tab:
3676     type: event
3677     description: |
3678       A user opens a new tab based on a top site item
3679     bugs:
3680       - https://github.com/mozilla-mobile/fenix/issues/6757
3681     data_reviews:
3682       - https://github.com/mozilla-mobile/fenix/pull/7523
3683       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3684     data_sensitivity:
3685       - interaction
3686     notification_emails:
3687       - fenix-core@mozilla.com
3688     expires: "2021-08-01"
3689   open_in_private_tab:
3690     type: event
3691     description: |
3692       A user opens a new private tab based on a top site item
3693     bugs:
3694       - https://github.com/mozilla-mobile/fenix/issues/6757
3695     data_reviews:
3696       - https://github.com/mozilla-mobile/fenix/pull/7523
3697       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3698     data_sensitivity:
3699       - interaction
3700     notification_emails:
3701       - fenix-core@mozilla.com
3702     expires: "2021-08-01"
3703   remove:
3704     type: event
3705     description: |
3706       A user removes a top site item
3707     bugs:
3708       - https://github.com/mozilla-mobile/fenix/issues/6757
3709     data_reviews:
3710       - https://github.com/mozilla-mobile/fenix/pull/7523
3711       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3712     data_sensitivity:
3713       - interaction
3714     notification_emails:
3715       - fenix-core@mozilla.com
3716     expires: "2021-08-01"
3717
3718 about_page:
3719   support_tapped:
3720     type: event
3721     description: |
3722       A user tapped on "Support" item from About page
3723     bugs:
3724       - https://github.com/mozilla-mobile/fenix/issues/6834
3725     data_reviews:
3726       - https://github.com/mozilla-mobile/fenix/pull/8047
3727       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3728       - https://github.com/mozilla-mobile/fenix/pull/18143
3729     data_sensitivity:
3730       - interaction
3731     notification_emails:
3732       - fenix-core@mozilla.com
3733     expires: "2021-07-01"
3734   privacy_notice_tapped:
3735     type: event
3736     description: |
3737       A user tapped on "Privacy notice" item from About page
3738     bugs:
3739       - https://github.com/mozilla-mobile/fenix/issues/6834
3740     data_reviews:
3741       - https://github.com/mozilla-mobile/fenix/pull/8047
3742       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3743       - https://github.com/mozilla-mobile/fenix/pull/18143
3744     data_sensitivity:
3745       - interaction
3746     notification_emails:
3747       - fenix-core@mozilla.com
3748     expires: "2021-07-01"
3749
3750 app_theme:
3751   dark_theme_selected:
3752     type: event
3753     description: |
3754       A user selected Dark Theme
3755     extra_keys:
3756       source:
3757         description: |
3758           The source from where dark theme was selected. The source can be
3759           'SETTINGS' or 'ONBOARDING'
3760     bugs:
3761       - https://github.com/mozilla-mobile/fenix/issues/7289
3762     data_reviews:
3763       - https://github.com/mozilla-mobile/fenix/pull/7968
3764       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3765       - https://github.com/mozilla-mobile/fenix/pull/18143
3766     data_sensitivity:
3767       - interaction
3768     notification_emails:
3769       - fenix-core@mozilla.com
3770     expires: "2021-07-01"
3771
3772 pocket:
3773   pocket_top_site_clicked:
3774     type: event
3775     description: |
3776       A user clicked on the trending Pocket top site
3777     bugs:
3778       - https://github.com/mozilla-mobile/fenix/issues/8126
3779     data_reviews:
3780       - https://github.com/mozilla-mobile/fenix/pull/8098
3781       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3782     data_sensitivity:
3783       - interaction
3784     notification_emails:
3785       - fenix-core@mozilla.com
3786     expires: "2021-08-01"
3787     no_lint:
3788       - COMMON_PREFIX
3789
3790   pocket_top_site_removed:
3791     type: event
3792     description: |
3793       A user removed the trending Pocket top site
3794     bugs:
3795       - https://github.com/mozilla-mobile/fenix/issues/8126
3796     data_reviews:
3797       - https://github.com/mozilla-mobile/fenix/pull/8098
3798       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3799     data_sensitivity:
3800       - interaction
3801     notification_emails:
3802       - fenix-core@mozilla.com
3803     expires: "2021-08-01"
3804
3805 first_session:
3806   campaign:
3807     type: string
3808     send_in_pings:
3809       - first-session
3810     description: |
3811       The name of the campaign that is responsible for this installation.
3812     bugs:
3813       - https://github.com/mozilla-mobile/fenix/issues/7295
3814     data_reviews:
3815       - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
3816       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3817     data_sensitivity:
3818       - technical
3819       - interaction
3820     notification_emails:
3821       - fenix-core@mozilla.com
3822     expires: "2021-08-01"
3823   network:
3824     type: string
3825     send_in_pings:
3826       - first-session
3827     description: |
3828       The name of the Network that sourced this installation.
3829     bugs:
3830       - https://github.com/mozilla-mobile/fenix/issues/7295
3831     data_reviews:
3832       - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
3833       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3834     data_sensitivity:
3835       - technical
3836       - interaction
3837     notification_emails:
3838       - fenix-core@mozilla.com
3839     expires: "2021-08-01"
3840   adgroup:
3841     type: string
3842     send_in_pings:
3843       - first-session
3844     description: |
3845       The name of the AdGroup that was used to source this installation.
3846     bugs:
3847       - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
3848     data_reviews:
3849       - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586480836
3850       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3851     data_sensitivity:
3852       - technical
3853       - interaction
3854     notification_emails:
3855       - fenix-core@mozilla.com
3856     expires: "2021-08-01"
3857   creative:
3858     send_in_pings:
3859       - first-session
3860     type: string
3861     description: |
3862       The identifier of the creative material that the user interacted with.
3863     bugs:
3864       - https://github.com/mozilla-mobile/fenix/issues/7295
3865     data_reviews:
3866       - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
3867       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3868     data_sensitivity:
3869       - technical
3870       - interaction
3871     notification_emails:
3872       - fenix-core@mozilla.com
3873     expires: "2021-08-01"
3874   timestamp:
3875     send_in_pings:
3876       - first-session
3877     type: datetime
3878     description: |
3879       The Glean generated date and time of the installation. This is
3880       unique per app install, though the rest of the data in this
3881       ping is from Adjust and will remain static across installs.
3882     bugs:
3883       - https://github.com/mozilla-mobile/fenix/issues/7295
3884     data_reviews:
3885       - https://github.com/mozilla-mobile/fenix/pull/8074#issuecomment-586512202
3886       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3887     data_sensitivity:
3888       - technical
3889       - interaction
3890     notification_emails:
3891       - fenix-core@mozilla.com
3892     expires: "2021-08-01"
3893
3894 browser.search:
3895   with_ads:
3896     type: labeled_counter
3897     description: |
3898       Records counts of SERP pages with adverts displayed.
3899       The key format is ‘<provider-name>’.
3900     send_in_pings:
3901       - metrics
3902     bugs:
3903       - https://github.com/mozilla-mobile/fenix/issues/6558
3904     data_reviews:
3905       - https://github.com/mozilla-mobile/fenix/pull/10112
3906       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3907     data_sensitivity:
3908       - interaction
3909     notification_emails:
3910       - fenix-core@mozilla.com
3911     expires: "2021-08-01"
3912   ad_clicks:
3913     type: labeled_counter
3914     description: |
3915       Records clicks of adverts on SERP pages.
3916       The key format is ‘<provider-name>’.
3917     send_in_pings:
3918       - metrics
3919     bugs:
3920       - https://github.com/mozilla-mobile/fenix/issues/6558
3921     data_reviews:
3922       - https://github.com/mozilla-mobile/fenix/pull/10112
3923       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3924     data_sensitivity:
3925       - interaction
3926     notification_emails:
3927       - fenix-core@mozilla.com
3928     expires: "2021-08-01"
3929   in_content:
3930     type: labeled_counter
3931     description: |
3932       Records the type of interaction a user has on SERP pages.
3933     send_in_pings:
3934       - metrics
3935     bugs:
3936       - https://github.com/mozilla-mobile/fenix/issues/6557
3937     data_reviews:
3938       - https://github.com/mozilla-mobile/fenix/pull/10167
3939       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
3940     data_sensitivity:
3941       - interaction
3942     notification_emails:
3943       - fenix-core@mozilla.com
3944     expires: "2021-08-01"
3945
3946 addons:
3947   open_addons_in_settings:
3948     type: event
3949     description: |
3950       A user accessed "Add-ons" from the Settings
3951     bugs:
3952       - https://github.com/mozilla-mobile/fenix/issues/6174
3953     data_reviews:
3954       - https://github.com/mozilla-mobile/fenix/pull/8318
3955       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3956       - https://github.com/mozilla-mobile/fenix/pull/18143
3957     data_sensitivity:
3958       - interaction
3959     notification_emails:
3960       - fenix-core@mozilla.com
3961     expires: "2021-07-01"
3962   open_addon_in_toolbar_menu:
3963     type: event
3964     description: |
3965       A user interacted with an installed add-on in the toolbar menu
3966     extra_keys:
3967       addon_id:
3968         description: |
3969           The id of the add-on that was interacted with in the toolbar menu
3970     bugs:
3971       - https://github.com/mozilla-mobile/fenix/issues/6174
3972     data_reviews:
3973       - https://github.com/mozilla-mobile/fenix/pull/8318
3974       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
3975       - https://github.com/mozilla-mobile/fenix/pull/18143
3976     data_sensitivity:
3977       - interaction
3978     notification_emails:
3979       - fenix-core@mozilla.com
3980     expires: "2021-07-01"
3981   open_addon_setting:
3982     type: event
3983     description: |
3984       A user opened an add-on's setting
3985     extra_keys:
3986       addon_id:
3987         description: |
3988           The id of the add-on that was interacted with
3989     bugs:
3990       - https://github.com/mozilla-mobile/fenix/issues/17644
3991     data_reviews:
3992       - https://github.com/mozilla-mobile/fenix/pull/18504
3993     data_sensitivity:
3994       - interaction
3995     notification_emails:
3996       - fenix-core@mozilla.com
3997     expires: "2022-08-01"
3998   has_installed_addons:
3999     type: boolean
4000     description: |
4001       Whether or not the user has installed add-ons on the device.
4002     send_in_pings:
4003       - metrics
4004     bugs:
4005       - https://github.com/mozilla-mobile/fenix/issues/6174
4006     data_reviews:
4007       - https://github.com/mozilla-mobile/fenix/pull/8318
4008       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
4009       - https://github.com/mozilla-mobile/fenix/pull/18143
4010     data_sensitivity:
4011       - interaction
4012     notification_emails:
4013       - fenix-core@mozilla.com
4014     expires: "2021-07-01"
4015   has_enabled_addons:
4016     type: boolean
4017     description: |
4018       Whether or not the user has enabled add-ons on the device.
4019     send_in_pings:
4020       - metrics
4021     bugs:
4022       - https://github.com/mozilla-mobile/fenix/issues/6174
4023     data_reviews:
4024       - https://github.com/mozilla-mobile/fenix/pull/8318
4025       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
4026       - https://github.com/mozilla-mobile/fenix/pull/18143
4027     data_sensitivity:
4028       - interaction
4029     notification_emails:
4030       - fenix-core@mozilla.com
4031     expires: "2021-07-01"
4032   installed_addons:
4033     type: string_list
4034     description: |
4035       A list of all installed add-ons on the device.
4036     send_in_pings:
4037       - metrics
4038     bugs:
4039       - https://github.com/mozilla-mobile/fenix/issues/8920
4040     data_reviews:
4041       - https://github.com/mozilla-mobile/fenix/pull/11080
4042       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
4043       - https://github.com/mozilla-mobile/fenix/pull/18143
4044     data_sensitivity:
4045       - interaction
4046     notification_emails:
4047       - fenix-core@mozilla.com
4048     expires: "2021-07-01"
4049   enabled_addons:
4050     type: string_list
4051     description: |
4052       A list of all enabled add-ons on the device.
4053     send_in_pings:
4054       - metrics
4055     bugs:
4056       - https://github.com/mozilla-mobile/fenix/issues/8920
4057     data_reviews:
4058       - https://github.com/mozilla-mobile/fenix/pull/11080
4059       - https://github.com/mozilla-mobile/fenix/pull/13958#issuecomment-676857877
4060       - https://github.com/mozilla-mobile/fenix/pull/18143
4061     data_sensitivity:
4062       - interaction
4063     notification_emails:
4064       - fenix-core@mozilla.com
4065     expires: "2021-07-01"
4066
4067 startup.timeline:
4068   framework_primary:
4069     send_in_pings:
4070       - startup-timeline
4071     type: timespan
4072     time_unit: millisecond
4073     description: |
4074       The duration the Android framework takes to start before letting us run
4075       code in `*Application.init` when this device has
4076       `clock_ticks_per_second_v2` equal to 100: if it's not equal to 100, then
4077       this value is captured in `framework_secondary`. We split this into two
4078       metrics to make it easier to analyze in GLAM. We split on 100 because
4079       when we did our initial brief analysis -
4080       https://sql.telemetry.mozilla.org/queries/75591 - the results for clocks
4081       ticks were overwhelmingly 100.
4082
4083       The duration is calculated from `appInitTimestamp -
4084       processStartTimestamp`. `processStartTimestamp` is derived from the clock
4085       tick time unit, which is expected to be less granular than nanoseconds.
4086       Therefore, we convert and round our timestamps to clock ticks before
4087       computing the difference and convert back to nanoseconds to report.
4088
4089       For debugging purposes, `clock_ticks_per_second_v2`, which may vary
4090       between devices, is also reported as a metric
4091     bugs:
4092       - https://github.com/mozilla-mobile/fenix/issues/8803
4093       - https://github.com/mozilla-mobile/fenix/issues/17972
4094     data_reviews:
4095       - https://github.com/mozilla-mobile/fenix/pull/9788#pullrequestreview-394228626
4096       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
4097       - https://github.com/mozilla-mobile/fenix/pull/18043#issue-575389284
4098     data_sensitivity:
4099       - technical
4100     notification_emails:
4101       - perf-android-fe@mozilla.com
4102       - mcomella@mozilla.com
4103     expires: "2021-08-01"
4104   framework_secondary:
4105     send_in_pings:
4106       - startup-timeline
4107     type: timespan
4108     time_unit: millisecond
4109     description: |
4110       The duration the Android framework takes to start before letting us run
4111       code in `*Application.init` when this device has
4112       `clock_ticks_per_second_v2` not equal to 100. For more details on this
4113       metric, see `framework_primary`
4114     bugs:
4115       - https://github.com/mozilla-mobile/fenix/issues/17972
4116     data_reviews:
4117       - https://github.com/mozilla-mobile/fenix/pull/18043#issue-575389284
4118     data_sensitivity:
4119       - technical
4120     notification_emails:
4121       - perf-android-fe@mozilla.com
4122       - mcomella@mozilla.com
4123     expires: "2021-08-01"
4124   framework_start_error:
4125     send_in_pings:
4126       - startup-timeline
4127     type: boolean
4128     description: |
4129       An error when attempting to record `framework_primary/secondary` - the
4130       application init timestamp returned a negative value - which is likely
4131       indicative of a bug in the implementation.
4132     bugs:
4133       - https://github.com/mozilla-mobile/fenix/issues/8803
4134     data_reviews:
4135       - https://github.com/mozilla-mobile/fenix/pull/9788#pullrequestreview-394228626
4136       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
4137     data_sensitivity:
4138       - technical
4139     notification_emails:
4140       - perf-android-fe@mozilla.com
4141       - mcomella@mozilla.com
4142     expires: "2021-08-01"
4143   framework_start_read_error:
4144     send_in_pings:
4145       - startup-timeline
4146     type: boolean
4147     description: |
4148       An error when attempting to read stats from /proc pseudo-filesystem -
4149       privacy managers can block access to reading these files -
4150       the application will catch a file reading exception.
4151     bugs:
4152       - https://github.com/mozilla-mobile/fenix/issues/10434
4153     data_reviews:
4154       - https://github.com/mozilla-mobile/fenix/pull/10481
4155       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
4156     data_sensitivity:
4157       - technical
4158     notification_emails:
4159       - perf-android-fe@mozilla.com
4160       - mcomella@mozilla.com
4161     expires: "2021-08-01"
4162   clock_ticks_per_second_v2:
4163     send_in_pings:
4164       - startup-timeline
4165     type: quantity
4166     unit: clock ticks per second
4167     description: |
4168       The number of clock tick time units that occur in one second on this
4169       particular device. This value is expected to be used in conjunction with
4170       the `framework_primary/secondary` metrics.
4171     bugs:
4172       - https://github.com/mozilla-mobile/fenix/issues/8803
4173       - https://github.com/mozilla-mobile/fenix/issues/18157
4174     data_reviews:
4175       - https://github.com/mozilla-mobile/fenix/pull/9788#pullrequestreview-394228626
4176       - https://github.com/mozilla-mobile/fenix/pull/15713#issuecomment-703972068
4177       - https://github.com/mozilla-mobile/fenix/pull/18158#issue-579593943
4178     data_sensitivity:
4179       - technical
4180     notification_emails:
4181       - perf-android-fe@mozilla.com
4182       - mcomella@mozilla.com
4183     expires: "2021-08-01"
4184
4185 perf.startup:
4186   cold_main_app_to_first_frame:
4187     type: timing_distribution
4188     time_unit: millisecond
4189     description: |
4190       The duration from `*Application`'s initializer to the first Android frame
4191       being drawn in a [COLD MAIN start
4192       up](https://wiki.mozilla.org/index.php?title=Performance/Fenix/Glossary).
4193       Notably, this duration omits the time from process start to the
4194       initializer (which includes a lengthy dex operation) and the time from
4195       the first frame to visual completeness. This probe doesn't measure Custom
4196       Tabs or other uses of `ExternalAppBrowserActivity` to simplify result
4197       analysis. The methodology for determining this measurement is imperfect
4198       to simplify implementation. Issues may include:
4199       <br>- Not measuring Beta and Release channels (due to
4200       `MigrationDecisionActivity` interrupting the logic).
4201       <br>- Not distinguishing between MAIN to homescreen, onboarding, session
4202       restore, others?
4203       <br>- Not choosing to record a MAIN based on what the user would see and
4204       thus the core code path (i.e. the thing we want to measure) but rather on
4205       the initial `Intent` state.
4206       <br><br>
4207       The hope is that these cases will not have a significant impact on the end
4208       results but, if they appear to, we can replace it with a more complex
4209       implementation.
4210     bugs:
4211       - https://github.com/mozilla-mobile/fenix/issues/18426
4212     data_reviews:
4213       - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
4214     data_sensitivity:
4215       - technical
4216     notification_emails:
4217       - perf-android-fe@mozilla.com
4218       - mcomella@mozilla.com
4219     expires: "2021-08-11"
4220   cold_view_app_to_first_frame:
4221     type: timing_distribution
4222     time_unit: millisecond
4223     description: |
4224       The duration from `*Application`'s initializer to the first Android frame
4225       being drawn in a [COLD VIEW start
4226       up](https://wiki.mozilla.org/index.php?title=Performance/Fenix/Glossary).
4227       The methodology for determining this measurement is imperfect to simplify
4228       implementation. Issues may include:
4229       <br>-Including VIEW intents that aren't valid so take code paths similar
4230       to MAIN (this is speculative)
4231       <br><br>
4232       See the `cold_main_app_to_first_frame` probe docs for other possible
4233       known issues and more details.
4234     bugs:
4235       - https://github.com/mozilla-mobile/fenix/issues/18426
4236     data_reviews:
4237       - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
4238     data_sensitivity:
4239       - technical
4240     notification_emails:
4241       - perf-android-fe@mozilla.com
4242       - mcomella@mozilla.com
4243     expires: "2021-08-11"
4244   cold_unknwn_app_to_first_frame:
4245     type: timing_distribution
4246     time_unit: millisecond
4247     description: |
4248       The duration from `*Application`'s initializer to the first Android frame
4249       being drawn in a [COLD start
4250       up](https://wiki.mozilla.org/index.php?title=Performance/Fenix/Glossary)
4251       where we can't say it was a MAIN or VIEW start up. The methodology for
4252       determining this measurement is imperfect to simplify implementation.
4253       <br><br>
4254       See the `cold_main_app_to_first_frame` probe docs for known issues and
4255       more details.
4256     bugs:
4257       - https://github.com/mozilla-mobile/fenix/issues/18426
4258     data_reviews:
4259       - https://github.com/mozilla-mobile/fenix/pull/18632#issue-600193452
4260     data_sensitivity:
4261       - technical
4262     notification_emails:
4263       - perf-android-fe@mozilla.com
4264       - mcomella@mozilla.com
4265     expires: "2021-08-11"
4266   application_on_create:
4267     type: timing_distribution
4268     time_unit: millisecond
4269     description: |
4270       The duration of `FenixApplication.onCreate` in the main process. This does
4271       not measure the duration of migration code (via
4272       `MigratingFenixApplication` included in the Beta and Release channels.
4273     bugs:
4274       - https://github.com/mozilla-mobile/fenix/issues/17969
4275     data_reviews:
4276       - https://github.com/mozilla-mobile/fenix/pull/17973#issue-572183889
4277     data_sensitivity:
4278       - technical
4279     notification_emails:
4280       - perf-android-fe@mozilla.com
4281       - mcomella@mozilla.com
4282     expires: "2021-08-11"
4283   app_on_create_to_glean_init:
4284     type: timing_distribution
4285     time_unit: millisecond
4286     description: |
4287       A subsection of the duration of `FenixApplication.onCreate` and thus the
4288       `application_on_create` probe from the start of the method through when
4289       `initializeGlean` is called. Note: `initializeGlean` is a no-op for Beta
4290       and Release builds which instead initialize it during
4291       `MigratingFenixApplication`, which we don't currently measure.
4292     bugs:
4293       - https://github.com/mozilla-mobile/fenix/issues/18426
4294     data_reviews:
4295       - https://github.com/mozilla-mobile/fenix/pull/18525#issue-594961170
4296     data_sensitivity:
4297       - technical
4298     notification_emails:
4299       - perf-android-fe@mozilla.com
4300       - mcomella@mozilla.com
4301     expires: "2021-08-11"
4302   app_on_create_to_megazord_init:
4303     type: timing_distribution
4304     time_unit: millisecond
4305     description: |
4306       A subsection of the duration of `FenixApplication.onCreate` and thus the
4307       `application_on_create` probe from after the `app_on_create_to_glean_init`
4308       probe until we block for the megazord to complete set up.
4309     bugs:
4310       - https://github.com/mozilla-mobile/fenix/issues/18426
4311     data_reviews:
4312       - https://github.com/mozilla-mobile/fenix/pull/18525#issue-594961170
4313     data_sensitivity:
4314       - technical
4315     notification_emails:
4316       - perf-android-fe@mozilla.com
4317       - mcomella@mozilla.com
4318     expires: "2021-08-11"
4319   app_on_create_to_setup_in_main:
4320     type: timing_distribution
4321     time_unit: millisecond
4322     description: |
4323       A subsection of the duration of `FenixApplication.onCreate` and thus the
4324       `application_on_create` probe from after the
4325       `app_on_create_to_megazord_init` probe until the end of
4326       `setupInMainProcessOnly`, which is expected to be the end of the
4327       `onCreate` call (unless the implementation later changes).
4328     bugs:
4329       - https://github.com/mozilla-mobile/fenix/issues/18426
4330     data_reviews:
4331       - https://github.com/mozilla-mobile/fenix/pull/18525#issue-594961170
4332     data_sensitivity:
4333       - technical
4334     notification_emails:
4335       - perf-android-fe@mozilla.com
4336       - mcomella@mozilla.com
4337     expires: "2021-08-11"
4338   home_activity_on_create:
4339     type: timing_distribution
4340     time_unit: millisecond
4341     description: |
4342       The duration of `HomeActivity.onCreate`.
4343     bugs:
4344       - https://github.com/mozilla-mobile/fenix/issues/17969
4345     data_reviews:
4346       - https://github.com/mozilla-mobile/fenix/pull/17973#issue-572183889
4347     data_sensitivity:
4348       - technical
4349     notification_emails:
4350       - perf-android-fe@mozilla.com
4351       - mcomella@mozilla.com
4352     expires: "2021-08-11"
4353   home_activity_on_start:
4354     type: timing_distribution
4355     time_unit: millisecond
4356     description: |
4357       The duration of `HomeActivity.onStart`. This may encapsulate
4358       `HomeFragment` or `BrowserFragment` creation, depending on the code path,
4359       so we expect this to take varying amounts of time. As such, this probe may
4360       not be easy to interpret directly but we believe collecting it may give us
4361       more information about different patterns we might see in performance
4362       data.
4363     bugs:
4364       - https://github.com/mozilla-mobile/fenix/issues/18426
4365     data_reviews:
4366       - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
4367     data_sensitivity:
4368       - technical
4369     notification_emails:
4370       - perf-android-fe@mozilla.com
4371       - mcomella@mozilla.com
4372     expires: "2021-08-11"
4373   home_fragment_on_create_view:
4374     type: timing_distribution
4375     time_unit: millisecond
4376     description: |
4377       The duration of `HomeFragment.onCreateView`.
4378     bugs:
4379       - https://github.com/mozilla-mobile/fenix/issues/18426
4380     data_reviews:
4381       - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
4382     data_sensitivity:
4383       - technical
4384     notification_emails:
4385       - perf-android-fe@mozilla.com
4386       - mcomella@mozilla.com
4387     expires: "2021-08-11"
4388   home_fragment_on_view_created:
4389     type: timing_distribution
4390     time_unit: millisecond
4391     description: |
4392       The duration of `HomeFragment.onViewCreated`.
4393     bugs:
4394       - https://github.com/mozilla-mobile/fenix/issues/18426
4395     data_reviews:
4396       - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
4397     data_sensitivity:
4398       - technical
4399     notification_emails:
4400       - perf-android-fe@mozilla.com
4401       - mcomella@mozilla.com
4402     expires: "2021-08-11"
4403   base_bfragment_on_create_view:
4404     type: timing_distribution
4405     time_unit: millisecond
4406     description: |
4407       The duration of `BaseBrowserFragment.onCreateView`.
4408     bugs:
4409       - https://github.com/mozilla-mobile/fenix/issues/18426
4410     data_reviews:
4411       - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
4412     data_sensitivity:
4413       - technical
4414     notification_emails:
4415       - perf-android-fe@mozilla.com
4416       - mcomella@mozilla.com
4417     expires: "2021-08-11"
4418   base_bfragment_on_view_created:
4419     type: timing_distribution
4420     time_unit: millisecond
4421     description: |
4422       The duration of `BaseBrowserFragment.onViewCreated`.
4423     bugs:
4424       - https://github.com/mozilla-mobile/fenix/issues/18426
4425     data_reviews:
4426       - https://github.com/mozilla-mobile/fenix/pull/18558#issue-596791848
4427     data_sensitivity:
4428       - technical
4429     notification_emails:
4430       - perf-android-fe@mozilla.com
4431       - mcomella@mozilla.com
4432     expires: "2021-08-11"
4433
4434 perf.awesomebar:
4435   history_suggestions:
4436     send_in_pings:
4437       - metrics
4438     type: timing_distribution
4439     time_unit: millisecond
4440     description: >
4441       Duration of a history awesomebar suggestion query.
4442     bugs:
4443       - https://github.com/mozilla-mobile/android-components/issues/4992
4444     data_reviews:
4445       - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
4446     data_sensitivity:
4447       - technical
4448       - interaction
4449     notification_emails:
4450       - fenix-core@mozilla.com
4451       - gkruglov@mozilla.com
4452     expires: "2021-11-15"
4453   bookmark_suggestions:
4454     send_in_pings:
4455       - metrics
4456     type: timing_distribution
4457     time_unit: millisecond
4458     description: >
4459       Duration of a bookmarks awesomebar suggestion query.
4460     bugs:
4461       - https://github.com/mozilla-mobile/android-components/issues/4992
4462     data_reviews:
4463       - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
4464     data_sensitivity:
4465       - technical
4466       - interaction
4467     notification_emails:
4468       - fenix-core@mozilla.com
4469       - gkruglov@mozilla.com
4470     expires: "2021-11-15"
4471   search_engine_suggestions:
4472     send_in_pings:
4473       - metrics
4474     type: timing_distribution
4475     time_unit: millisecond
4476     description: >
4477       Duration of a search engine awesomebar suggestion query.
4478     bugs:
4479       - https://github.com/mozilla-mobile/android-components/issues/4992
4480     data_reviews:
4481       - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
4482     data_sensitivity:
4483       - technical
4484       - interaction
4485     notification_emails:
4486       - fenix-core@mozilla.com
4487       - gkruglov@mozilla.com
4488     expires: "2021-11-15"
4489   session_suggestions:
4490     send_in_pings:
4491       - metrics
4492     type: timing_distribution
4493     time_unit: millisecond
4494     description: >
4495       Duration of a session awesomebar suggestion query.
4496     bugs:
4497       - https://github.com/mozilla-mobile/android-components/issues/4992
4498     data_reviews:
4499       - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
4500     data_sensitivity:
4501       - technical
4502       - interaction
4503     notification_emails:
4504       - fenix-core@mozilla.com
4505       - gkruglov@mozilla.com
4506     expires: "2021-11-15"
4507   synced_tabs_suggestions:
4508     send_in_pings:
4509       - metrics
4510     type: timing_distribution
4511     time_unit: millisecond
4512     description: >
4513       Duration of a synced tabs awesomebar suggestion query.
4514     bugs:
4515       - https://github.com/mozilla-mobile/android-components/issues/4992
4516     data_reviews:
4517       - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
4518     data_sensitivity:
4519       - technical
4520       - interaction
4521     notification_emails:
4522       - fenix-core@mozilla.com
4523       - gkruglov@mozilla.com
4524     expires: "2021-11-15"
4525   clipboard_suggestions:
4526     send_in_pings:
4527       - metrics
4528     type: timing_distribution
4529     time_unit: millisecond
4530     description: >
4531       Duration of a clipboard awesomebar suggestion query.
4532     bugs:
4533       - https://github.com/mozilla-mobile/android-components/issues/4992
4534     data_reviews:
4535       - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
4536     data_sensitivity:
4537       - technical
4538       - interaction
4539     notification_emails:
4540       - fenix-core@mozilla.com
4541       - gkruglov@mozilla.com
4542     expires: "2021-11-15"
4543   shortcuts_suggestions:
4544     send_in_pings:
4545       - metrics
4546     type: timing_distribution
4547     time_unit: millisecond
4548     description: >
4549       Duration of a shortcuts awesomebar suggestion query.
4550     bugs:
4551       - https://github.com/mozilla-mobile/android-components/issues/4992
4552     data_reviews:
4553       - https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979
4554     data_sensitivity:
4555       - technical
4556       - interaction
4557     notification_emails:
4558       - fenix-core@mozilla.com
4559       - gkruglov@mozilla.com
4560     expires: "2021-11-15"
4561
4562 autoplay:
4563   visited_setting:
4564     type: event
4565     description: A user visited the autoplay settings screen
4566     bugs:
4567       - https://github.com/mozilla-mobile/fenix/issues/11579
4568     data_reviews:
4569       - https://github.com/mozilla-mobile/fenix/pull/13041#issuecomment-665777411
4570     data_sensitivity:
4571       - interaction
4572     notification_emails:
4573       - fenix-core@mozilla.com
4574     expires: "2021-08-01"
4575   setting_changed:
4576     type: event
4577     description: |
4578       A user changed their autoplay setting to either block_cellular,
4579       block_audio, or block_all.
4580     extra_keys:
4581       autoplay_setting:
4582         description: |
4583           The new setting for autoplay: block_cellular,
4584           block_audio, or block_all.
4585     bugs:
4586       - https://github.com/mozilla-mobile/fenix/issues/11579
4587     data_reviews:
4588       - https://github.com/mozilla-mobile/fenix/pull/13041#issuecomment-665777411
4589     data_sensitivity:
4590       - interaction
4591     notification_emails:
4592       - fenix-core@mozilla.com
4593     expires: "2021-08-01"
4594
4595 storage.stats:
4596   query_stats_duration:
4597     send_in_pings:
4598       - metrics
4599     type: timing_distribution
4600     description: >
4601       How long it took to query the device for the StorageStats that contain the
4602       file size information. The docs say it may be expensive so we want to
4603       ensure it's not too expensive.  This value is only available on Android
4604       8+.
4605     bugs:
4606       - https://github.com/mozilla-mobile/fenix/issues/12802
4607     data_reviews:
4608       - https://github.com/mozilla-mobile/fenix/pull/12876#issuecomment-666770732
4609       - https://github.com/mozilla-mobile/fenix/pull/17704#issue-564299127
4610     data_sensitivity:
4611       - technical
4612       - interaction
4613     notification_emails:
4614       - fenix-core@mozilla.com
4615       - perf-android-fe@mozilla.com
4616       - mcomella@mozilla.com
4617     expires: "2021-08-01"
4618   app_bytes:
4619     send_in_pings:
4620       - metrics
4621     type: memory_distribution
4622     description: >
4623       The size of the app's APK and related files as installed: this is expected
4624       to be larger than download size. This is the output of
4625       [StorageStats.getAppBytes](https://developer.android.com/reference/android/app/usage/StorageStats#getAppBytes())
4626       so see that for details. This value is only available on Android 8+. A
4627       similar value may be available on the Google Play dashboard: we can use
4628       this value to see if that value is reliable enough.
4629     memory_unit: byte
4630     bugs:
4631       - https://github.com/mozilla-mobile/fenix/issues/12802
4632     data_reviews:
4633       - https://github.com/mozilla-mobile/fenix/pull/12876#issuecomment-666770732
4634       - https://github.com/mozilla-mobile/fenix/pull/17704#issue-564299127
4635     data_sensitivity:
4636       - technical
4637       - interaction
4638     notification_emails:
4639       - fenix-core@mozilla.com
4640       - perf-android-fe@mozilla.com
4641       - mcomella@mozilla.com
4642     expires: "2021-08-01"
4643   cache_bytes:
4644     send_in_pings:
4645       - metrics
4646     type: memory_distribution
4647     description: >
4648       The size of all cached data in the app. This is the output of
4649       [StorageStats.getCacheBytes](https://developer.android.com/reference/android/app/usage/StorageStats#getCacheBytes())
4650       so see that for details. This value is only available on Android 8+.
4651     memory_unit: byte
4652     bugs:
4653       - https://github.com/mozilla-mobile/fenix/issues/12802
4654     data_reviews:
4655       - https://github.com/mozilla-mobile/fenix/pull/12876#issuecomment-666770732
4656       - https://github.com/mozilla-mobile/fenix/pull/17704#issue-564299127
4657     data_sensitivity:
4658       - technical
4659       - interaction
4660     notification_emails:
4661       - fenix-core@mozilla.com
4662       - perf-android-fe@mozilla.com
4663       - mcomella@mozilla.com
4664     expires: "2021-08-01"
4665   data_dir_bytes:
4666     send_in_pings:
4667       - metrics
4668     type: memory_distribution
4669     description: >
4670       The size of all data minus `cache_bytes`. This is the output of
4671       [StorageStats.getDataBytes](https://developer.android.com/reference/android/app/usage/StorageStats#getDataBytes())
4672       except we subtract the value of `cache_bytes` so the cache is not measured
4673       redundantly; see that method for details. This value is only available on
4674       Android 8+.
4675     memory_unit: byte
4676     bugs:
4677       - https://github.com/mozilla-mobile/fenix/issues/12802
4678     data_reviews:
4679       - https://github.com/mozilla-mobile/fenix/pull/12876#issuecomment-666770732
4680       - https://github.com/mozilla-mobile/fenix/pull/17704#issue-564299127
4681     data_sensitivity:
4682       - technical
4683       - interaction
4684     notification_emails:
4685       - fenix-core@mozilla.com
4686       - perf-android-fe@mozilla.com
4687       - mcomella@mozilla.com
4688     expires: "2021-08-01"
4689
4690 progressive_web_app:
4691   homescreen_tap:
4692     type: event
4693     description: |
4694       A user taps on PWA homescreen icon
4695     bugs:
4696       - https://github.com/mozilla-mobile/fenix/issues/10261
4697     data_reviews:
4698       - https://github.com/mozilla-mobile/fenix/pull/11859
4699       - https://github.com/mozilla-mobile/fenix/pull/18071
4700     data_sensitivity:
4701       - interaction
4702     notification_emails:
4703       - fenix-core@mozilla.com
4704       - erichards@mozilla.com
4705     expires: "2021-09-01"
4706   install_tap:
4707     type: event
4708     description: |
4709       A user installs a PWA. Could be a shortcut or added to homescreen.
4710     bugs:
4711       - https://github.com/mozilla-mobile/fenix/issues/10261
4712     data_reviews:
4713       - https://github.com/mozilla-mobile/fenix/pull/11859
4714       - https://github.com/mozilla-mobile/fenix/pull/18071
4715     data_sensitivity:
4716       - interaction
4717     notification_emails:
4718       - fenix-core@mozilla.com
4719       - erichards@mozilla.com
4720     expires: "2021-09-01"
4721   foreground:
4722     type: event
4723     description: |
4724       A user brings the PWA into the foreground.
4725     extra_keys:
4726       time_ms:
4727         description: |
4728           The current time in ms when the PWA was brought to the foreground.
4729     bugs:
4730       - https://github.com/mozilla-mobile/fenix/issues/10261
4731     data_reviews:
4732       - https://github.com/mozilla-mobile/fenix/pull/11859
4733       - https://github.com/mozilla-mobile/fenix/pull/18071
4734     data_sensitivity:
4735       - interaction
4736     notification_emails:
4737       - fenix-core@mozilla.com
4738       - erichards@mozilla.com
4739     expires: "2021-09-01"
4740   background:
4741     type: event
4742     description: |
4743       A user puts the PWA into the background.
4744     extra_keys:
4745       time_ms:
4746         description: |
4747           The current time in ms when the PWA was backgrounded.
4748     bugs:
4749       - https://github.com/mozilla-mobile/fenix/issues/10261
4750     data_reviews:
4751       - https://github.com/mozilla-mobile/fenix/pull/11859
4752       - https://github.com/mozilla-mobile/fenix/pull/18071
4753     data_sensitivity:
4754       - interaction
4755     notification_emails:
4756       - fenix-core@mozilla.com
4757       - erichards@mozilla.com
4758     expires: "2021-09-01"
4759
4760 master_password:
4761   displayed:
4762     type: event
4763     description: |
4764       The master password migration dialog was displayed
4765     bugs:
4766       - https://github.com/mozilla-mobile/fenix/pull/14468#issuecomment-684114534
4767     data_reviews:
4768       - https://github.com/mozilla-mobile/fenix/pull/14468#issuecomment-684114534
4769       - https://github.com/mozilla-mobile/fenix/pull/18071
4770     data_sensitivity:
4771       - interaction
4772     notification_emails:
4773       - fenix-core@mozilla.com
4774     expires: "2021-09-01"
4775   migration:
4776     type: event
4777     description: |
4778       Logins were successfully migrated using a master password.
4779     bugs:
4780       - https://github.com/mozilla-mobile/fenix/pull/14468#issuecomment-684114534
4781     data_reviews:
4782       - https://github.com/mozilla-mobile/fenix/pull/14468#issuecomment-684114534
4783       - https://github.com/mozilla-mobile/fenix/pull/18071
4784     data_sensitivity:
4785       - interaction
4786     notification_emails:
4787       - fenix-core@mozilla.com
4788     expires: "2021-09-01"
4789
4790 tabs:
4791   setting_opened:
4792     type: event
4793     description: |
4794       The tab settings were opened.
4795     bugs:
4796       - https://github.com/mozilla-mobile/fenix/issues/15347#issue-707408975
4797     data_reviews:
4798       - https://github.com/mozilla-mobile/fenix/pull/15811#issuecomment-706402952
4799     data_sensitivity:
4800       - interaction
4801     notification_emails:
4802       - fenix-core@mozilla.com
4803     expires: "2021-08-01"
4804
4805 banner_open_in_app:
4806   displayed:
4807     type: event
4808     description: |
4809       Open in App banner was shown.
4810     bugs:
4811       - https://github.com/mozilla-mobile/fenix/issues/16828
4812     data_reviews:
4813       - https://github.com/mozilla-mobile/fenix/pull/17049
4814     data_sensitivity:
4815       - interaction
4816     notification_emails:
4817       - fenix-core@mozilla.com
4818     expires: "2021-08-01"
4819   dismissed:
4820     type: event
4821     description: |
4822       User tapped 'dismiss' on Open in App banner.
4823     bugs:
4824       - https://github.com/mozilla-mobile/fenix/issues/16828
4825     data_reviews:
4826       - https://github.com/mozilla-mobile/fenix/pull/17049
4827     data_sensitivity:
4828       - interaction
4829     notification_emails:
4830       - fenix-core@mozilla.com
4831     expires: "2021-08-01"
4832   go_to_settings:
4833     type: event
4834     description: |
4835       User tapped 'go to settings' on Open in App banner.
4836     bugs:
4837       - https://github.com/mozilla-mobile/fenix/issues/16828
4838     data_reviews:
4839       - https://github.com/mozilla-mobile/fenix/pull/17049
4840     data_sensitivity:
4841       - interaction
4842     notification_emails:
4843       - fenix-core@mozilla.com
4844     expires: "2021-08-01"
4845
4846 contextual_menu:
4847   copy_tapped:
4848     type: event
4849     description: |
4850       The context menu's 'copy' option was used.
4851     bugs:
4852       - https://github.com/mozilla-mobile/fenix/issues/11580
4853     data_reviews:
4854       - https://github.com/mozilla-mobile/fenix/pull/16968
4855     data_sensitivity:
4856       - interaction
4857     notification_emails:
4858       - fenix-core@mozilla.com
4859     expires: "2021-06-01"
4860   search_tapped:
4861     type: event
4862     description: |
4863       The context menu's 'search' option was used.
4864     bugs:
4865       - https://github.com/mozilla-mobile/fenix/issues/11580
4866     data_reviews:
4867       - https://github.com/mozilla-mobile/fenix/pull/16968
4868     data_sensitivity:
4869       - interaction
4870     notification_emails:
4871       - fenix-core@mozilla.com
4872     expires: "2021-06-01"
4873   select_all_tapped:
4874     type: event
4875     description: |
4876       The context menu's 'select all' option was used.
4877     bugs:
4878       - https://github.com/mozilla-mobile/fenix/issues/11580
4879     data_reviews:
4880       - https://github.com/mozilla-mobile/fenix/pull/16968
4881     data_sensitivity:
4882       - interaction
4883     notification_emails:
4884       - fenix-core@mozilla.com
4885     expires: "2021-06-01"
4886   share_tapped:
4887     type: event
4888     description: |
4889       The context menu's 'share' option was used.
4890     bugs:
4891       - https://github.com/mozilla-mobile/fenix/issues/11580
4892     data_reviews:
4893       - https://github.com/mozilla-mobile/fenix/pull/16968
4894     data_sensitivity:
4895       - interaction
4896     notification_emails:
4897       - fenix-core@mozilla.com
4898     expires: "2021-06-01"
4899
4900 engine_tab:
4901   kills:
4902     type: labeled_counter
4903     labels:
4904       - foreground
4905       - background
4906     description: |
4907       How often was the content process of a foreground (selected) or
4908       background tab killed.
4909     bugs:
4910       - https://github.com/mozilla-mobile/android-components/issues/9366
4911     data_reviews:
4912       - https://github.com/mozilla-mobile/fenix/pull/17864
4913     data_sensitivity:
4914       - technical
4915     notification_emails:
4916       - fenix-core@mozilla.com
4917       - skaspari@mozilla.com
4918     expires: "2021-12-31"
4919   kill_foreground_age:
4920     type: timing_distribution
4921     time_unit: millisecond
4922     description: |
4923       Measures the age of the engine session of a foreground (selected) tab
4924       at the time its content process got killed.
4925     bugs:
4926       - https://github.com/mozilla-mobile/android-components/issues/9366
4927     data_reviews:
4928       - https://github.com/mozilla-mobile/fenix/pull/17864
4929     data_sensitivity:
4930       - technical
4931     notification_emails:
4932       - fenix-core@mozilla.com
4933       - skaspari@mozilla.com
4934     expires: "2021-12-31"
4935   kill_background_age:
4936     type: timing_distribution
4937     time_unit: millisecond
4938     description: |
4939       Measures the age of the engine session of a background tab at the
4940       time its content process got killed.
4941     bugs:
4942       - https://github.com/mozilla-mobile/android-components/issues/9366
4943     data_reviews:
4944       - https://github.com/mozilla-mobile/fenix/pull/17864
4945     data_sensitivity:
4946       - technical
4947     notification_emails:
4948       - fenix-core@mozilla.com
4949       - skaspari@mozilla.com
4950     expires: "2021-12-31"
4951   foreground_metrics:
4952     type: event
4953     description: |
4954       Event collecting data about the state of tabs when the app comes back to
4955       the foreground.
4956     bugs:
4957       - https://github.com/mozilla-mobile/android-components/issues/9997
4958     data_reviews:
4959       - https://github.com/mozilla-mobile/fenix/pull/18747#issuecomment-815731764
4960     data_sensitivity:
4961       - technical
4962     notification_emails:
4963       - fenix-core@mozilla.com
4964       - skaspari@mozilla.com
4965     expires: "2021-12-31"
4966     extra_keys:
4967       background_active_tabs:
4968         description: |
4969           Number of active tabs (with an engine session assigned) when the app
4970           went to the background.
4971       background_crashed_tabs:
4972         description: |
4973           Number of tabs marked as crashed when the app went to the background.
4974       background_total_tabs:
4975         description: |
4976           Number of total tabs when the app went to the background.
4977       foreground_active_tabs:
4978         description: |
4979           Number of active tabs (with an engine session assigned) when the
4980           app came back to the foreground.
4981       foreground_crashed_tabs:
4982         description: |
4983           Number of tabs marked as crashed when the app came back to the
4984           foreground.
4985       foreground_total_tabs:
4986         description: |
4987           Number of total tabs when the app came back to the foreground.
4988       time_in_background:
4989         description: |
4990           Time (in milliseconds) the app was in the background.
4991
4992 synced_tabs:
4993   synced_tabs_suggestion_clicked:
4994     type: event
4995     description: |
4996       The synced tab suggestion in awesomebar was clicked.
4997     bugs:
4998       - https://github.com/mozilla-mobile/fenix/issues/18163
4999     data_reviews:
5000       - https://github.com/mozilla-mobile/fenix/pull/18172
5001     data_sensitivity:
5002       - interaction
5003     notification_emails:
5004       - fenix-core@mozilla.com
5005     expires: "2021-08-01"
5006
5007 awesomebar:
5008   bookmark_suggestion_clicked:
5009     type: event
5010     description: |
5011       The bookmark suggestion in awesomebar was clicked.
5012     bugs:
5013       - https://github.com/mozilla-mobile/fenix/issues/18068
5014     data_reviews:
5015       - https://github.com/mozilla-mobile/fenix/pull/18090
5016     data_sensitivity:
5017       - interaction
5018     notification_emails:
5019       - fenix-core@mozilla.com
5020     expires: "2021-08-01"
5021   clipboard_suggestion_clicked:
5022     type: event
5023     description: |
5024       The clipboard suggestion in awesomebar was clicked.
5025     bugs:
5026       - https://github.com/mozilla-mobile/fenix/issues/18068
5027     data_reviews:
5028       - https://github.com/mozilla-mobile/fenix/pull/18090
5029     data_sensitivity:
5030       - interaction
5031     notification_emails:
5032       - fenix-core@mozilla.com
5033     expires: "2021-08-01"
5034   history_suggestion_clicked:
5035     type: event
5036     description: |
5037       The history suggestion in awesomebar was clicked.
5038     bugs:
5039       - https://github.com/mozilla-mobile/fenix/issues/18068
5040     data_reviews:
5041       - https://github.com/mozilla-mobile/fenix/pull/18090
5042     data_sensitivity:
5043       - interaction
5044     notification_emails:
5045       - fenix-core@mozilla.com
5046     expires: "2021-08-01"
5047   search_action_clicked:
5048     type: event
5049     description: |
5050       The search action in awesomebar was clicked.
5051     bugs:
5052       - https://github.com/mozilla-mobile/fenix/issues/18068
5053     data_reviews:
5054       - https://github.com/mozilla-mobile/fenix/pull/18090
5055     data_sensitivity:
5056       - interaction
5057     notification_emails:
5058       - fenix-core@mozilla.com
5059     expires: "2021-08-01"
5060   search_suggestion_clicked:
5061     type: event
5062     description: |
5063       The search suggestion in awesomebar was clicked.
5064     bugs:
5065       - https://github.com/mozilla-mobile/fenix/issues/18068
5066     data_reviews:
5067       - https://github.com/mozilla-mobile/fenix/pull/18090
5068     data_sensitivity:
5069       - interaction
5070     notification_emails:
5071       - fenix-core@mozilla.com
5072     expires: "2021-08-01"
5073   opened_tab_suggestion_clicked:
5074     type: event
5075     description: |
5076       The opened tab suggestion in awesomebar was clicked.
5077     bugs:
5078       - https://github.com/mozilla-mobile/fenix/issues/18068
5079     data_reviews:
5080       - https://github.com/mozilla-mobile/fenix/pull/18090
5081     data_sensitivity:
5082       - interaction
5083     notification_emails:
5084       - fenix-core@mozilla.com
5085     expires: "2021-08-01"
5086
5087 android_keystore_experiment:
5088   experiment_failure:
5089     type: event
5090     description: |
5091       Records an instance of an unexpected failure during the experiment
5092     extra_keys:
5093       failure_exception:
5094         description: |
5095           Exception class associated with an unexpected failure of this
5096           experiment, not caught by the other failure handlers.
5097     bugs:
5098       - https://github.com/mozilla-mobile/fenix/issues/17869
5099     data_reviews:
5100       - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
5101     data_sensitivity:
5102       - technical
5103     notification_emails:
5104       - fenix-core@mozilla.com
5105     expires: "2021-09-01"
5106   get_failure:
5107     type: event
5108     description: |
5109       Unexpected failure when trying to read from secure prefs.
5110     extra_keys:
5111       failure_exception:
5112         description: |
5113           Exception class associated with an unexpected failure of this
5114           experiment.
5115     bugs:
5116       - https://github.com/mozilla-mobile/fenix/issues/17869
5117     data_reviews:
5118       - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
5119     data_sensitivity:
5120       - technical
5121     notification_emails:
5122       - fenix-core@mozilla.com
5123     expires: "2021-09-01"
5124   get_result:
5125     type: event
5126     description: |
5127       Success when trying to read from secure prefs.
5128     extra_keys:
5129       result:
5130         description: |
5131           Result code identifying whether the read operation returned the
5132           expected value or not.
5133     bugs:
5134       - https://github.com/mozilla-mobile/fenix/issues/17869
5135     data_reviews:
5136       - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
5137     data_sensitivity:
5138       - technical
5139     notification_emails:
5140       - fenix-core@mozilla.com
5141     expires: "2021-09-01"
5142   write_failure:
5143     type: event
5144     description: |
5145       Unexpected failure when trying to write to secure prefs.
5146     extra_keys:
5147       failure_exception:
5148         description: |
5149           Exception class associated with an unexpected failure of this
5150           experiment.
5151     bugs:
5152       - https://github.com/mozilla-mobile/fenix/issues/17869
5153     data_reviews:
5154       - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
5155     data_sensitivity:
5156       - technical
5157     notification_emails:
5158       - fenix-core@mozilla.com
5159     expires: "2021-09-01"
5160   write_success:
5161     type: event
5162     description: |
5163       Success in writing to secure prefs.
5164     bugs:
5165       - https://github.com/mozilla-mobile/fenix/issues/17869
5166     data_reviews:
5167       - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
5168     data_sensitivity:
5169       - technical
5170     notification_emails:
5171       - fenix-core@mozilla.com
5172     expires: "2021-09-01"
5173   reset:
5174     type: event
5175     description: |
5176       An experiment failed, and was reset to run again in the future from a
5177       blank state.
5178     bugs:
5179       - https://github.com/mozilla-mobile/fenix/issues/17869
5180     data_reviews:
5181       - https://github.com/mozilla-mobile/fenix/pull/18333#pullrequestreview-612447395
5182     data_sensitivity:
5183       - technical
5184     notification_emails:
5185       - fenix-core@mozilla.com
5186     expires: "2021-09-01"