[fenix] For https://github.com/mozilla-mobile/fenix/issues/6577 - Add `total_uri_coun...
[gecko.git] / mobile / android / fenix / app / metrics.yaml
blobfa962bc12bdc5273ed34a264e115013b5201c956
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/.
6 $schema: moz://mozilla.org/schemas/glean/metrics/1-0-0
8 no_lint:
9   - CATEGORY_GENERIC
11 events:
12   app_opened:
13     type: event
14     description: >
15       A user opened the app
16     extra_keys:
17       source:
18         description: "The method used to open Fenix. Possible values are: `app_icon`, `custom_tab` or `link`"
19     bugs:
20     - https://github.com/mozilla-mobile/fenix/issues/968
21     data_reviews:
22     - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
23     notification_emails:
24     - telemetry-client-dev@mozilla.com
25     - fenix-core@mozilla.com
26     expires: "2020-09-01"
27   search_bar_tapped:
28     type: event
29     description: >
30       A user tapped the search bar
31     extra_keys:
32       source:
33         description: "The view the user was on when they initiated the search (For example: `Home` or `Browser`)"
34     bugs:
35     - https://github.com/mozilla-mobile/fenix/issues/959
36     data_reviews:
37     - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
38     notification_emails:
39     - fenix-core@mozilla.com
40     expires: "2020-09-01"
41   entered_url:
42     type: event
43     description: >
44       A user entered a url
45     extra_keys:
46       autocomplete:
47         description: "A boolean that tells us whether the URL was autofilled by an Autocomplete suggestion"
48     bugs:
49     - https://github.com/mozilla-mobile/fenix/issues/959
50     data_reviews:
51     - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
52     notification_emails:
53     - fenix-core@mozilla.com
54     expires: "2020-09-01"
55   performed_search:
56     type: event
57     description: >
58       A user performed a search
59     extra_keys:
60       source:
61         description: >
62           A string that tells us how the user performed the search. Possible values are:
63           * default.action
64           * default.suggestion
65           * shortcut.action
66           * shortcut.suggestion
67     bugs:
68     - https://github.com/mozilla-mobile/fenix/issues/959
69     data_reviews:
70     - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
71     - https://github.com/mozilla-mobile/fenix/pull/1677
72     notification_emails:
73     - fenix-core@mozilla.com
74     expires: "2020-09-01"
75   browser_menu_action:
76     type: event
77     description: >
78       A browser menu item was tapped
79     extra_keys:
80       item:
81         description: >
82           A string containing the name of the item the user tapped. These items include:
83           Settings, Library, Help, Desktop Site toggle on/off, Find in Page, New Tab,
84           Private Tab, Share, Report Site Issue, Back/Forward button, Reload Button, Quit,
85           Reader Mode On, Reader Mode Off, Open In App, Add To Top Sites, Add-ons Manager
86     bugs:
87     - https://github.com/mozilla-mobile/fenix/issues/1024
88     data_reviews:
89     - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
90     - https://github.com/mozilla-mobile/fenix/pull/5098#issuecomment-529658996
91     - https://github.com/mozilla-mobile/fenix/pull/6310
92     notification_emails:
93     - fenix-core@mozilla.com
94     expires: "2020-09-01"
95   total_uri_count:
96     type: counter
97     description: >
98       A counter of URIs visited by the user in the current session, including page reloads. This does not include background page requests and URIs from embedded pages or private browsing.
99     send_in_pings:
100     - baseline
101     - metrics
102     bugs:
103     - https://github.com/mozilla-mobile/fenix/issues/1301
104     - https://github.com/mozilla-mobile/fenix/issues/4456
105     data_reviews:
106     - https://github.com/mozilla-mobile/fenix/pull/1785
107     - https://github.com/mozilla-mobile/fenix/pull/8314
108     notification_emails:
109     - fenix-core@mozilla.com
110     expires: "2020-09-01"
111   preference_toggled:
112     type: event
113     description: >
114       A user toggled a boolean preference in settings
115     extra_keys:
116       preference_key:
117         description: "The preference key for the boolean (true/false) preference the user toggled. We currently track:
118           show_search_suggestions, remote_debugging, telemetry, tracking_protection, search_bookmarks,
119           search_browsing_history, show_clipboard_suggestions, show_search_shortcuts, open_links_in_a_private_tab (bug in implementation https://github.com/mozilla-mobile/fenix/issues/7384),
120           pref_key_sync_logins, pref_key_sync_bookmarks, pref_key_sync_history,
121           and pref_key_show_search_suggestions_in_private"
122       enabled:
123         description: "Whether or not the preference is *now* enabled"
124     bugs:
125     - https://github.com/mozilla-mobile/fenix/issues/975
126     - https://github.com/mozilla-mobile/fenix/issues/5094
127     - https://github.com/mozilla-mobile/fenix/issues/5737
128     - https://github.com/mozilla-mobile/fenix/issues/5586
129     - https://github.com/mozilla-mobile/fenix/issues/6396
130     - https://github.com/mozilla-mobile/fenix/issues/6070
131     data_reviews:
132     - https://github.com/mozilla-mobile/fenix/pull/1896
133     - https://github.com/mozilla-mobile/fenix/pull/5704
134     - https://github.com/mozilla-mobile/fenix/pull/5886
135     - https://github.com/mozilla-mobile/fenix/pull/5975
136     - https://github.com/mozilla-mobile/fenix/pull/6352
137     - https://github.com/mozilla-mobile/fenix/pull/6601
138     - https://github.com/mozilla-mobile/fenix/pull/6746
139     notification_emails:
140     - fenix-core@mozilla.com
141     expires: "2020-09-01"
142   whats_new_tapped:
143     type: event
144     description: >
145         A user opened the "what's new" page button
146     bugs:
147       - https://github.com/mozilla-mobile/fenix/issues/5021
148     data_reviews:
149       - https://github.com/mozilla-mobile/fenix/pull/5090
150     notification_emails:
151       - fenix-core@mozilla.com
152     expires: "2020-09-01"
153   opened_link:
154     type: event
155     description: >
156         A user opened a link with Fenix
157     extra_keys:
158       mode:
159         description: "The mode the link was opened in. Either 'PRIVATE' or 'NORMAL'"
160     bugs:
161      - https://github.com/mozilla-mobile/fenix/issues/5737
162     data_reviews:
163       - https://github.com/mozilla-mobile/fenix/pull/5975
164     notification_emails:
165       - fenix-core@mozilla.com
166     expires: "2020-09-01"
168 search_shortcuts:
169   selected:
170     type: event
171     description: >
172       A user selected a search shortcut engine to use
173     extra_keys:
174       engine:
175         description: "The name of the built-in search engine the user selected as a string"
176     bugs:
177       - https://github.com/mozilla-mobile/fenix/issues/793
178     data_reviews:
179       - https://github.com/mozilla-mobile/fenix/pull/1202#issuecomment-476870449
180     notification_emails:
181       - fenix-core@mozilla.com
182     expires: "2020-09-01"
184 toolbar_settings:
185   changed_position:
186     type: event
187     description: >
188       The user selected a new position for the toolbar
189     extra_keys:
190       position:
191         description: "A string that indicates the new position of the toolbar TOP or BOTTOM"
192     bugs:
193       - https://github.com/mozilla-mobile/fenix/issues/6054
194     data_reviews:
195       - https://github.com/mozilla-mobile/fenix/pull/6608
196     notification_emails:
197       - fenix-core@mozilla.com
198     expires: "2020-09-01"
200 crash_reporter:
201   opened:
202     type: event
203     description: >
204       The crash reporter was displayed
205     bugs:
206     - https://github.com/mozilla-mobile/fenix/issues/1040
207     data_reviews:
208     - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
209     notification_emails:
210     - fenix-core@mozilla.com
211     expires: "2020-09-01"
212   closed:
213     type: event
214     description: >
215       The crash reporter was closed
216     extra_keys:
217       crash_submitted:
218         description: "A boolean that tells us whether or not the user submitted a crash report"
219     bugs:
220     - https://github.com/mozilla-mobile/fenix/issues/1040
221     data_reviews:
222     - https://github.com/mozilla-mobile/fenix/pull/1214#issue-264756708
223     notification_emails:
224     - fenix-core@mozilla.com
225     expires: "2020-09-01"
227 context_menu:
228   item_tapped:
229     type: event
230     description: >
231       A user tapped an item in the browsers context menu
232     extra_keys:
233       named:
234         description: >
235           The name of the item that was tapped. Available items are
236           ```
237           open_in_new_tab, open_in_private_tab, open_image_in_new_tab,
238           save_image, share_link, copy_link, copy_image_location
239           ```
240     bugs:
241     - https://github.com/mozilla-mobile/fenix/issues/957
242     data_reviews:
243     - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
244     notification_emails:
245     - fenix-core@mozilla.com
246     expires: "2020-09-01"
248 find_in_page:
249   opened:
250     type: event
251     description: >
252       A user opened the find in page UI
253     bugs:
254     - https://github.com/mozilla-mobile/fenix/issues/1036
255     data_reviews:
256     - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
257     notification_emails:
258     - fenix-core@mozilla.com
259     expires: "2020-09-01"
260   closed:
261     type: event
262     description: >
263       A user closed the find in page UI
264     bugs:
265     - https://github.com/mozilla-mobile/fenix/issues/1036
266     data_reviews:
267     - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
268     notification_emails:
269     - fenix-core@mozilla.com
270     expires: "2020-09-01"
271   searched_page:
272     type: event
273     description: >
274       A user searched the page
275     bugs:
276     - https://github.com/mozilla-mobile/fenix/issues/1036
277     data_reviews:
278     - https://github.com/mozilla-mobile/fenix/pull/1344#issuecomment-479285010
279     notification_emails:
280     - fenix-core@mozilla.com
281     expires: "2020-09-01"
283 metrics:
284   default_browser:
285     type: boolean
286     lifetime: application
287     description: >
288       Is Fenix the default browser?
289     send_in_pings:
290     - metrics
291     bugs:
292     - https://github.com/mozilla-mobile/fenix/issues/960
293     data_reviews:
294     - https://github.com/mozilla-mobile/fenix/pull/1067#issuecomment-474598673
295     notification_emails:
296     - fenix-core@mozilla.com
297     expires: "2020-09-01"
298   search_count:
299     type: labeled_counter
300     description: >
301       The labels for this counter are `<search-engine-name>.<source>`.
303       If the search engine is bundled with Fenix `search-engine-name` will be the name of the search engine. If it's a
304       custom search engine (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the value will be `custom`.
306       `source` will be: `action`, `suggestion`, `widget` or `shortcut` (depending on the source from which the search started).
307       Also added the `other` option for the source but it should never enter on this case.
308     send_in_pings:
309     - metrics
310     - baseline
311     bugs:
312     - https://github.com/mozilla-mobile/fenix/issues/1158
313     - https://github.com/mozilla-mobile/fenix/issues/6556
314     data_reviews:
315     - https://github.com/mozilla-mobile/fenix/pull/1677
316     - https://github.com/mozilla-mobile/fenix/pull/5216
317     - https://github.com/mozilla-mobile/fenix/pull/7310
318     notification_emails:
319     - fenix-core@mozilla.com
320     expires: "2020-09-01"
321   mozilla_products:
322     type: string_list
323     lifetime: application
324     description: >
325       A list of all the Mozilla products installed on device. We currently scan for: Firefox, Firefox Beta,
326        Firefox Aurora, Firefox Nightly, Firefox Fdroid, Firefox Lite, Reference Browser, Reference Browser Debug,
327        Fenix, Focus, and Lockwise.
328     send_in_pings:
329     - metrics
330     bugs:
331     - https://github.com/mozilla-mobile/fenix/issues/1192
332     data_reviews:
333     - https://github.com/mozilla-mobile/fenix/pull/1953/
334     - https://github.com/mozilla-mobile/fenix/pull/5216
335     notification_emails:
336     - fenix-core@mozilla.com
337     expires: "2020-09-01"
338   default_moz_browser:
339     type: string
340     lifetime: application
341     description: >
342       The name of the default browser on device if and only if it's a Mozilla owned product
343     send_in_pings:
344     - metrics
345     bugs:
346     - https://github.com/mozilla-mobile/fenix/issues/1192
347     data_reviews:
348     - https://github.com/mozilla-mobile/fenix/pull/1953/
349     - https://github.com/mozilla-mobile/fenix/pull/5216
350     notification_emails:
351     - fenix-core@mozilla.com
352     expires: "2020-09-01"
353   adjust_campaign:
354     type: string
355     lifetime: application
356     description: >
357       A string containing the Adjust campaign ID from which the user installed Fenix. This will not
358       send on the first session the user runs. If the install is organic, this will be empty.
359     send_in_pings:
360       - metrics
361     bugs:
362       - https://github.com/mozilla-mobile/fenix/issues/1298
363     data_reviews:
364       - https://github.com/mozilla-mobile/fenix/pull/5579
365     notification_emails:
366       - fenix-core@mozilla.com
367     expires: "2020-09-01"
368   toolbar_position:
369     type: string
370     lifetime: application
371     description: >
372       A string that indicates the new position of the toolbar TOP or BOTTOM
373     send_in_pings:
374       - metrics
375     bugs:
376       - https://github.com/mozilla-mobile/fenix/issues/6054
377     data_reviews:
378       - https://github.com/mozilla-mobile/fenix/pull/6608
379     notification_emails:
380       - fenix-core@mozilla.com
381     expires: "2020-09-01"
384 search.default_engine:
385   code:
386     type: string
387     lifetime: application
388     description: >
389       If the search engine is pre-loaded with Fenix this value
390       will be the search engine identifier. If it's a custom search engine
391       (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the
392       value will be "custom"
393     send_in_pings:
394     - metrics
395     bugs:
396     - https://github.com/mozilla-mobile/fenix/issues/800
397     data_reviews:
398     - https://github.com/mozilla-mobile/fenix/pull/1606
399     - https://github.com/mozilla-mobile/fenix/pull/5216
400     notification_emails:
401     - fenix-core@mozilla.com
402     expires: "2020-09-01"
403   name:
404     type: string
405     lifetime: application
406     description: >
407       If the search engine is pre-loaded with Fenix this value
408       will be the search engine name. If it's a custom search engine
409       (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the
410       value will be "custom"
411     send_in_pings:
412     - metrics
413     bugs:
414     - https://github.com/mozilla-mobile/fenix/issues/800
415     data_reviews:
416     - https://github.com/mozilla-mobile/fenix/pull/1606
417     - https://github.com/mozilla-mobile/fenix/pull/5216
418     notification_emails:
419     - fenix-core@mozilla.com
420     expires: "2020-09-01"
421   submission_url:
422     type: string
423     lifetime: application
424     description: >
425       If the search engine is pre-loaded with Fenix this value
426       will be he base URL we use to build the search query for the search engine.
427       For example: https://mysearchengine.com/?query=%s. If it's a custom search engine
428       (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the
429       value will be "custom"
430     send_in_pings:
431     - metrics
432     bugs:
433     - https://github.com/mozilla-mobile/fenix/issues/800
434     data_reviews:
435     - https://github.com/mozilla-mobile/fenix/pull/1606
436     - https://github.com/mozilla-mobile/fenix/pull/5216
437     notification_emails:
438     - fenix-core@mozilla.com
439     expires: "2020-09-01"
441 bookmarks_management:
442   open_in_new_tab:
443     type: event
444     description: >
445       A user opened a bookmark in a new tab.
446     bugs:
447     - https://github.com/mozilla-mobile/fenix/issues/974
448     data_reviews:
449     - https://github.com/mozilla-mobile/fenix/pull/1708
450     notification_emails:
451     - fenix-core@mozilla.com
452     expires: "2020-09-01"
453   open_in_new_tabs:
454     type: event
455     description: >
456       A user opened multiple bookmarks at once in new tabs.
457     bugs:
458     - https://github.com/mozilla-mobile/fenix/issues/974
459     data_reviews:
460     - https://github.com/mozilla-mobile/fenix/pull/1708
461     notification_emails:
462     - fenix-core@mozilla.com
463     expires: "2020-09-01"
464   open_in_private_tab:
465     type: event
466     description: >
467       A user opened a bookmark in a new private tab.
468     bugs:
469     - https://github.com/mozilla-mobile/fenix/issues/974
470     data_reviews:
471     - https://github.com/mozilla-mobile/fenix/pull/1708
472     notification_emails:
473     - fenix-core@mozilla.com
474     expires: "2020-09-01"
475   open_in_private_tabs:
476     type: event
477     description: >
478       A user opened multiple bookmarks at once in new private tabs.
479     bugs:
480     - https://github.com/mozilla-mobile/fenix/issues/974
481     data_reviews:
482     - https://github.com/mozilla-mobile/fenix/pull/1708
483     notification_emails:
484     - fenix-core@mozilla.com
485     expires: "2020-09-01"
486   edited:
487     type: event
488     description: >
489       A user edited the title and/or URL of an existing bookmark.
490     bugs:
491     - https://github.com/mozilla-mobile/fenix/issues/974
492     data_reviews:
493     - https://github.com/mozilla-mobile/fenix/pull/1708
494     notification_emails:
495     - fenix-core@mozilla.com
496     expires: "2020-09-01"
497   moved:
498     type: event
499     description: >
500       A user moved an existing bookmark or folder to another folder.
501     bugs:
502     - https://github.com/mozilla-mobile/fenix/issues/974
503     data_reviews:
504     - https://github.com/mozilla-mobile/fenix/pull/1708
505     notification_emails:
506     - fenix-core@mozilla.com
507     expires: "2020-09-01"
508   removed:
509     type: event
510     description: >
511       A user removed a bookmark item.
512     bugs:
513     - https://github.com/mozilla-mobile/fenix/issues/974
514     data_reviews:
515     - https://github.com/mozilla-mobile/fenix/pull/1708
516     notification_emails:
517     - fenix-core@mozilla.com
518     expires: "2020-09-01"
519   multi_removed:
520     type: event
521     description: >
522       A user removed multiple bookmarks at once.
523     bugs:
524     - https://github.com/mozilla-mobile/fenix/issues/974
525     data_reviews:
526     - https://github.com/mozilla-mobile/fenix/pull/1708
527     notification_emails:
528     - fenix-core@mozilla.com
529     expires: "2020-09-01"
530   shared:
531     type: event
532     description: >
533       A user shared a bookmark.
534     bugs:
535     - https://github.com/mozilla-mobile/fenix/issues/974
536     data_reviews:
537     - https://github.com/mozilla-mobile/fenix/pull/1708
538     notification_emails:
539     - fenix-core@mozilla.com
540     expires: "2020-09-01"
541   copied:
542     type: event
543     description: >
544       A user copied a bookmark.
545     bugs:
546     - https://github.com/mozilla-mobile/fenix/issues/974
547     data_reviews:
548     - https://github.com/mozilla-mobile/fenix/pull/1708
549     notification_emails:
550     - fenix-core@mozilla.com
551     expires: "2020-09-01"
552   folder_add:
553     type: event
554     description: >
555       A user added a new bookmark folder.
556     bugs:
557     - https://github.com/mozilla-mobile/fenix/issues/974
558     data_reviews:
559     - https://github.com/mozilla-mobile/fenix/pull/1708
560     notification_emails:
561     - fenix-core@mozilla.com
562     expires: "2020-09-01"
563   folder_remove:
564     type: event
565     description: >
566       A user removed a bookmark folder.
567     bugs:
568       - https://github.com/mozilla-mobile/fenix/issues/3174
569     data_reviews:
570       - https://github.com/mozilla-mobile/fenix/pull/3724
571     notification_emails:
572       - fenix-core@mozilla.com
573     expires: "2020-09-01"
575 custom_tab:
576   closed:
577     type: event
578     description: >
579       A user closed the custom tab
580     bugs:
581     - https://github.com/mozilla-mobile/fenix/issues/977
582     data_reviews:
583     - https://github.com/mozilla-mobile/fenix/pull/1697
584     notification_emails:
585     - fenix-core@mozilla.com
586     expires: "2020-09-01"
587   action_button:
588     type: event
589     description: >
590       A user pressed the action button provided by the launching app
591     bugs:
592     - https://github.com/mozilla-mobile/fenix/issues/977
593     data_reviews:
594     - https://github.com/mozilla-mobile/fenix/pull/1697
595     notification_emails:
596     - fenix-core@mozilla.com
597     expires: "2020-09-01"
598   menu:
599     type: event
600     description: >
601       A user opened the custom tabs menu
602     bugs:
603     - https://github.com/mozilla-mobile/fenix/issues/977
604     data_reviews:
605     - https://github.com/mozilla-mobile/fenix/pull/1697
606     notification_emails:
607     - fenix-core@mozilla.com
608     expires: "2020-09-01"
610 activation:
611   identifier:
612     type: string
613     lifetime: ping
614     description: >
615       A hashed and salted version of the Google Advertising ID from the device.
616       This will never be sent in a ping that also contains the client_id.
617     send_in_pings:
618     - activation
619     bugs:
620     - https://bugzilla.mozilla.org/1538011
621     - https://bugzilla.mozilla.org/1501822
622     data_reviews:
623     - https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
624     notification_emails:
625     - fenix-core@mozilla.com
626     expires: "2020-09-01"
627   activation_id:
628     type: uuid
629     lifetime: user
630     description: >
631       An alternate identifier, not correlated with the client_id, generated once
632       and only sent with the activation ping.
633     send_in_pings:
634     - activation
635     bugs:
636     - https://bugzilla.mozilla.org/1538011
637     data_reviews:
638     - https://github.com/mozilla-mobile/fenix/pull/1707#issuecomment-486972209
639     notification_emails:
640     - fenix-core@mozilla.com
641     expires: "2020-09-01"
643 qr_scanner:
644   opened:
645     type: event
646     description: >
647       A user opened the QR scanner
648     bugs:
649     - https://github.com/mozilla-mobile/fenix/issues/1857
650     data_reviews:
651     - https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
652     notification_emails:
653     - fenix-core@mozilla.com
654     expires: "2020-09-01"
655   prompt_displayed:
656     type: event
657     description: >
658       A user scanned a QR code, causing a confirmation prompt to display asking if they want to navigate to the page
659     bugs:
660     - https://github.com/mozilla-mobile/fenix/issues/1857
661     data_reviews:
662     - https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
663     notification_emails:
664     - fenix-core@mozilla.com
665     expires: "2020-09-01"
666   navigation_allowed:
667     type: event
668     description: >
669       A user tapped "allow" on the prompt, directing the user to the website scanned
670     bugs:
671     - https://github.com/mozilla-mobile/fenix/issues/1857
672     data_reviews:
673     - https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
674     notification_emails:
675     - fenix-core@mozilla.com
676     expires: "2020-09-01"
677   navigation_denied:
678     type: event
679     description: >
680       A user tapped "deny" on the prompt, putting the user back to the scanning view
681     bugs:
682     - https://github.com/mozilla-mobile/fenix/issues/1857
683     data_reviews:
684     - https://github.com/mozilla-mobile/fenix/pull/2524#issuecomment-492739967
685     notification_emails:
686     - fenix-core@mozilla.com
687     expires: "2020-09-01"
689 library:
690   opened:
691     type: event
692     description: >
693       A user opened the library
694     bugs:
695     - https://github.com/mozilla-mobile/fenix/issues/976
696     data_reviews:
697     - https://github.com/mozilla-mobile/fenix/pull/2538#issuecomment-492830242
698     notification_emails:
699     - fenix-core@mozilla.com
700     expires: "2020-09-01"
701   closed:
702     type: event
703     description: >
704       A user closed the library
705     bugs:
706     - https://github.com/mozilla-mobile/fenix/issues/976
707     data_reviews:
708     - https://github.com/mozilla-mobile/fenix/pull/2538#issuecomment-492830242
709     notification_emails:
710     - fenix-core@mozilla.com
711     expires: "2020-09-01"
712   selected_item:
713     type: event
714     description: >
715       A user selected a library item
716     extra_keys:
717       item:
718         description: "The library item the user selected"
719     bugs:
720     - https://github.com/mozilla-mobile/fenix/issues/976
721     data_reviews:
722     - https://github.com/mozilla-mobile/fenix/pull/2538#issuecomment-492830242
723     notification_emails:
724     - fenix-core@mozilla.com
725     expires: "2020-09-01"
727 error_page:
728   visited_error:
729     type: event
730     description: >
731       A user encountered an error page
732     extra_keys:
733       error_type:
734         description: "The error type of the error page encountered"
735     bugs:
736     - https://github.com/mozilla-mobile/fenix/issues/1242
737     data_reviews:
738     - https://github.com/mozilla-mobile/fenix/pull/2491#issuecomment-492414486
739     notification_emails:
740     - fenix-core@mozilla.com
741     expires: "2020-09-01"
743 sync_auth:
744   opened:
745     type: event
746     description: >
747       A user opened the sync authentication page
748     bugs:
749     - https://github.com/mozilla-mobile/fenix/issues/1190
750     data_reviews:
751     - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
752     notification_emails:
753     - fenix-core@mozilla.com
754     expires: "2020-09-01"
755   closed:
756     type: event
757     description: >
758       A user closed the sync page
759     bugs:
760     - https://github.com/mozilla-mobile/fenix/issues/1190
761     data_reviews:
762     - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
763     notification_emails:
764     - fenix-core@mozilla.com
765     expires: "2020-09-01"
766   sign_in:
767     type: event
768     description: >
769       A user pressed the sign in button on the sync authentication page and was successfully signed in to FxA
770     bugs:
771     - https://github.com/mozilla-mobile/fenix/issues/1190
772     data_reviews:
773     - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
774     notification_emails:
775     - fenix-core@mozilla.com
776     expires: "2020-09-01"
777   sign_out:
778     type: event
779     description: >
780       A user pressed the sign out button on the sync account page and was successfully signed out of FxA
781     bugs:
782       - https://github.com/mozilla-mobile/fenix/issues/1190
783     data_reviews:
784       - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
785     notification_emails:
786       - fenix-core@mozilla.com
787     expires: "2020-09-01"
788   sign_up:
789     type: event
790     description: >
791       User registered a new Firefox Account, and was signed into it
792     bugs:
793       - https://github.com/mozilla-mobile/fenix/issues/4971
794     data_reviews:
795       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
796     notification_emails:
797       - fenix-core@mozilla.com
798     expires: "2020-09-01"
799   paired:
800     type: event
801     description: >
802       User signed into FxA by pairing with a different Firefox browser, using a QR code
803     bugs:
804       - https://github.com/mozilla-mobile/fenix/issues/4971
805     data_reviews:
806       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
807     notification_emails:
808       - fenix-core@mozilla.com
809     expires: "2020-09-01"
810   auto_login:
811     type: event
812     description: >
813       User signed into FxA via an account shared from another locally installed Mozilla application (e.g. Fennec)
814     bugs:
815       - https://github.com/mozilla-mobile/fenix/issues/4971
816     data_reviews:
817       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
818     notification_emails:
819       - fenix-core@mozilla.com
820     expires: "2020-09-01"
821   recovered:
822     type: event
823     description: >
824       Account manager automatically recovered FxA authentication state without direct user involvement
825     bugs:
826       - https://github.com/mozilla-mobile/fenix/issues/4971
827     data_reviews:
828       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
829     notification_emails:
830       - fenix-core@mozilla.com
831     expires: "2020-09-01"
832   other_external:
833     type: event
834     description: >
835       User authenticated via FxA using an unknown mechanism. "Known" mechanisms are currently sign-in, sign-up and pairing
836     bugs:
837       - https://github.com/mozilla-mobile/fenix/issues/4971
838     data_reviews:
839       - https://github.com/mozilla-mobile/fenix/pull/4931#issuecomment-529740300
840     notification_emails:
841       - fenix-core@mozilla.com
842     expires: "2020-09-01"
843   scan_pairing:
844     type: event
845     description: >
846       A user pressed the scan pairing button on the sync authentication page
847     bugs:
848     - https://github.com/mozilla-mobile/fenix/issues/1190
849     data_reviews:
850     - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
851     notification_emails:
852     - fenix-core@mozilla.com
853     expires: "2020-09-01"
855 sync_account:
856   opened:
857     type: event
858     description: >
859       A user opened the sync account page
860     bugs:
861     - https://github.com/mozilla-mobile/fenix/issues/1190
862     data_reviews:
863     - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
864     notification_emails:
865     - fenix-core@mozilla.com
866     expires: "2020-09-01"
867   closed:
868     type: event
869     description: >
870       A user closed the sync account page
871     bugs:
872     - https://github.com/mozilla-mobile/fenix/issues/1190
873     data_reviews:
874     - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
875     notification_emails:
876     - fenix-core@mozilla.com
877     expires: "2020-09-01"
878   sync_now:
879     type: event
880     description: >
881       A user pressed the sync now button on the sync account page
882     bugs:
883     - https://github.com/mozilla-mobile/fenix/issues/1190
884     data_reviews:
885     - https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532
886     notification_emails:
887     - fenix-core@mozilla.com
888     expires: "2020-09-01"
889   send_tab:
890     type: event
891     description: >
892       A user sent the current tab to another FxA device
893     bugs:
894       - https://github.com/mozilla-mobile/fenix/issues/4908
895     data_reviews:
896       - https://github.com/mozilla-mobile/fenix/pull/5106
897     notification_emails:
898       - fenix-core@mozilla.com
899     expires: "2020-09-01"
900   sign_in_to_send_tab:
901     type: event
902     description: >
903       A user pressed the "sign in to send tab" button inside the share tab menu
904     bugs:
905       - https://github.com/mozilla-mobile/fenix/issues/4908
906     data_reviews:
907       - https://github.com/mozilla-mobile/fenix/pull/5106
908     notification_emails:
909       - fenix-core@mozilla.com
910     expires: "2020-09-01"
912 history:
913   opened:
914     type: event
915     description: >
916       A user opened the history screen
917     bugs:
918       - https://github.com/mozilla-mobile/fenix/issues/2362
919     data_reviews:
920       - https://github.com/mozilla-mobile/fenix/pull/3940
921     notification_emails:
922       - fenix-core@mozilla.com
923     expires: "2020-09-01"
924   removed:
925     type: event
926     description: >
927       A user removed a history item
928     bugs:
929       - https://github.com/mozilla-mobile/fenix/issues/2362
930     data_reviews:
931       - https://github.com/mozilla-mobile/fenix/pull/3940
932     notification_emails:
933       - fenix-core@mozilla.com
934     expires: "2020-09-01"
935   removed_all:
936     type: event
937     description: >
938       A user removed all history items
939     bugs:
940       - https://github.com/mozilla-mobile/fenix/issues/2362
941     data_reviews:
942       - https://github.com/mozilla-mobile/fenix/pull/3940
943     notification_emails:
944       - fenix-core@mozilla.com
945     expires: "2020-09-01"
946   shared:
947     type: event
948     description: >
949       A user shared a history item
950     bugs:
951       - https://github.com/mozilla-mobile/fenix/issues/2362
952     data_reviews:
953       - https://github.com/mozilla-mobile/fenix/pull/3940
954     notification_emails:
955       - fenix-core@mozilla.com
956     expires: "2020-09-01"
957   opened_item:
958     type: event
959     description: >
960       A user opened a history item
961     bugs:
962       - https://github.com/mozilla-mobile/fenix/issues/2362
963     data_reviews:
964       - https://github.com/mozilla-mobile/fenix/pull/3940
965     notification_emails:
966       - fenix-core@mozilla.com
967     expires: "2020-09-01"
969 reader_mode:
970   available:
971     type: event
972     description: >
973       Reader mode is available for the current page
974     bugs:
975       - https://github.com/mozilla-mobile/fenix/issues/2267
976     data_reviews:
977       - https://github.com/mozilla-mobile/fenix/pull/3941
978     notification_emails:
979       - fenix-core@mozilla.com
980     expires: "2020-09-01"
981   opened:
982     type: event
983     description: >
984       A user opened reader mode
985     bugs:
986       - https://github.com/mozilla-mobile/fenix/issues/2267
987     data_reviews:
988       - https://github.com/mozilla-mobile/fenix/pull/3941
989     notification_emails:
990       - fenix-core@mozilla.com
991     expires: "2020-09-01"
992   closed:
993     type: event
994     description: >
995       A user closed reader mode
996     bugs:
997       - https://github.com/mozilla-mobile/fenix/issues/2267
998     data_reviews:
999       - https://github.com/mozilla-mobile/fenix/pull/4328
1000     notification_emails:
1001       - fenix-core@mozilla.com
1002     expires: "2020-09-01"
1003   appearance:
1004     type: event
1005     description: >
1006       A user tapped the appearance button
1007     bugs:
1008       - https://github.com/mozilla-mobile/fenix/issues/2267
1009     data_reviews:
1010       - https://github.com/mozilla-mobile/fenix/pull/3941
1011     notification_emails:
1012       - fenix-core@mozilla.com
1013     expires: "2020-09-01"
1015 collections:
1016   renamed:
1017     type: event
1018     description: >
1019       A user renamed a collection
1020     bugs:
1021       - https://github.com/mozilla-mobile/fenix/issues/969
1022     data_reviews:
1023       - https://github.com/mozilla-mobile/fenix/pull/3935
1024     notification_emails:
1025       - fenix-core@mozilla.com
1026     expires: "2020-09-01"
1027   tab_restored:
1028     type: event
1029     description: >
1030       A user restored a tab from collection tab list
1031     bugs:
1032       - https://github.com/mozilla-mobile/fenix/issues/969
1033     data_reviews:
1034       - https://github.com/mozilla-mobile/fenix/pull/3935
1035     notification_emails:
1036       - fenix-core@mozilla.com
1037     expires: "2020-09-01"
1038   all_tabs_restored:
1039     type: event
1040     description: >
1041       A user tapped "open tabs" from collection menu
1042     bugs:
1043       - https://github.com/mozilla-mobile/fenix/issues/969
1044     data_reviews:
1045       - https://github.com/mozilla-mobile/fenix/pull/3935
1046     notification_emails:
1047       - fenix-core@mozilla.com
1048     expires: "2020-09-01"
1049   tab_removed:
1050     type: event
1051     description: >
1052       A user tapped remove tab from collection tab list
1053     bugs:
1054       - https://github.com/mozilla-mobile/fenix/issues/969
1055     data_reviews:
1056       - https://github.com/mozilla-mobile/fenix/pull/3935
1057     notification_emails:
1058       - fenix-core@mozilla.com
1059     expires: "2020-09-01"
1060   shared:
1061     type: event
1062     description: >
1063       A user tapped share collection
1064     bugs:
1065       - https://github.com/mozilla-mobile/fenix/issues/969
1066     data_reviews:
1067       - https://github.com/mozilla-mobile/fenix/pull/3935
1068     notification_emails:
1069       - fenix-core@mozilla.com
1070     expires: "2020-09-01"
1071   removed:
1072     type: event
1073     description: >
1074       A user tapped delete collection from collection menu
1075     bugs:
1076       - https://github.com/mozilla-mobile/fenix/issues/969
1077     data_reviews:
1078       - https://github.com/mozilla-mobile/fenix/pull/3935
1079     notification_emails:
1080       - fenix-core@mozilla.com
1081     expires: "2020-09-01"
1082   saved:
1083     type: event
1084     description: >
1085       A user saved a list of tabs to a new collection
1086     extra_keys:
1087       tabs_open:
1088         description: "The number of tabs open in the current session"
1089       tabs_selected:
1090         description: "The number of tabs added to the collection"
1091     bugs:
1092       - https://github.com/mozilla-mobile/fenix/issues/969
1093     data_reviews:
1094       - https://github.com/mozilla-mobile/fenix/pull/3935
1095     notification_emails:
1096       - fenix-core@mozilla.com
1097     expires: "2020-09-01"
1098   tabs_added:
1099     type: event
1100     description: >
1101       A user saved a list of tabs to an existing collection
1102     extra_keys:
1103       tabs_open:
1104         description: "The number of tabs open in the current session"
1105       tabs_selected:
1106         description: "The number of tabs added to the collection"
1107     bugs:
1108       - https://github.com/mozilla-mobile/fenix/issues/969
1109     data_reviews:
1110       - https://github.com/mozilla-mobile/fenix/pull/3935
1111     notification_emails:
1112       - fenix-core@mozilla.com
1113     expires: "2020-09-01"
1114   tab_select_opened:
1115     type: event
1116     description: >
1117       A user opened the select tabs screen (the first step of the collection creation flow)
1118     bugs:
1119       - https://github.com/mozilla-mobile/fenix/issues/969
1120     data_reviews:
1121       - https://github.com/mozilla-mobile/fenix/pull/3935
1122     notification_emails:
1123       - fenix-core@mozilla.com
1124     expires: "2020-09-01"
1125   add_tab_button:
1126     type: event
1127     description: >
1128       A user tapped the "add tab" button in the three dot menu of collections
1129     bugs:
1130       - https://github.com/mozilla-mobile/fenix/issues/969
1131     data_reviews:
1132       - https://github.com/mozilla-mobile/fenix/pull/4358
1133     notification_emails:
1134       - fenix-core@mozilla.com
1135     expires: "2020-09-01"
1136   long_press:
1137     type: event
1138     description: >
1139       A user long pressed on a tab, triggering the collection creation screen
1140     bugs:
1141       - https://github.com/mozilla-mobile/fenix/issues/969
1142     data_reviews:
1143       - https://github.com/mozilla-mobile/fenix/pull/4358
1144     notification_emails:
1145       - fenix-core@mozilla.com
1146     expires: "2020-09-01"
1147   save_button:
1148     type: event
1149     description: >
1150       A user pressed the "save to collection" button on either the home or browser screen, triggering the
1151       collection creation screen to open (tab_select_opened)
1152     bugs:
1153       - https://github.com/mozilla-mobile/fenix/issues/969
1154     data_reviews:
1155       - https://github.com/mozilla-mobile/fenix/pull/4358
1156     notification_emails:
1157       - fenix-core@mozilla.com
1158     expires: "2020-09-01"
1159     extra_keys:
1160       from_screen:
1161         description: >
1162           A string representing the screen from which the user pressed the save button.
1163           Currently one of: `browserMenu`, `homeMenu` or `home`
1164   rename_button:
1165     type: event
1166     description: >
1167       A user pressed the "rename collection" button in the three dot menu
1168     bugs:
1169       - https://github.com/mozilla-mobile/fenix/issues/969
1170     data_reviews:
1171       - https://github.com/mozilla-mobile/fenix/pull/4539
1172     notification_emails:
1173       - fenix-core@mozilla.com
1174     expires: "2020-09-01"
1176 search_widget:
1177   new_tab_button:
1178     type: event
1179     description: >
1180       A user pressed anywhere from the Firefox logo until the start of the microphone icon, opening a
1181       new tab search screen.
1182     bugs:
1183       - https://github.com/mozilla-mobile/fenix/issues/4457
1184     data_reviews:
1185       - https://github.com/mozilla-mobile/fenix/pull/4714
1186     notification_emails:
1187       - fenix-core@mozilla.com
1188     expires: "2020-09-01"
1189   voice_button:
1190     type: event
1191     description: >
1192       A user pressed the microphone icon, opening a new voice search screen.
1193     bugs:
1194       - https://github.com/mozilla-mobile/fenix/issues/4457
1195     data_reviews:
1196       - https://github.com/mozilla-mobile/fenix/pull/4714
1197     notification_emails:
1198       - fenix-core@mozilla.com
1199     expires: "2020-09-01"
1201 private_browsing_mode:
1202   garbage_icon:
1203     type: event
1204     description: >
1205       A user pressed the garbage can icon on the private browsing home page,
1206       deleting all private tabs.
1207     bugs:
1208       - https://github.com/mozilla-mobile/fenix/issues/4658
1209     data_reviews:
1210       - https://github.com/mozilla-mobile/fenix/pull/4968
1211     notification_emails:
1212       - fenix-core@mozilla.com
1213     expires: "2020-09-01"
1214   snackbar_undo:
1215     type: event
1216     description: >
1217       A user pressed the "undo" button in the snackbar that is shown when the garbage icon is
1218       tapped.
1219     bugs:
1220       - https://github.com/mozilla-mobile/fenix/issues/4658
1221     data_reviews:
1222       - https://github.com/mozilla-mobile/fenix/pull/4968
1223     notification_emails:
1224       - fenix-core@mozilla.com
1225     expires: "2020-09-01"
1226   notification_tapped:
1227     type: event
1228     description: >
1229       A user pressed the private browsing mode notification itself.
1230     bugs:
1231       - https://github.com/mozilla-mobile/fenix/issues/4658
1232     data_reviews:
1233       - https://github.com/mozilla-mobile/fenix/pull/4968
1234     notification_emails:
1235       - fenix-core@mozilla.com
1236     expires: "2020-09-01"
1237   notification_open:
1238     type: event
1239     description: >
1240       A user pressed the private browsing mode notification's "Open" button.
1241     bugs:
1242       - https://github.com/mozilla-mobile/fenix/issues/4658
1243     data_reviews:
1244       - https://github.com/mozilla-mobile/fenix/pull/4968
1245     notification_emails:
1246       - fenix-core@mozilla.com
1247     expires: "2020-09-01"
1248   notification_delete:
1249     type: event
1250     description: >
1251       A user pressed the private browsing mode notification's "Delete and Open" button.
1252     bugs:
1253       - https://github.com/mozilla-mobile/fenix/issues/4658
1254     data_reviews:
1255       - https://github.com/mozilla-mobile/fenix/pull/4968
1256     notification_emails:
1257       - fenix-core@mozilla.com
1258     expires: "2020-09-01"
1260 tracking_protection:
1261   exception_added:
1262     type: event
1263     description: >
1264       A user added a tracking protection exception through the TP toggle in the panel.
1265     bugs:
1266       - https://github.com/mozilla-mobile/fenix/issues/5312
1267     data_reviews:
1268       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
1269     notification_emails:
1270       - fenix-core@mozilla.com
1271     expires: "2020-09-01"
1272   panel_settings:
1273     type: event
1274     description: >
1275       A user opened tracking protection settings from the panel.
1276     bugs:
1277       - https://github.com/mozilla-mobile/fenix/issues/5312
1278     data_reviews:
1279       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
1280     notification_emails:
1281       - fenix-core@mozilla.com
1282     expires: "2020-09-01"
1283   etp_shield:
1284     type: event
1285     description: >
1286       A user pressed the tracking protection shield icon in toolbar.
1287     bugs:
1288       - https://github.com/mozilla-mobile/fenix/issues/5312
1289     data_reviews:
1290       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
1291     notification_emails:
1292       - fenix-core@mozilla.com
1293     expires: "2020-09-01"
1294   etp_tracker_list:
1295     type: event
1296     description: >
1297       A user pressed into a list of categorized trackers in tracking protection panel.
1298     bugs:
1299       - https://github.com/mozilla-mobile/fenix/issues/5312
1300     data_reviews:
1301       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
1302     notification_emails:
1303       - fenix-core@mozilla.com
1304     expires: "2020-09-01"
1305   etp_settings:
1306     type: event
1307     description: >
1308       A user opened tracking protection settings through settings.
1309     bugs:
1310       - https://github.com/mozilla-mobile/fenix/issues/5312
1311     data_reviews:
1312       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
1313     notification_emails:
1314       - fenix-core@mozilla.com
1315     expires: "2020-09-01"
1316   etp_setting_changed:
1317     type: event
1318     description: >
1319       A user changed their tracking protection level setting to either strict or standard.
1320     extra_keys:
1321       etp_setting:
1322         description: "The new setting for ETP: strict, standard"
1323     bugs:
1324       - https://github.com/mozilla-mobile/fenix/issues/5312
1325     data_reviews:
1326       - https://github.com/mozilla-mobile/fenix/pull/5414#issuecomment-532847188
1327     notification_emails:
1328       - fenix-core@mozilla.com
1329     expires: "2020-09-01"
1331 private_browsing_shortcut:
1332   create_shortcut:
1333     type: event
1334     description: >
1335       A user pressed the "Add private browsing shortcut" button in settings.
1336     bugs:
1337       - https://github.com/mozilla-mobile/fenix/issues/4658
1338     data_reviews:
1339       - https://github.com/mozilla-mobile/fenix/pull/5194
1340     notification_emails:
1341       - fenix-core@mozilla.com
1342     expires: "2020-09-01"
1343   cfr_add_shortcut:
1344     type: event
1345     description: >
1346       A user pressed the "Add shortcut" button when the contextual feature recommender appeared.
1347     bugs:
1348       - https://github.com/mozilla-mobile/fenix/issues/4658
1349     data_reviews:
1350       - https://github.com/mozilla-mobile/fenix/pull/5194
1351     notification_emails:
1352       - fenix-core@mozilla.com
1353     expires: "2020-09-01"
1354   cfr_cancel:
1355     type: event
1356     description: >
1357       A user pressed the "No thanks" button when the contextual feature recommender appeared.
1358     bugs:
1359       - https://github.com/mozilla-mobile/fenix/issues/4658
1360     data_reviews:
1361       - https://github.com/mozilla-mobile/fenix/pull/5194
1362     notification_emails:
1363       - fenix-core@mozilla.com
1364     expires: "2020-09-01"
1365   pinned_shortcut_priv:
1366     type: event
1367     description: >
1368       A user pressed the pinned private shortcut in Android home screen, opening up a new private search.
1369     bugs:
1370       - https://github.com/mozilla-mobile/fenix/issues/4658
1371     data_reviews:
1372       - https://github.com/mozilla-mobile/fenix/pull/5194
1373     notification_emails:
1374       - fenix-core@mozilla.com
1375     expires: "2020-09-01"
1376   static_shortcut_tab:
1377     type: event
1378     description: >
1379       A user pressed the long-press shortcut "Open new tab", opening up a new search.
1380     bugs:
1381       - https://github.com/mozilla-mobile/fenix/issues/4658
1382     data_reviews:
1383       - https://github.com/mozilla-mobile/fenix/pull/5194
1384     notification_emails:
1385       - fenix-core@mozilla.com
1386     expires: "2020-09-01"
1387   static_shortcut_priv:
1388     type: event
1389     description: >
1390       A user pressed the long-press shortcut "Open new private tab", opening up a new private search.
1391     bugs:
1392       - https://github.com/mozilla-mobile/fenix/issues/4658
1393     data_reviews:
1394       - https://github.com/mozilla-mobile/fenix/pull/5194
1395     notification_emails:
1396       - fenix-core@mozilla.com
1397     expires: "2020-09-01"
1399 tab:
1400   media_play:
1401     type: event
1402     description: >
1403       A user pressed the play icon on a tab from the home screen
1404     bugs:
1405       - https://github.com/mozilla-mobile/fenix/issues/5197
1406     data_reviews:
1407       - https://github.com/mozilla-mobile/fenix/pull/5266
1408     notification_emails:
1409       - fenix-core@mozilla.com
1410     expires: "2020-09-01"
1411     no_lint:
1412       - COMMON_PREFIX
1413   media_pause:
1414     type: event
1415     description: >
1416       A user pressed the pause icon on a tab from the home screen
1417     bugs:
1418       - https://github.com/mozilla-mobile/fenix/issues/5197
1419     data_reviews:
1420       - https://github.com/mozilla-mobile/fenix/pull/5266
1421     notification_emails:
1422       - fenix-core@mozilla.com
1423     expires: "2020-09-01"
1425 media_notification:
1426   play:
1427     type: event
1428     description: >
1429       A user pressed the play icon on the media notification
1430     bugs:
1431       - https://github.com/mozilla-mobile/fenix/issues/5197
1432     data_reviews:
1433       - https://github.com/mozilla-mobile/fenix/pull/5520
1434     notification_emails:
1435       - fenix-core@mozilla.com
1436     expires: "2020-09-01"
1437   pause:
1438     type: event
1439     description: >
1440       A user pressed the pause icon on the media notification
1441     bugs:
1442       - https://github.com/mozilla-mobile/fenix/issues/5197
1443     data_reviews:
1444       - https://github.com/mozilla-mobile/fenix/pull/5520
1445     notification_emails:
1446       - fenix-core@mozilla.com
1447     expires: "2020-09-01"
1449 media_state:
1450   play:
1451     type: event
1452     description: >
1453       Media started playing.
1454     bugs:
1455       - https://github.com/mozilla-mobile/fenix/issues/5705
1456     data_reviews:
1457       - https://github.com/mozilla-mobile/fenix/pull/6463
1458     notification_emails:
1459       - fenix-core@mozilla.com
1460     expires: "2020-09-01"
1461   pause:
1462     type: event
1463     description: >
1464       Media playback was paused.
1465     bugs:
1466       - https://github.com/mozilla-mobile/fenix/issues/5705
1467     data_reviews:
1468       - https://github.com/mozilla-mobile/fenix/pull/6463
1469     notification_emails:
1470       - fenix-core@mozilla.com
1471     expires: "2020-09-01"
1472   stop:
1473     type: event
1474     description: >
1475       Media playback has ended.
1476     bugs:
1477       - https://github.com/mozilla-mobile/fenix/issues/5705
1478     data_reviews:
1479       - https://github.com/mozilla-mobile/fenix/pull/6463
1480     notification_emails:
1481       - fenix-core@mozilla.com
1482     expires: "2020-09-01"
1484 logins:
1485   open_logins:
1486     type: event
1487     description: >
1488       A user accessed Logins in Settings
1489     bugs:
1490       - https://github.com/mozilla-mobile/fenix/issues/5586
1491     data_reviews:
1492       - https://github.com/mozilla-mobile/fenix/pull/6352
1493     notification_emails:
1494       - fenix-core@mozilla.com
1495     expires: "2020-09-01"
1496   open_individual_login:
1497     type: event
1498     description: >
1499       A user accessed an individual login in saved logins
1500     bugs:
1501       - https://github.com/mozilla-mobile/fenix/issues/5586
1502     data_reviews:
1503       - https://github.com/mozilla-mobile/fenix/pull/6352
1504     notification_emails:
1505       - fenix-core@mozilla.com
1506     expires: "2020-09-01"
1507   copy_login:
1508     type: event
1509     description: >
1510       A user copied a piece of a login in saved logins
1511     bugs:
1512       - https://github.com/mozilla-mobile/fenix/issues/5586
1513     data_reviews:
1514       - https://github.com/mozilla-mobile/fenix/pull/6352
1515     notification_emails:
1516       - fenix-core@mozilla.com
1517     expires: "2020-09-01"
1518   view_password_login:
1519     type: event
1520     description: >
1521       A user viewed a password in an individual saved login
1522     bugs:
1523       - https://github.com/mozilla-mobile/fenix/issues/5586
1524     data_reviews:
1525       - https://github.com/mozilla-mobile/fenix/pull/6352
1526     notification_emails:
1527       - fenix-core@mozilla.com
1528     expires: "2020-09-01"
1529   save_logins_setting_changed:
1530     type: event
1531     description: >
1532       A user changed their setting for asking to save logins
1533     extra_keys:
1534       setting:
1535         description: "The new setting for saving logins the user selected. Either `ask_to_save` or `never_save`"
1536     bugs:
1537       - https://github.com/mozilla-mobile/fenix/issues/5586
1538     data_reviews:
1539       - https://github.com/mozilla-mobile/fenix/pull/7767
1540     notification_emails:
1541       - fenix-core@mozilla.com
1542     expires: "2020-09-01"
1544 download_notification:
1545   resume:
1546     type: event
1547     description: >
1548       A user resumed a download in the download notification
1549     bugs:
1550       - https://github.com/mozilla-mobile/fenix/issues/5583
1551     data_reviews:
1552       - https://github.com/mozilla-mobile/fenix/pull/6554
1553     notification_emails:
1554       - fenix-core@mozilla.com
1555     expires: "2020-09-01"
1556   pause:
1557     type: event
1558     description: >
1559       A user paused a download in the download notification
1560     bugs:
1561       - https://github.com/mozilla-mobile/fenix/issues/5583
1562     data_reviews:
1563       - https://github.com/mozilla-mobile/fenix/pull/6554
1564     notification_emails:
1565       - fenix-core@mozilla.com
1566     expires: "2020-09-01"
1567   cancel:
1568     type: event
1569     description: >
1570       A user cancelled a download in the download notification
1571     bugs:
1572       - https://github.com/mozilla-mobile/fenix/issues/5583
1573     data_reviews:
1574       - https://github.com/mozilla-mobile/fenix/pull/6554
1575     notification_emails:
1576       - fenix-core@mozilla.com
1577     expires: "2020-09-01"
1578   try_again:
1579     type: event
1580     description: >
1581       A user tapped on try again when a download fails in the download notification
1582     bugs:
1583       - https://github.com/mozilla-mobile/fenix/issues/5583
1584     data_reviews:
1585       - https://github.com/mozilla-mobile/fenix/pull/6554
1586     notification_emails:
1587       - fenix-core@mozilla.com
1588     expires: "2020-09-01"
1589   open:
1590     type: event
1591     description: >
1592       A user opened a downloaded file in the download notification
1593     bugs:
1594       - https://github.com/mozilla-mobile/fenix/issues/5583
1595     data_reviews:
1596       - https://github.com/mozilla-mobile/fenix/pull/6554
1597     notification_emails:
1598       - fenix-core@mozilla.com
1599     expires: "2020-09-01"
1600   in_app_open:
1601     type: event
1602     description: >
1603       A user opened a downloaded file in the in-app notification link
1604     bugs:
1605       - https://github.com/mozilla-mobile/fenix/issues/5583
1606     data_reviews:
1607       - https://github.com/mozilla-mobile/fenix/pull/6554
1608     notification_emails:
1609       - fenix-core@mozilla.com
1610     expires: "2020-09-01"
1611   in_app_try_again:
1612     type: event
1613     description: >
1614       A user tapped on try again when a download fails in the in-app notification link
1615     bugs:
1616       - https://github.com/mozilla-mobile/fenix/issues/5583
1617     data_reviews:
1618       - https://github.com/mozilla-mobile/fenix/pull/6554
1619     notification_emails:
1620       - fenix-core@mozilla.com
1621     expires: "2020-09-01"
1623 user_specified_search_engines:
1624   custom_engine_added:
1625     type: event
1626     description: >
1627       A user added a new custom search engine
1628     bugs:
1629       - https://github.com/mozilla-mobile/fenix/issues/5884
1630     data_reviews:
1631       - https://github.com/mozilla-mobile/fenix/pull/6918
1632     notification_emails:
1633       - fenix-core@mozilla.com
1634     expires: "2020-09-01"
1635   custom_engine_deleted:
1636     type: event
1637     description: >
1638       A user deleted a custom search engine
1639     bugs:
1640       - https://github.com/mozilla-mobile/fenix/issues/5884
1641       - https://github.com/mozilla-mobile/fenix/issues/7881
1642     data_reviews:
1643       - https://github.com/mozilla-mobile/fenix/pull/6918
1644     notification_emails:
1645       - fenix-core@mozilla.com
1646     expires: "2020-09-01"
1648 search_suggestions:
1649   enable_in_private:
1650     type: event
1651     description: >
1652       A user enabled receiving search suggestions in private sessions
1653     bugs:
1654       - https://github.com/mozilla-mobile/fenix/issues/6070
1655     data_reviews:
1656       - https://github.com/mozilla-mobile/fenix/pull/6746
1657     notification_emails:
1658      - fenix-core@mozilla.com
1659     expires: "2020-09-01"
1661 top_sites:
1662   open_in_new_tab:
1663     type: event
1664     description: >
1665       A user opens a new tab based on a top site item
1666     bugs:
1667       - https://github.com/mozilla-mobile/fenix/issues/6757
1668     data_reviews:
1669       - https://github.com/mozilla-mobile/fenix/pull/7523
1670     notification_emails:
1671       - fenix-core@mozilla.com
1672     expires: "2020-09-01"
1673   open_in_private_tab:
1674     type: event
1675     description: >
1676       A user opens a new private tab based on a top site item
1677     bugs:
1678       - https://github.com/mozilla-mobile/fenix/issues/6757
1679     data_reviews:
1680       - https://github.com/mozilla-mobile/fenix/pull/7523
1681     notification_emails:
1682       - fenix-core@mozilla.com
1683     expires: "2020-09-01"
1684   remove:
1685     type: event
1686     description: >
1687       A user removes a top site item
1688     bugs:
1689       - https://github.com/mozilla-mobile/fenix/issues/6757
1690     data_reviews:
1691       - https://github.com/mozilla-mobile/fenix/pull/7523
1692     notification_emails:
1693       - fenix-core@mozilla.com
1694     expires: "2020-09-01"
1696 about_page:
1697   support_tapped:
1698     type: event
1699     description: >
1700       A user tapped on "Support" item from About page
1701     bugs:
1702       - https://github.com/mozilla-mobile/fenix/issues/6834
1703     data_reviews:
1704       - https://github.com/mozilla-mobile/fenix/pull/8047
1705     notification_emails:
1706       - fenix-core@mozilla.com
1707     expires: "2020-09-01"
1708   privacy_notice_tapped:
1709     type: event
1710     description: >
1711       A user tapped on "Privacy notice" item from About page
1712     bugs:
1713       - https://github.com/mozilla-mobile/fenix/issues/6834
1714     data_reviews:
1715       - https://github.com/mozilla-mobile/fenix/pull/8047
1716     notification_emails:
1717       - fenix-core@mozilla.com
1718     expires: "2020-09-01"
1719   rights_tapped:
1720     type: event
1721     description: >
1722       A user tapped on "Know your rights" item from About page
1723     bugs:
1724       - https://github.com/mozilla-mobile/fenix/issues/6834
1725     data_reviews:
1726       - https://github.com/mozilla-mobile/fenix/pull/8047
1727     notification_emails:
1728       - fenix-core@mozilla.com
1729     expires: "2020-09-01"
1730   licensing_tapped:
1731     type: event
1732     description: >
1733       A user tapped on "Licensing information" item from About page
1734     bugs:
1735       - https://github.com/mozilla-mobile/fenix/issues/6834
1736     data_reviews:
1737       - https://github.com/mozilla-mobile/fenix/pull/8047
1738     notification_emails:
1739       - fenix-core@mozilla.com
1740     expires: "2020-09-01"
1741   libraries_tapped:
1742     type: event
1743     description: >
1744       A user tapped on "Libraries that we use" item from About page
1745     bugs:
1746       - https://github.com/mozilla-mobile/fenix/issues/6834
1747     data_reviews:
1748       - https://github.com/mozilla-mobile/fenix/pull/8047
1749     notification_emails:
1750       - fenix-core@mozilla.com
1751     expires: "2020-09-01"
1753 app_theme:
1754   dark_theme_selected:
1755     type: event
1756     description: >
1757       A user selected Dark Theme
1758     extra_keys:
1759       source:
1760         description: "The source from where dark theme was selected. The source can be 'SETTINGS' or 'ONBOARDING'"
1761     bugs:
1762       - https://github.com/mozilla-mobile/fenix/issues/7289
1763     data_reviews:
1764       - https://github.com/mozilla-mobile/fenix/pull/7968
1765     notification_emails:
1766       - fenix-core@mozilla.com
1767     expires: "2020-09-01"