tor-browser

The Tor Browser
git clone https://git.dasho.dev/tor-browser.git
Log | Files | Refs | README | LICENSE

legacy_metrics.yaml (81662B)


      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  - COMMON_PREFIX
     10 
     11 browser:
     12  default_search_engine:
     13    type: string
     14    lifetime: application
     15    description: |
     16      A string containing the default search engine name.
     17    bugs:
     18      - https://github.com/mozilla-mobile/focus-android/issues/4545
     19    data_reviews:
     20      - https://github.com/mozilla-mobile/focus-android/pull/5065#issuecomment-894328647
     21      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
     22      - https://github.com/mozilla-mobile/firefox-android/pull/3320
     23    data_sensitivity:
     24      - interaction
     25    send_in_pings:
     26      - baseline
     27      - metrics
     28    no_lint:
     29      - BASELINE_PING
     30    notification_emails:
     31      - android-probes@mozilla.com
     32    expires: never
     33  locale_override:
     34    type: string
     35    lifetime: application
     36    description: |
     37      The locale that differs from the system locale if a user
     38      specifically overrides it for the app.
     39    bugs:
     40      - https://github.com/mozilla-mobile/focus-android/issues/4545
     41    data_reviews:
     42      - https://github.com/mozilla-mobile/focus-android/pull/5065#issuecomment-894328647
     43      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
     44      - https://github.com/mozilla-mobile/firefox-android/pull/3320
     45      - https://github.com/mozilla-mobile/firefox-android/pull/4040
     46    data_sensitivity:
     47      - technical
     48    notification_emails:
     49      - android-probes@mozilla.com
     50    expires: never
     51  total_uri_count:
     52    type: counter
     53    description: |
     54      Records count of URIs visited by the user in the current session,
     55      including page reloads.
     56      It does not include background page requests and URIs from embedded pages
     57      but may be incremented without user interaction by website scripts
     58      that programmatically redirect to a new location.
     59    bugs:
     60      - https://github.com/mozilla-mobile/focus-android/issues/5518
     61    data_reviews:
     62      - https://github.com/mozilla-mobile/focus-android/pull/5523
     63    data_sensitivity:
     64      - interaction
     65    notification_emails:
     66      - android-probes@mozilla.com
     67      - mcarare@mozilla.com
     68    send_in_pings:
     69      - metrics
     70      - baseline
     71    no_lint:
     72      - BASELINE_PING
     73    expires: never
     74  install_source:
     75    type: string
     76    lifetime: application
     77    description: Used to identify the source the app was installed from.
     78    bugs:
     79      - https://github.com/mozilla-mobile/focus-android/issues/5684
     80    data_reviews:
     81      - https://github.com/mozilla-mobile/focus-android/pull/5694
     82      - https://github.com/mozilla-mobile/focus-android/pull/7906
     83    data_sensitivity:
     84      - technical
     85    notification_emails:
     86      - android-probes@mozilla.com
     87      - rtestard@mozilla.com
     88    expires: never
     89  back_button_pressed:
     90    type: event
     91    description: Back button has been presed on a browser tab.
     92    bugs:
     93      - https://github.com/mozilla-mobile/focus-android/issues/5914
     94    data_reviews:
     95      - https://github.com/mozilla-mobile/focus-android/pull/5913
     96      - https://github.com/mozilla-mobile/focus-android/pull/7906
     97    data_sensitivity:
     98      - interaction
     99    notification_emails:
    100      - android-probes@mozilla.com
    101      - rtestard@mozilla.com
    102    expires: never
    103    extra_keys:
    104      action_performed:
    105        description: |
    106          The action performed by pressing back button:
    107          erase_to_home or erase_to_external_app.
    108        type: string
    109  report_site_issue_counter:
    110    type: counter
    111    description: |
    112      A counter that indicates how many times a user has tapped
    113      the report site issue from browser menu
    114    bugs:
    115      - https://github.com/mozilla-mobile/focus-android/issues/5897
    116    data_reviews:
    117      - https://github.com/mozilla-mobile/focus-android/pull/5898
    118      - https://github.com/mozilla-mobile/focus-android/pull/7906
    119    data_sensitivity:
    120      - interaction
    121    notification_emails:
    122      - android-probes@mozilla.com
    123      - rtestard@mozilla.com
    124    expires: never
    125 
    126 perf.startup:
    127  startup_type:
    128    type: labeled_counter
    129    description: |
    130      Indicates how the browser was started. The label is divided into two
    131      variables. `state` is how cached the browser is when started. `path` is
    132      what code path we are expected to take. Together, they create a combined
    133      label: `state_path`. For brevity, the specific states are documented in
    134      the [Fenix perf
    135      glossary](https://wiki.mozilla.org/index.php?title=Performance/Fenix/Glossary).
    136      <br><br>
    137      This implementation is intended to be simple, not comprehensive. We list
    138      the implications below.
    139 
    140      <br><br>
    141      These ways of opening the app undesirably adds events to our primary
    142      buckets (non-`unknown` cases):
    143      <br>- App switcher cold/warm: `cold/warm_` + duplicates path from
    144      previous launch
    145      <br>- An Intent is sent internally that's uses `ACTION_MAIN` or
    146      `ACTION_VIEW` could be: `*_main/view` (unknown if this ever happens)
    147      <br>- A command-line launch uses `ACTION_MAIN` or `ACTION_VIEW` could be:
    148      `*_main/view`
    149 
    150      <br><br>
    151      These ways of opening the app undesirably do not add their events to our
    152      primary buckets:
    153      <br>- Close and reopen the app very quickly: no event is recorded.
    154 
    155      <br><br>
    156      These ways of opening the app don't affect our primary buckets:
    157      <br>- App switcher hot: `hot_unknown`
    158      <br>- PWA (all states): `unknown_unknown`
    159      <br>- Custom tab: `unknown_view`
    160      <br>- Cold start where a service or other non-activity starts the process
    161      (not manually tested) - this seems to happen if you have the homescreen
    162      widget: `unknown_*`
    163      <br>- Another activity is drawn before MainActivity or CustomTabActivity
    164      (e.g. widget voice
    165      search): `unknown_*`
    166 
    167      <br>
    168      In addition to the events above, the `unknown` state may be chosen when we
    169      were unable to determine a cause due to implementation details or the API
    170      was used incorrectly. We may be able to record the events listed above
    171      into different buckets but we kept the implementation simple for now.
    172      <br><br>
    173      N.B.: for implementation simplicity, we duplicate the logic in app that
    174      determines `path` so it's not perfectly accurate. In one way, we record we
    175      is intended to happen rather than what actually happened (e.g. the user
    176      may click a link so we record VIEW but the app does a MAIN by going to the
    177      homescreen because the link was invalid).
    178    labels:
    179      - cold_main
    180      - cold_view
    181      - cold_unknown
    182      - warm_main
    183      - warm_view
    184      - warm_unknown
    185      - hot_main
    186      - hot_view
    187      - hot_unknown
    188      - unknown_main
    189      - unknown_view
    190      - unknown_unknown
    191    bugs:
    192      - https://github.com/mozilla-mobile/focus-android/issues/7079
    193    data_reviews:
    194      - https://github.com/mozilla-mobile/focus-android/
    195    data_sensitivity:
    196      - interaction
    197    notification_emails:
    198      - perf-telemetry-alerts@mozilla.com
    199      - mleclair@mozilla.com
    200    expires: never
    201 
    202 activation:
    203  activation_id:
    204    type: uuid
    205    lifetime: user
    206    description: |
    207      An alternate identifier, not correlated with the client_id, generated once
    208      and only sent with the activation ping.
    209    send_in_pings:
    210      - activation
    211    bugs:
    212      - https://github.com/mozilla-mobile/focus-android/issues/4545
    213    data_reviews:
    214      - https://github.com/mozilla-mobile/focus-android/issues/4901
    215    data_sensitivity:
    216      - highly_sensitive
    217    notification_emails:
    218      - android-probes@mozilla.com
    219      - jalmeida@mozilla.com
    220    expires: never
    221 
    222 legacy_ids:
    223  client_id:
    224    type: uuid
    225    description: |
    226      Sets the legacy client ID as part of the deletion-request ping.
    227      **No longer reported set since Focus 124, where legacy telemetry was removed**.
    228    send_in_pings:
    229      - deletion-request
    230    bugs:
    231      - https://github.com/mozilla-mobile/focus-android/issues/4545
    232      - https://bugzilla.mozilla.org/show_bug.cgi?id=1805256
    233    data_reviews:
    234      - https://github.com/mozilla-mobile/focus-android/pull/5512#issuecomment-1023668181
    235      - https://bugzilla.mozilla.org/show_bug.cgi?id=1805256
    236    notification_emails:
    237      - jalmeida@mozilla.com
    238      - android-probes@mozilla.com
    239      - tlong@mozilla.com
    240    expires: never
    241 
    242 browser.search:
    243  with_ads:
    244    type: labeled_counter
    245    description: |
    246      Records counts of SERP pages with adverts displayed.
    247      The key format is
    248      `<provider-name>.in-content.[sap|sap-follow-on|organic].[code|none](.[channel])?`,
    249      where:
    250 
    251      * `provider-name` is the name of the provider,
    252      * `sap|sap-follow-on|organic` is the search access point,
    253      * `code` is set when the url matches any of the provider's code prefixes,
    254      * `channel` is set to the url "channel" query parameter.
    255    send_in_pings:
    256      - metrics
    257    bugs:
    258      - https://github.com/mozilla-mobile/fenix/issues/4967
    259      - https://bugzilla.mozilla.org/show_bug.cgi?id=1804057
    260      - https://bugzilla.mozilla.org/show_bug.cgi?id=1799049
    261      - https://bugzilla.mozilla.org/show_bug.cgi?id=1809447
    262      - https://bugzilla.mozilla.org/show_bug.cgi?id=1925028
    263    data_reviews:
    264      - https://github.com/mozilla-mobile/focus-android/pull/4968#issuecomment-879256443
    265      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    266      - https://github.com/mozilla-mobile/focus-android/pull/8109#issuecomment-1337394286
    267      - https://github.com/mozilla-mobile/firefox-android/pull/523#issuecomment-1377494482
    268      - https://bugzilla.mozilla.org/show_bug.cgi?id=1925028
    269    data_sensitivity:
    270      - interaction
    271    notification_emails:
    272      - android-probes@mozilla.com
    273      - rtestard@mozilla.com
    274    expires: never
    275  ad_clicks:
    276    type: labeled_counter
    277    description: |
    278      Records clicks of adverts on SERP pages.
    279      The key format is
    280      `<provider-name>.in-content.[sap|sap-follow-on|organic].[code|none](.[channel])?`,
    281      where:
    282 
    283      * `provider-name` is the name of the provider,
    284      * `sap|sap-follow-on|organic` is the search access point,
    285      * `code` is set when the url matches any of the provider's code prefixes,
    286      * `channel` is set to the url "channel" query parameter.
    287    send_in_pings:
    288      - metrics
    289      - baseline
    290    no_lint:
    291      - BASELINE_PING
    292    bugs:
    293      - https://github.com/mozilla-mobile/fenix/issues/4967
    294      - https://bugzilla.mozilla.org/show_bug.cgi?id=1804057
    295      - https://bugzilla.mozilla.org/show_bug.cgi?id=1809447
    296      - https://bugzilla.mozilla.org/show_bug.cgi?id=1925028
    297    data_reviews:
    298      - https://github.com/mozilla-mobile/focus-android/pull/4968#issuecomment-879256443
    299      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    300      - https://github.com/mozilla-mobile/focus-android/pull/8109#issuecomment-1337394286
    301      - https://github.com/mozilla-mobile/firefox-android/pull/523#issuecomment-1377494482
    302      - https://bugzilla.mozilla.org/show_bug.cgi?id=1925028
    303    data_sensitivity:
    304      - interaction
    305    notification_emails:
    306      - android-probes@mozilla.com
    307      - rtestard@mozilla.com
    308    expires: never
    309  in_content:
    310    type: labeled_counter
    311    description: |
    312      Records the type of interaction a user has on SERP pages.
    313    send_in_pings:
    314      - metrics
    315      - baseline
    316    no_lint:
    317      - BASELINE_PING
    318    bugs:
    319      - https://github.com/mozilla-mobile/fenix/issues/4967
    320      - https://bugzilla.mozilla.org/show_bug.cgi?id=1809447
    321      - https://bugzilla.mozilla.org/show_bug.cgi?id=1925028
    322    data_reviews:
    323      - https://github.com/mozilla-mobile/focus-android/pull/4968#issuecomment-879256443
    324      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    325      - https://github.com/mozilla-mobile/firefox-android/pull/523#issuecomment-1377494482
    326      - https://bugzilla.mozilla.org/show_bug.cgi?id=1925028
    327    data_sensitivity:
    328      - interaction
    329    notification_emails:
    330      - android-probes@mozilla.com
    331      - rtestard@mozilla.com
    332    expires: never
    333 
    334  search_count:
    335    type: labeled_counter
    336    description: |
    337      The labels for this counter are `<search-engine-name>.<source>`.
    338 
    339      If the search engine is bundled with Focus `search-engine-name` will be
    340      the name of the search engine. If it's a custom search engine (defined:
    341      https://github.com/mozilla-mobile/fenix/issues/1607) the value will be
    342      `custom`.
    343 
    344      `source` will be: `action`, `suggestion`
    345    send_in_pings:
    346      - metrics
    347      - baseline
    348    no_lint:
    349      - BASELINE_PING
    350    bugs:
    351      - https://github.com/mozilla-mobile/focus-android/issues/6229
    352      - https://bugzilla.mozilla.org/show_bug.cgi?id=1925028
    353    data_reviews:
    354      - https://github.com/mozilla-mobile/focus-android/pull/6238
    355      - https://github.com/mozilla-mobile/focus-android/pull/7906
    356      - https://bugzilla.mozilla.org/show_bug.cgi?id=1925028
    357    data_sensitivity:
    358      - technical
    359      - interaction
    360    notification_emails:
    361      - android-probes@mozilla.com
    362      - rtestard@mozilla.com
    363    expires: never
    364 
    365 mozilla_products:
    366  has_fenix_installed:
    367    type: boolean
    368    lifetime: application
    369    description: |
    370       If Fenix is installed on the users's device.
    371    bugs:
    372      - https://github.com/mozilla-mobile/focus-android/issues/5295
    373    data_reviews:
    374      - https://github.com/mozilla-mobile/focus-android/pull/5303
    375      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    376      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    377    data_sensitivity:
    378      - technical
    379      - interaction
    380    notification_emails:
    381      - android-probes@mozilla.com
    382    expires: never
    383  is_fenix_default_browser:
    384    type: boolean
    385    lifetime: application
    386    description: |
    387      Fenix is the default browser on user's device
    388    send_in_pings:
    389      - metrics
    390    bugs:
    391      - https://github.com/mozilla-mobile/focus-android/issues/5295
    392    data_reviews:
    393      - https://github.com/mozilla-mobile/focus-android/pull/5303
    394      - https://github.com/mozilla-mobile/focus-android/pull/6315
    395      - https://github.com/mozilla-mobile/firefox-android/pull/632
    396    data_sensitivity:
    397      - technical
    398      - interaction
    399    notification_emails:
    400      - android-probes@mozilla.com
    401      - rtestard@mozilla.com
    402    expires: never
    403 
    404 autocomplete:
    405  domain_added:
    406    type: counter
    407    description: |
    408      A counter that indicates how many times a user has added
    409      a website to the autocomplete list.
    410    bugs:
    411      - https://github.com/mozilla-mobile/focus-android/issues/5885
    412    data_reviews:
    413      - https://github.com/mozilla-mobile/focus-android/pull/5886
    414      - https://github.com/mozilla-mobile/focus-android/pull/7906
    415    data_sensitivity:
    416      - interaction
    417    notification_emails:
    418      - android-probes@mozilla.com
    419      - rtestard@mozilla.com
    420    expires: never
    421  domain_removed:
    422    type: counter
    423    description: |
    424      A counter that indicates how many times a user has removed
    425      a website from the autocomplete list.
    426    bugs:
    427      - https://github.com/mozilla-mobile/focus-android/issues/5885
    428    data_reviews:
    429      - https://github.com/mozilla-mobile/focus-android/pull/5886
    430      - https://github.com/mozilla-mobile/focus-android/pull/7906
    431    data_sensitivity:
    432      - interaction
    433    notification_emails:
    434      - android-probes@mozilla.com
    435      - rtestard@mozilla.com
    436    expires: never
    437  list_order_changed:
    438    type: counter
    439    description: |
    440      A counter that indicates how many times a user has reordered
    441      the autocomplete list.
    442    bugs:
    443      - https://github.com/mozilla-mobile/focus-android/issues/5885
    444    data_reviews:
    445      - https://github.com/mozilla-mobile/focus-android/pull/5886
    446      - https://github.com/mozilla-mobile/focus-android/pull/7906
    447    data_sensitivity:
    448      - interaction
    449    notification_emails:
    450      - android-probes@mozilla.com
    451      - rtestard@mozilla.com
    452    expires: never
    453  top_sites_setting_changed:
    454    type: event
    455    description: |
    456      Autocomplete setting for top sites has changed.
    457    bugs:
    458      - https://github.com/mozilla-mobile/focus-android/issues/5885
    459    data_reviews:
    460      - https://github.com/mozilla-mobile/focus-android/pull/5940
    461      - https://github.com/mozilla-mobile/focus-android/pull/7906
    462    data_sensitivity:
    463      - interaction
    464    notification_emails:
    465      - android-probes@mozilla.com
    466      - rtestard@mozilla.com
    467    expires: never
    468    extra_keys:
    469      is_enabled:
    470        description: The new setting true for ON, false for OFF
    471        type: boolean
    472  favorite_sites_setting_changed:
    473    type: event
    474    description: |
    475      Autocomplete setting for favorite sites has changed.
    476    bugs:
    477      - https://github.com/mozilla-mobile/focus-android/issues/5885
    478    data_reviews:
    479      - https://github.com/mozilla-mobile/focus-android/pull/5940
    480      - https://github.com/mozilla-mobile/focus-android/pull/7906
    481    data_sensitivity:
    482      - interaction
    483    notification_emails:
    484      - android-probes@mozilla.com
    485      - rtestard@mozilla.com
    486    expires: never
    487    extra_keys:
    488      is_enabled:
    489        description: The new setting true for ON, false for OFF
    490        type: boolean
    491 
    492 shortcuts:
    493  shortcuts_on_home_number:
    494    type: quantity
    495    description: |
    496      The number of shortcuts the user has on home screen,
    497      0, 1, 2, 3 or 4 (maximum)
    498    bugs:
    499      - https://github.com/mozilla-mobile/focus-android/issues/5056
    500    data_reviews:
    501      - https://github.com/mozilla-mobile/focus-android/pull/5189
    502      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    503      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    504    data_sensitivity:
    505      - interaction
    506    notification_emails:
    507      - android-probes@mozilla.com
    508    expires: never
    509    unit: shortcut(s)
    510  shortcut_opened_counter:
    511    type: counter
    512    description: |
    513      A counter that indicates how many times a user has opened
    514      a website from a shortcut in the home screen.
    515    bugs:
    516      - https://github.com/mozilla-mobile/focus-android/issues/5056
    517    data_reviews:
    518      - https://github.com/mozilla-mobile/focus-android/pull/5189
    519      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    520      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    521    data_sensitivity:
    522      - interaction
    523    notification_emails:
    524      - android-probes@mozilla.com
    525    expires: never
    526  shortcut_added_counter:
    527    type: counter
    528    description: |
    529      A counter that indicates how many times a user has added
    530      a website to shortcuts.
    531    bugs:
    532      - https://github.com/mozilla-mobile/focus-android/issues/5056
    533    data_reviews:
    534      - https://github.com/mozilla-mobile/focus-android/pull/5189
    535      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    536      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    537    data_sensitivity:
    538      - interaction
    539    notification_emails:
    540      - android-probes@mozilla.com
    541    expires: never
    542  shortcut_removed_counter:
    543    type: labeled_counter
    544    description: |
    545      A counter that indicates how many times a user has removed
    546      a website from shortcuts.
    547      It also indicates the screen it was removed from, home or browser.
    548    bugs:
    549      - https://github.com/mozilla-mobile/focus-android/issues/5056
    550    data_reviews:
    551      - https://github.com/mozilla-mobile/focus-android/pull/5189
    552      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    553      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    554    data_sensitivity:
    555      - interaction
    556    notification_emails:
    557      - android-probes@mozilla.com
    558    expires: never
    559    labels:
    560      - removed_from_browser_menu
    561      - removed_from_home_screen
    562 tracking_protection:
    563  toolbar_shield_clicked:
    564    type: counter
    565    description: |
    566      A counter that indicates how many times a user has opened
    567      the tracking protection settings panel from the toolbar.
    568    bugs:
    569      - https://github.com/mozilla-mobile/focus-android/issues/5057
    570    data_reviews:
    571      - https://github.com/mozilla-mobile/focus-android/pull/5163
    572      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    573      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    574    data_sensitivity:
    575      - interaction
    576    notification_emails:
    577      - android-probes@mozilla.com
    578    expires: never
    579 
    580  tracking_protection_changed:
    581    type: event
    582    description: |
    583      The user has changed the setting for enhanced tracking protection.
    584    bugs:
    585      - https://github.com/mozilla-mobile/focus-android/issues/5057
    586    data_reviews:
    587      - https://github.com/mozilla-mobile/focus-android/pull/5163
    588      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    589      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    590    data_sensitivity:
    591      - interaction
    592    notification_emails:
    593      - android-probes@mozilla.com
    594    expires: never
    595    extra_keys:
    596      is_enabled:
    597        description: The new setting for ETP, true for ON, false for OFF
    598        type: boolean
    599 
    600  has_ever_changed_etp:
    601    type: boolean
    602    description: |
    603      The user has changed the setting for enhanced tracking protection
    604      at least once.
    605    bugs:
    606      - https://github.com/mozilla-mobile/focus-android/issues/5057
    607    data_reviews:
    608      - https://github.com/mozilla-mobile/focus-android/pull/5163
    609      - https://github.com/mozilla-mobile/focus-android/pull/5543
    610    data_sensitivity:
    611      - interaction
    612    lifetime: user
    613    notification_emails:
    614      - android-probes@mozilla.com
    615      - mcarare@mozilla.com
    616    expires: never
    617 
    618  tracker_setting_changed:
    619    type: event
    620    description: |
    621      The user has changed the advertising tracker protection state.
    622    bugs:
    623      - https://github.com/mozilla-mobile/focus-android/issues/5057
    624    data_reviews:
    625      - https://github.com/mozilla-mobile/focus-android/pull/5163
    626      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    627      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    628    data_sensitivity:
    629      - interaction
    630    notification_emails:
    631      - android-probes@mozilla.com
    632    expires: never
    633    extra_keys:
    634      source_of_change:
    635        description: The source of interaction, "Panel" or "Settings"
    636        type: string
    637      tracker_changed:
    638        description: |
    639          The tracker changed, "Advertising", "Analytics", "Social", "Content"
    640        type: string
    641      is_enabled:
    642        description: The new setting for tracker, true for ON, false for OFF
    643        type: boolean
    644 
    645  has_social_blocked:
    646    type: boolean
    647    description: |
    648      The user has changed the setting for enhanced tracking protection
    649      at least once.
    650    bugs:
    651      - https://github.com/mozilla-mobile/focus-android/issues/5057
    652    data_reviews:
    653      - https://github.com/mozilla-mobile/focus-android/pull/5163
    654      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    655      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    656    data_sensitivity:
    657      - interaction
    658    notification_emails:
    659      - android-probes@mozilla.com
    660    expires: never
    661 
    662  has_advertising_blocked:
    663    type: boolean
    664    description: |
    665      The user has changed the setting for enhanced tracking protection
    666      at least once.
    667    bugs:
    668      - https://github.com/mozilla-mobile/focus-android/issues/5057
    669    data_reviews:
    670      - https://github.com/mozilla-mobile/focus-android/pull/5163
    671      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    672      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    673    data_sensitivity:
    674      - interaction
    675    notification_emails:
    676      - android-probes@mozilla.com
    677    expires: never
    678 
    679  has_analytics_blocked:
    680    type: boolean
    681    description: |
    682      The user has changed the setting for enhanced tracking protection
    683      at least once.
    684    bugs:
    685      - https://github.com/mozilla-mobile/focus-android/issues/5057
    686    data_reviews:
    687      - https://github.com/mozilla-mobile/focus-android/pull/5163
    688      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    689      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    690    data_sensitivity:
    691      - interaction
    692    notification_emails:
    693      - android-probes@mozilla.com
    694    expires: never
    695 
    696  has_content_blocked:
    697    type: boolean
    698    description: |
    699      The user has changed the setting for enhanced tracking protection
    700      at least once.
    701    bugs:
    702      - https://github.com/mozilla-mobile/focus-android/issues/5057
    703    data_reviews:
    704      - https://github.com/mozilla-mobile/focus-android/pull/5163
    705      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    706      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    707    data_sensitivity:
    708      - interaction
    709    notification_emails:
    710      - android-probes@mozilla.com
    711    expires: never
    712 pro_tips:
    713  tip_displayed:
    714    type: event
    715    description: A pro tip has been displayed.
    716    bugs:
    717      - https://github.com/mozilla-mobile/focus-android/issues/5541
    718    data_reviews:
    719      - https://github.com/mozilla-mobile/focus-android/pull/5542
    720      - https://github.com/mozilla-mobile/focus-android/pull/7906
    721    data_sensitivity:
    722      - interaction
    723    notification_emails:
    724      - android-probes@mozilla.com
    725      - rtestard@mozilla.com
    726    expires: never
    727    extra_keys:
    728      tip_id:
    729        description: |
    730          The tip code of tip being displayed. Can be one of fresh_look_tip,
    731          shortcuts_tip, allow_list_tip, etp_tip,request_desktop_tip.
    732          Note that fresh_look_tip is automatically displayed on home screen.
    733        type: string
    734  link_in_tip_clicked:
    735    type: event
    736    description: A link in a pro tip has been clicked.
    737    bugs:
    738      - https://github.com/mozilla-mobile/focus-android/issues/5541
    739    data_reviews:
    740      - https://github.com/mozilla-mobile/focus-android/pull/5542
    741      - https://github.com/mozilla-mobile/focus-android/pull/7906
    742    data_sensitivity:
    743      - interaction
    744    notification_emails:
    745      - android-probes@mozilla.com
    746      - rtestard@mozilla.com
    747    expires: never
    748    extra_keys:
    749      tip_id:
    750        description: |
    751          The tip code of tip being clicked.
    752          Can be one of fresh_look_tip, allow_list_tip, request_desktop_tip.
    753        type: string
    754 
    755 preferences:
    756  user_theme:
    757    type: string
    758    description: >
    759      A string that indicates the theme.
    760      Can be one of LIGHT, DARK, or FOLLOW DEVICE.
    761      Default is FOLLOW DEVICE.
    762    bugs:
    763      - https://github.com/mozilla-mobile/focus-android/issues/5519
    764    data_reviews:
    765      - https://github.com/mozilla-mobile/focus-android/pull/5526
    766      - https://github.com/mozilla-mobile/focus-android/pull/7418#issuecomment-1195518264
    767      - https://github.com/mozilla-mobile/firefox-android/pull/3320
    768      - https://github.com/mozilla-mobile/firefox-android/pull/4040
    769    data_sensitivity:
    770      - interaction
    771    notification_emails:
    772      - android-probes@mozilla.com
    773    expires: never
    774 
    775 app_opened:
    776  from_icons:
    777    type: event
    778    description: |
    779      The user has opened the app using launcher icons
    780    bugs:
    781      - https://github.com/mozilla-mobile/focus-android/issues/5546
    782    data_reviews:
    783      - https://github.com/mozilla-mobile/focus-android/pull/5552
    784      - https://github.com/mozilla-mobile/focus-android/pull/7906
    785    data_sensitivity:
    786      - interaction
    787    notification_emails:
    788      - android-probes@mozilla.com
    789      - rtestard@mozilla.com
    790    expires: never
    791    extra_keys:
    792      open_type:
    793        description: |
    794          Can be "Launch" if Focus was not already opened or "Resume" if it was.
    795        type: string
    796  from_launcher_site_shortcut:
    797    type: event
    798    description: |
    799      The user has opened the app using launcher website shortcut
    800    bugs:
    801      - https://github.com/mozilla-mobile/focus-android/issues/5547
    802    data_reviews:
    803      - https://github.com/mozilla-mobile/focus-android/pull/5839
    804      - https://github.com/mozilla-mobile/focus-android/pull/7906
    805    data_sensitivity:
    806      - interaction
    807    notification_emails:
    808      - android-probes@mozilla.com
    809      - rtestard@mozilla.com
    810    expires: never
    811  browse_intent:
    812    type: event
    813    description: |
    814      App was opened from a browse intent.
    815    bugs:
    816      - https://github.com/mozilla-mobile/focus-android/issues/5547
    817    data_reviews:
    818      - https://github.com/mozilla-mobile/focus-android/pull/5839
    819      - https://github.com/mozilla-mobile/focus-android/pull/7906
    820    data_sensitivity:
    821      - interaction
    822    notification_emails:
    823      - android-probes@mozilla.com
    824      - rtestard@mozilla.com
    825    expires: never
    826  text_selection_intent:
    827    type: event
    828    description: |
    829      App was opened from a text selection intent.
    830    bugs:
    831      - https://github.com/mozilla-mobile/focus-android/issues/5547
    832    data_reviews:
    833      - https://github.com/mozilla-mobile/focus-android/pull/5839
    834      - https://github.com/mozilla-mobile/focus-android/pull/7906
    835    data_sensitivity:
    836      - interaction
    837    notification_emails:
    838      - android-probes@mozilla.com
    839      - rtestard@mozilla.com
    840    expires: never
    841  share_intent:
    842    type: event
    843    description: |
    844      App was opened from a share intent.
    845    bugs:
    846      - https://github.com/mozilla-mobile/focus-android/issues/5547
    847    data_reviews:
    848      - https://github.com/mozilla-mobile/focus-android/pull/5839
    849      - https://github.com/mozilla-mobile/focus-android/pull/7906
    850    data_sensitivity:
    851      - interaction
    852    notification_emails:
    853      - android-probes@mozilla.com
    854      - rtestard@mozilla.com
    855    expires: never
    856    extra_keys:
    857      is_search:
    858        description: Is the shared intent a search?
    859        type: boolean
    860 
    861 
    862 add_to_home_screen:
    863  dialog_displayed:
    864    type: event
    865    description: The dialog for adding home screen shorcut was displayed.
    866    bugs:
    867      - https://github.com/mozilla-mobile/focus-android/issues/5548
    868    data_reviews:
    869      - https://github.com/mozilla-mobile/focus-android/pull/5598
    870      - https://github.com/mozilla-mobile/focus-android/pull/7906
    871    data_sensitivity:
    872      - interaction
    873    notification_emails:
    874      - android-probes@mozilla.com
    875      - rtestard@mozilla.com
    876    expires: never
    877  add_button_tapped:
    878    type: event
    879    description: The add(yes) option from add to home dialog was tapped.
    880    bugs:
    881      - https://github.com/mozilla-mobile/focus-android/issues/5548
    882    data_reviews:
    883      - https://github.com/mozilla-mobile/focus-android/pull/5598
    884      - https://github.com/mozilla-mobile/focus-android/pull/7906
    885    data_sensitivity:
    886      - interaction
    887    notification_emails:
    888      - android-probes@mozilla.com
    889      - rtestard@mozilla.com
    890    expires: never
    891    extra_keys:
    892      has_edited_title:
    893        description: Did the user edit the default title provided by the app?
    894        type: boolean
    895  cancel_button_tapped:
    896    type: event
    897    description: The cancel(no) option from add to home dialog was tapped.
    898    bugs:
    899      - https://github.com/mozilla-mobile/focus-android/issues/5548
    900    data_reviews:
    901      - https://github.com/mozilla-mobile/focus-android/pull/5598
    902      - https://github.com/mozilla-mobile/focus-android/pull/7906
    903    data_sensitivity:
    904      - interaction
    905    notification_emails:
    906      - android-probes@mozilla.com
    907      - rtestard@mozilla.com
    908    expires: never
    909 set_default_browser:
    910  from_app_settings:
    911    type: event
    912    description: |
    913      The user has changed default browser from the app.
    914    bugs:
    915      - https://github.com/mozilla-mobile/focus-android/issues/5636
    916    data_reviews:
    917      - https://github.com/mozilla-mobile/focus-android/pull/5637
    918      - https://github.com/mozilla-mobile/focus-android/pull/7906
    919    data_sensitivity:
    920      - interaction
    921    notification_emails:
    922      - android-probes@mozilla.com
    923      - rtestard@mozilla.com
    924    expires: never
    925    extra_keys:
    926      is_default:
    927        description: Shows if Focus was already default.
    928        type: boolean
    929  from_os_settings:
    930    type: event
    931    description: |
    932      The user has opened the OS settings to set default browser.
    933    bugs:
    934      - https://github.com/mozilla-mobile/focus-android/issues/5636
    935    data_reviews:
    936      - https://github.com/mozilla-mobile/focus-android/pull/5637
    937      - https://github.com/mozilla-mobile/focus-android/pull/7906
    938    data_sensitivity:
    939      - interaction
    940    notification_emails:
    941      - android-probes@mozilla.com
    942      - rtestard@mozilla.com
    943    expires: never
    944    extra_keys:
    945      is_default:
    946        description: Shows if Focus was already default.
    947        type: boolean
    948  learn_more_opened:
    949    type: event
    950    description: |
    951      The user has opened the learn more link.
    952    bugs:
    953      - https://github.com/mozilla-mobile/focus-android/issues/5636
    954    data_reviews:
    955      - https://github.com/mozilla-mobile/focus-android/pull/5637
    956      - https://github.com/mozilla-mobile/focus-android/pull/7906
    957    data_sensitivity:
    958      - interaction
    959    notification_emails:
    960      - android-probes@mozilla.com
    961      - rtestard@mozilla.com
    962    expires: never
    963    extra_keys:
    964      is_default:
    965        description: Shows if Focus was already default.
    966        type: boolean
    967 
    968 tab_count:
    969  session_button_tapped:
    970    type: event
    971    description: The session button has been tapped to see session list.
    972    bugs:
    973      - https://github.com/mozilla-mobile/focus-android/issues/5583
    974    data_reviews:
    975      - https://github.com/mozilla-mobile/focus-android/pull/5644
    976      - https://github.com/mozilla-mobile/focus-android/pull/7906
    977    data_sensitivity:
    978      - interaction
    979    notification_emails:
    980      - android-probes@mozilla.com
    981      - rtestard@mozilla.com
    982    expires: never
    983    extra_keys:
    984      opened_tabs:
    985        description: Number of currently opened tabs
    986        type: quantity
    987  session_list_item_tapped:
    988    type: event
    989    description: The user has switched to a tab from the session list.
    990    bugs:
    991      - https://github.com/mozilla-mobile/focus-android/issues/5583
    992    data_reviews:
    993      - https://github.com/mozilla-mobile/focus-android/pull/5644
    994      - https://github.com/mozilla-mobile/focus-android/pull/7906
    995    data_sensitivity:
    996      - interaction
    997    notification_emails:
    998      - android-probes@mozilla.com
    999      - rtestard@mozilla.com
   1000    expires: never
   1001    extra_keys:
   1002      opened_tabs:
   1003        description: Number of currently opened tabs
   1004        type: quantity
   1005  session_close_others_tapped:
   1006    type: event
   1007    description: The user has switched to a tab from the session list.
   1008    bugs:
   1009      - https://bugzilla.mozilla.org/show_bug.cgi?id=1912955
   1010    data_reviews:
   1011      - https://bugzilla.mozilla.org/show_bug.cgi?id=1912955
   1012    data_sensitivity:
   1013      - interaction
   1014    notification_emails:
   1015      - android-probes@mozilla.com
   1016      - rtestard@mozilla.com
   1017    expires: never
   1018    extra_keys:
   1019      opened_tabs:
   1020        description: Number of currently opened tabs
   1021        type: quantity
   1022  session_list_closed:
   1023    type: event
   1024    description: The user has closed the session list.
   1025    bugs:
   1026      - https://github.com/mozilla-mobile/focus-android/issues/5583
   1027    data_reviews:
   1028      - https://github.com/mozilla-mobile/focus-android/pull/5644
   1029      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1030    data_sensitivity:
   1031      - interaction
   1032    notification_emails:
   1033      - android-probes@mozilla.com
   1034      - rtestard@mozilla.com
   1035    expires: never
   1036    extra_keys:
   1037      opened_tabs:
   1038        description: Number of currently opened tabs
   1039        type: quantity
   1040  erase_button_tapped:
   1041    type: event
   1042    description: The erease button has been tapped to close opened sessions.
   1043    bugs:
   1044      - https://github.com/mozilla-mobile/focus-android/issues/5583
   1045    data_reviews:
   1046      - https://github.com/mozilla-mobile/focus-android/pull/5644
   1047      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1048    data_sensitivity:
   1049      - interaction
   1050    notification_emails:
   1051      - android-probes@mozilla.com
   1052      - rtestard@mozilla.com
   1053    expires: never
   1054    extra_keys:
   1055      opened_tabs:
   1056        description: Number of currently opened tabs
   1057        type: quantity
   1058  new_tab_opened:
   1059    type: event
   1060    description: A new tab has opened.
   1061    bugs:
   1062      - https://github.com/mozilla-mobile/focus-android/issues/5583
   1063    data_reviews:
   1064      - https://github.com/mozilla-mobile/focus-android/pull/5644
   1065      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1066    data_sensitivity:
   1067      - interaction
   1068    notification_emails:
   1069      - android-probes@mozilla.com
   1070      - rtestard@mozilla.com
   1071    expires: never
   1072    extra_keys:
   1073      opened_tabs:
   1074        description: Number of currently opened tabs
   1075        type: quantity
   1076      source:
   1077        description: |
   1078          Tab opened from "custom tab", "context menu" or from "Window.open()"
   1079        type: string
   1080  app_backgrounded:
   1081    type: custom_distribution
   1082    description: Number of opened tabs when the app has been send to background.
   1083    range_min: 0
   1084    range_max: 50
   1085    bucket_count: 51
   1086    histogram_type: linear
   1087    unit: tabs
   1088    bugs:
   1089      - https://github.com/mozilla-mobile/focus-android/issues/5583
   1090    data_reviews:
   1091      - https://github.com/mozilla-mobile/focus-android/pull/5793
   1092      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1093    data_sensitivity:
   1094      - interaction
   1095    notification_emails:
   1096      - android-probes@mozilla.com
   1097      - rtestard@mozilla.com
   1098    expires: never
   1099 
   1100 search_bar:
   1101  entered_url:
   1102    type: event
   1103    description: The user has entered a full url.
   1104    bugs:
   1105      - https://github.com/mozilla-mobile/focus-android/issues/5546
   1106    data_reviews:
   1107      - https://github.com/mozilla-mobile/focus-android/pull/5660
   1108      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1109    data_sensitivity:
   1110      - interaction
   1111    notification_emails:
   1112      - android-probes@mozilla.com
   1113      - rtestard@mozilla.com
   1114    expires: never
   1115  performed_search:
   1116    type: event
   1117    description: The user has entered text and performed a search.
   1118    bugs:
   1119      - https://github.com/mozilla-mobile/focus-android/issues/5546
   1120    data_reviews:
   1121      - https://github.com/mozilla-mobile/focus-android/pull/5660
   1122      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1123    data_sensitivity:
   1124      - interaction
   1125    notification_emails:
   1126      - android-probes@mozilla.com
   1127      - rtestard@mozilla.com
   1128    expires: never
   1129    extra_keys:
   1130      engine_name:
   1131        description: The name of the engine used to perform the search.
   1132        type: string
   1133 
   1134 show_search_suggestions:
   1135  enabled_from_panel:
   1136    type: event
   1137    description: The "yes" option from the suggestion panel has been tapped.
   1138    bugs:
   1139      - https://github.com/mozilla-mobile/focus-android/issues/5840
   1140    data_reviews:
   1141      - https://github.com/mozilla-mobile/focus-android/pull/5858
   1142      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1143    data_sensitivity:
   1144      - interaction
   1145    notification_emails:
   1146      - android-probes@mozilla.com
   1147      - rtestard@mozilla.com
   1148    expires: never
   1149  disabled_from_panel:
   1150    type: event
   1151    description: The "no"" option from the suggestion panel has been tapped.
   1152    bugs:
   1153      - https://github.com/mozilla-mobile/focus-android/issues/5840
   1154    data_reviews:
   1155      - https://github.com/mozilla-mobile/focus-android/pull/5858
   1156      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1157    data_sensitivity:
   1158      - interaction
   1159    notification_emails:
   1160      - android-probes@mozilla.com
   1161      - rtestard@mozilla.com
   1162    expires: never
   1163  changed_from_settings:
   1164    type: event
   1165    description: The enabled state has been changed from the settings screen.
   1166    bugs:
   1167      - https://github.com/mozilla-mobile/focus-android/issues/5840
   1168    data_reviews:
   1169      - https://github.com/mozilla-mobile/focus-android/pull/5858
   1170      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1171    data_sensitivity:
   1172      - interaction
   1173    notification_emails:
   1174      - android-probes@mozilla.com
   1175      - rtestard@mozilla.com
   1176    expires: never
   1177    extra_keys:
   1178      is_enabled:
   1179        description: The new setting value, true for ON, false for OFF
   1180        type: boolean
   1181 
   1182 downloads:
   1183  download_started:
   1184    type: event
   1185    description: A download has been started.
   1186    bugs:
   1187      - https://github.com/mozilla-mobile/focus-android/issues/5650
   1188    data_reviews:
   1189      - https://github.com/mozilla-mobile/focus-android/pull/5663
   1190      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1191    data_sensitivity:
   1192      - interaction
   1193    notification_emails:
   1194      - android-probes@mozilla.com
   1195      - rtestard@mozilla.com
   1196    expires: never
   1197  download_paused:
   1198    type: event
   1199    description: A download has been paused.
   1200    bugs:
   1201      - https://github.com/mozilla-mobile/focus-android/issues/5650
   1202    data_reviews:
   1203      - https://github.com/mozilla-mobile/focus-android/pull/5663
   1204      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1205    data_sensitivity:
   1206      - interaction
   1207    notification_emails:
   1208      - android-probes@mozilla.com
   1209      - rtestard@mozilla.com
   1210    expires: never
   1211  download_canceled:
   1212    type: event
   1213    description: A download has been cancelled.
   1214    bugs:
   1215      - https://github.com/mozilla-mobile/focus-android/issues/5650
   1216    data_reviews:
   1217      - https://github.com/mozilla-mobile/focus-android/pull/5663
   1218      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1219    data_sensitivity:
   1220      - interaction
   1221    notification_emails:
   1222      - android-probes@mozilla.com
   1223      - rtestard@mozilla.com
   1224    expires: never
   1225  download_completed:
   1226    type: event
   1227    description: A download has been completed successfully.
   1228    bugs:
   1229      - https://github.com/mozilla-mobile/focus-android/issues/5650
   1230    data_reviews:
   1231      - https://github.com/mozilla-mobile/focus-android/pull/5663
   1232      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1233    data_sensitivity:
   1234      - interaction
   1235    notification_emails:
   1236      - android-probes@mozilla.com
   1237      - rtestard@mozilla.com
   1238    expires: never
   1239  download_failed:
   1240    type: event
   1241    description: The download has failed.
   1242    bugs:
   1243      - https://github.com/mozilla-mobile/focus-android/issues/5650
   1244    data_reviews:
   1245      - https://github.com/mozilla-mobile/focus-android/pull/5663
   1246      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1247    data_sensitivity:
   1248      - interaction
   1249    notification_emails:
   1250      - android-probes@mozilla.com
   1251      - rtestard@mozilla.com
   1252    expires: never
   1253    extra_keys:
   1254      file_extension:
   1255        description: The extension of the downloaded file.
   1256        type: string
   1257  open_button_tapped:
   1258    type: event
   1259    description: The open button from download confirmation was tapped.
   1260    bugs:
   1261      - https://github.com/mozilla-mobile/focus-android/issues/5650
   1262    data_reviews:
   1263      - https://github.com/mozilla-mobile/focus-android/pull/5663
   1264      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1265    data_sensitivity:
   1266      - interaction
   1267    notification_emails:
   1268      - android-probes@mozilla.com
   1269      - rtestard@mozilla.com
   1270    expires: never
   1271    extra_keys:
   1272      open_successful:
   1273        description: Did the user succeed in opening the downloaded file?
   1274        type: boolean
   1275      file_extension:
   1276        description: The extension of the downloaded file.
   1277        type: string
   1278 
   1279 search_engines:
   1280  open_settings:
   1281    type: event
   1282    description: The user has opened the search engines settings page.
   1283    bugs:
   1284      - https://github.com/mozilla-mobile/focus-android/issues/5646
   1285    data_reviews:
   1286      - https://github.com/mozilla-mobile/focus-android/pull/5713
   1287      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1288    data_sensitivity:
   1289      - interaction
   1290    notification_emails:
   1291      - android-probes@mozilla.com
   1292      - rtestard@mozilla.com
   1293    expires: never
   1294  add_engine_tapped:
   1295    type: event
   1296    description: The user has tapped on the add another search engine button.
   1297    bugs:
   1298      - https://github.com/mozilla-mobile/focus-android/issues/5646
   1299    data_reviews:
   1300      - https://github.com/mozilla-mobile/focus-android/pull/5713
   1301      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1302    data_sensitivity:
   1303      - interaction
   1304    notification_emails:
   1305      - android-probes@mozilla.com
   1306      - rtestard@mozilla.com
   1307    expires: never
   1308  save_engine_tapped:
   1309    type: event
   1310    description: The user has tried to save a custom engine.
   1311    bugs:
   1312      - https://github.com/mozilla-mobile/focus-android/issues/5646
   1313    data_reviews:
   1314      - https://github.com/mozilla-mobile/focus-android/pull/5713
   1315      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1316    data_sensitivity:
   1317      - interaction
   1318    notification_emails:
   1319      - android-probes@mozilla.com
   1320      - rtestard@mozilla.com
   1321    expires: never
   1322    extra_keys:
   1323      save_successful:
   1324        description: If the engine has been saved successfully.
   1325        type: boolean
   1326  set_default:
   1327    type: event
   1328    description: The user has set a search engine as default.
   1329    bugs:
   1330      - https://github.com/mozilla-mobile/focus-android/issues/5646
   1331    data_reviews:
   1332      - https://github.com/mozilla-mobile/focus-android/pull/5713
   1333      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1334    data_sensitivity:
   1335      - interaction
   1336    notification_emails:
   1337      - android-probes@mozilla.com
   1338      - rtestard@mozilla.com
   1339    expires: never
   1340    extra_keys:
   1341      engine_type:
   1342        description: |
   1343          The engine type set as default. Can be either "custom" or "bundled".
   1344        type: string
   1345  remove_engines:
   1346    type: event
   1347    description: The user has removed search engines.
   1348    bugs:
   1349      - https://github.com/mozilla-mobile/focus-android/issues/5646
   1350    data_reviews:
   1351      - https://github.com/mozilla-mobile/focus-android/pull/5713
   1352      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1353    data_sensitivity:
   1354      - interaction
   1355    notification_emails:
   1356      - android-probes@mozilla.com
   1357      - rtestard@mozilla.com
   1358    expires: never
   1359    extra_keys:
   1360      engine_count:
   1361        description: How many search engines has the user removed
   1362        type: quantity
   1363  open_remove_screen:
   1364    type: event
   1365    description: The user has clicked the remove option from menu.
   1366    bugs:
   1367      - https://github.com/mozilla-mobile/focus-android/issues/5646
   1368    data_reviews:
   1369      - https://github.com/mozilla-mobile/focus-android/pull/5713
   1370      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1371    data_sensitivity:
   1372      - interaction
   1373    notification_emails:
   1374      - android-probes@mozilla.com
   1375      - rtestard@mozilla.com
   1376    expires: never
   1377    extra_keys:
   1378      current_engines_count:
   1379        description: How many search engines did the user had at that point.
   1380        type: quantity
   1381  restore_default_engines:
   1382    type: event
   1383    description: The user has restored the default search engines
   1384    bugs:
   1385      - https://github.com/mozilla-mobile/focus-android/issues/5646
   1386    data_reviews:
   1387      - https://github.com/mozilla-mobile/focus-android/pull/5713
   1388      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1389    data_sensitivity:
   1390      - interaction
   1391    notification_emails:
   1392      - android-probes@mozilla.com
   1393      - rtestard@mozilla.com
   1394    expires: never
   1395    extra_keys:
   1396      current_engines_count:
   1397        description: How many search engines did the user had at that point.
   1398        type: quantity
   1399  learn_more_tapped:
   1400    type: event
   1401    description: The learn more button was tapped.
   1402    bugs:
   1403      - https://github.com/mozilla-mobile/focus-android/issues/5646
   1404    data_reviews:
   1405      - https://github.com/mozilla-mobile/focus-android/pull/5713
   1406      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1407    data_sensitivity:
   1408      - interaction
   1409    notification_emails:
   1410      - android-probes@mozilla.com
   1411      - rtestard@mozilla.com
   1412    expires: never
   1413 
   1414 open_with:
   1415  list_displayed:
   1416    type: event
   1417    description: The list of apps has been opened.
   1418    bugs:
   1419      - https://github.com/mozilla-mobile/focus-android/issues/5654
   1420    data_reviews:
   1421      - https://github.com/mozilla-mobile/focus-android/pull/5703
   1422      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1423    data_sensitivity:
   1424      - interaction
   1425    notification_emails:
   1426      - android-probes@mozilla.com
   1427      - rtestard@mozilla.com
   1428    expires: never
   1429    extra_keys:
   1430      list_size:
   1431        description: The number of apps in the list
   1432        type: quantity
   1433  list_item_tapped:
   1434    type: event
   1435    description: The uer has opened the url with a app from the list.
   1436    bugs:
   1437      - https://github.com/mozilla-mobile/focus-android/issues/5654
   1438    data_reviews:
   1439      - https://github.com/mozilla-mobile/focus-android/pull/5703
   1440      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1441    data_sensitivity:
   1442      - interaction
   1443    notification_emails:
   1444      - android-probes@mozilla.com
   1445      - rtestard@mozilla.com
   1446    expires: never
   1447    extra_keys:
   1448      package_name:
   1449        description: The app the user has chosen is a Mozilla product.
   1450        type: boolean
   1451  install_firefox:
   1452    type: event
   1453    description: The user has clicked install Firefox from store item.
   1454    bugs:
   1455      - https://github.com/mozilla-mobile/focus-android/issues/5654
   1456    data_reviews:
   1457      - https://github.com/mozilla-mobile/focus-android/pull/5703
   1458      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1459    data_sensitivity:
   1460      - interaction
   1461    notification_emails:
   1462      - android-probes@mozilla.com
   1463      - rtestard@mozilla.com
   1464    expires: never
   1465 
   1466 crash_reporter:
   1467  displayed:
   1468    type: event
   1469    description: The crash report has been displayed.
   1470    bugs:
   1471      - https://github.com/mozilla-mobile/focus-android/issues/5652
   1472    data_reviews:
   1473      - https://github.com/mozilla-mobile/focus-android/pull/5725
   1474      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1475    data_sensitivity:
   1476      - interaction
   1477    notification_emails:
   1478      - android-probes@mozilla.com
   1479      - rtestard@mozilla.com
   1480    expires: never
   1481  close_report:
   1482    type: event
   1483    description: The crash report has been submitted.
   1484    bugs:
   1485      - https://github.com/mozilla-mobile/focus-android/issues/5652
   1486    data_reviews:
   1487      - https://github.com/mozilla-mobile/focus-android/pull/5725
   1488      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1489    data_sensitivity:
   1490      - interaction
   1491    notification_emails:
   1492      - android-probes@mozilla.com
   1493      - rtestard@mozilla.com
   1494    expires: never
   1495    extra_keys:
   1496      submit_report:
   1497        description: Did the user choose to send the report?
   1498        type: boolean
   1499 
   1500 browser_menu:
   1501  navigation_toolbar_action:
   1502    type: event
   1503    description: The user has tapped on a navigation toolbar item.
   1504    bugs:
   1505      - https://github.com/mozilla-mobile/focus-android/issues/5648
   1506    data_reviews:
   1507      - https://github.com/mozilla-mobile/focus-android/pull/5748
   1508      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1509    data_sensitivity:
   1510      - interaction
   1511    notification_emails:
   1512      - android-probes@mozilla.com
   1513      - rtestard@mozilla.com
   1514    expires: never
   1515    extra_keys:
   1516      item:
   1517        description: |
   1518          A string containing the name of the item the user tapped:
   1519          back, forward, share, reload, stop
   1520        type: string
   1521  browser_menu_action:
   1522    type: event
   1523    description: The user has tapped on a browser menu item.
   1524    bugs:
   1525      - https://github.com/mozilla-mobile/focus-android/issues/5648
   1526    data_reviews:
   1527      - https://github.com/mozilla-mobile/focus-android/pull/5748
   1528      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1529    data_sensitivity:
   1530      - interaction
   1531    notification_emails:
   1532      - android-probes@mozilla.com
   1533      - rtestard@mozilla.com
   1534    expires: never
   1535    extra_keys:
   1536      item:
   1537        description: |
   1538          A string containing the name of the item the user tapped:
   1539          add_to_homescreen, desktop_view_off, desktop_view_on,
   1540          find_in_page, open_in_app, settings
   1541        type: string
   1542 
   1543 custom_tabs_toolbar:
   1544  navigation_toolbar_action:
   1545    type: event
   1546    description: The user tapped on a navigation toolbar item in a custom tab.
   1547    bugs:
   1548      - https://github.com/mozilla-mobile/focus-android/issues/5649
   1549    data_reviews:
   1550      - https://github.com/mozilla-mobile/focus-android/pull/5748
   1551      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1552    data_sensitivity:
   1553      - interaction
   1554    notification_emails:
   1555      - android-probes@mozilla.com
   1556      - rtestard@mozilla.com
   1557    expires: never
   1558    extra_keys:
   1559      item:
   1560        description: |
   1561          A string containing the name of the item the user tapped:
   1562          back, forward, reload, stop
   1563        type: string
   1564  browser_menu_action:
   1565    type: event
   1566    description: The user tapped on a browser menu item item in a custom tab.
   1567    bugs:
   1568      - https://github.com/mozilla-mobile/focus-android/issues/5649
   1569    data_reviews:
   1570      - https://github.com/mozilla-mobile/focus-android/pull/5748
   1571      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1572    data_sensitivity:
   1573      - interaction
   1574    notification_emails:
   1575      - android-probes@mozilla.com
   1576      - rtestard@mozilla.com
   1577    expires: never
   1578    extra_keys:
   1579      item:
   1580        description: |
   1581          A string containing the name of the item the user tapped:
   1582          desktop_view_off, desktop_view_on, find_in_page, open_in_app,
   1583          add_to_homescreen, open_in browser
   1584        type: string
   1585  close_tab_tapped:
   1586    type: event
   1587    description: The user has closed a custom tab.
   1588    bugs:
   1589      - https://github.com/mozilla-mobile/focus-android/issues/5649
   1590    data_reviews:
   1591      - https://github.com/mozilla-mobile/focus-android/pull/5748
   1592      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1593    data_sensitivity:
   1594      - interaction
   1595    notification_emails:
   1596      - android-probes@mozilla.com
   1597      - rtestard@mozilla.com
   1598    expires: never
   1599  action_button_tapped:
   1600    type: event
   1601    description: The user has tapped the actionbutton a custom tab.
   1602    bugs:
   1603      - https://github.com/mozilla-mobile/focus-android/issues/5649
   1604    data_reviews:
   1605      - https://github.com/mozilla-mobile/focus-android/pull/5748
   1606      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1607    data_sensitivity:
   1608      - interaction
   1609    notification_emails:
   1610      - android-probes@mozilla.com
   1611      - rtestard@mozilla.com
   1612    expires: never
   1613 
   1614 tracking_protection_exceptions:
   1615  allow_list_opened:
   1616    type: event
   1617    description: The user has opened the exceptions list.
   1618    bugs:
   1619      - https://github.com/mozilla-mobile/focus-android/issues/5753
   1620    data_reviews:
   1621      - https://github.com/mozilla-mobile/focus-android/pull/5758
   1622      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1623    data_sensitivity:
   1624      - interaction
   1625    notification_emails:
   1626      - android-probes@mozilla.com
   1627      - rtestard@mozilla.com
   1628    expires: never
   1629  allow_list_cleared:
   1630    type: event
   1631    description: The user has removed all items from exceptions list.
   1632    bugs:
   1633      - https://github.com/mozilla-mobile/focus-android/issues/5753
   1634    data_reviews:
   1635      - https://github.com/mozilla-mobile/focus-android/pull/5758
   1636      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1637    data_sensitivity:
   1638      - interaction
   1639    notification_emails:
   1640      - android-probes@mozilla.com
   1641      - rtestard@mozilla.com
   1642    expires: never
   1643    extra_keys:
   1644      list_size:
   1645        description: The number of exceptions in the list.
   1646        type: quantity
   1647  selected_items_removed:
   1648    type: event
   1649    description: The user has removed the selected items from exceptions list.
   1650    bugs:
   1651      - https://github.com/mozilla-mobile/focus-android/issues/5753
   1652    data_reviews:
   1653      - https://github.com/mozilla-mobile/focus-android/pull/5758
   1654      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1655    data_sensitivity:
   1656      - interaction
   1657    notification_emails:
   1658      - android-probes@mozilla.com
   1659      - rtestard@mozilla.com
   1660    expires: never
   1661    extra_keys:
   1662      list_size:
   1663        description: The number of selected items removed.
   1664        type: quantity
   1665 
   1666 notifications:
   1667  open_button_tapped:
   1668    type: event
   1669    description: The user has tapped the Open option button from notification.
   1670    bugs:
   1671      - https://github.com/mozilla-mobile/focus-android/issues/5651
   1672    data_reviews:
   1673      - https://github.com/mozilla-mobile/focus-android/pull/5769
   1674      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1675    data_sensitivity:
   1676      - interaction
   1677    notification_emails:
   1678      - android-probes@mozilla.com
   1679      - rtestard@mozilla.com
   1680    expires: never
   1681  erase_open_button_tapped:
   1682    type: event
   1683    description: The user has tapped the Erase & Open button from notification.
   1684    bugs:
   1685      - https://github.com/mozilla-mobile/focus-android/issues/5651
   1686    data_reviews:
   1687      - https://github.com/mozilla-mobile/focus-android/pull/5769
   1688      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1689    data_sensitivity:
   1690      - interaction
   1691    notification_emails:
   1692      - android-probes@mozilla.com
   1693      - rtestard@mozilla.com
   1694    expires: never
   1695    extra_keys:
   1696      opened_tabs:
   1697        description: Number of currently opened tabs
   1698        type: quantity
   1699  notification_tapped:
   1700    type: event
   1701    description: The user has tapped the notification to close the app.
   1702    bugs:
   1703      - https://github.com/mozilla-mobile/focus-android/issues/5651
   1704    data_reviews:
   1705      - https://github.com/mozilla-mobile/focus-android/pull/5769
   1706      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1707    data_sensitivity:
   1708      - interaction
   1709    notification_emails:
   1710      - android-probes@mozilla.com
   1711      - rtestard@mozilla.com
   1712    expires: never
   1713  permission_granted:
   1714    type: boolean
   1715    description: |
   1716      True if notifications are allowed from OS settings, otherwise false.
   1717      Prior to Android 13, notifications were allowed by default;
   1718      starting with Android 13,the user must explicitly grant the permission.
   1719    bugs:
   1720      - https://bugzilla.mozilla.org/show_bug.cgi?id=1803358
   1721    data_reviews:
   1722      - https://github.com/mozilla-mobile/firefox-android/pull/475
   1723      - https://github.com/mozilla-mobile/firefox-android/pull/4040
   1724    data_sensitivity:
   1725      - technical
   1726    notification_emails:
   1727      - android-probes@mozilla.com
   1728    expires: never
   1729 
   1730 app_shortcuts:
   1731  just_erase_button_tapped:
   1732    type: event
   1733    description: The user has tapped the Erase option button from shortcuts.
   1734    bugs:
   1735      - https://github.com/mozilla-mobile/focus-android/issues/5651
   1736    data_reviews:
   1737      - https://github.com/mozilla-mobile/focus-android/pull/5769
   1738      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1739    data_sensitivity:
   1740      - interaction
   1741    notification_emails:
   1742      - android-probes@mozilla.com
   1743      - rtestard@mozilla.com
   1744    expires: never
   1745    extra_keys:
   1746      opened_tabs:
   1747        description: Number of currently opened tabs
   1748        type: quantity
   1749  erase_open_button_tapped:
   1750    type: event
   1751    description: The user has tapped the Erase & Open button from shortcuts.
   1752    bugs:
   1753      - https://github.com/mozilla-mobile/focus-android/issues/5651
   1754    data_reviews:
   1755      - https://github.com/mozilla-mobile/focus-android/pull/5769
   1756      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1757    data_sensitivity:
   1758      - interaction
   1759    notification_emails:
   1760      - android-probes@mozilla.com
   1761      - rtestard@mozilla.com
   1762    expires: never
   1763    extra_keys:
   1764      opened_tabs:
   1765        description: Number of currently opened tabs
   1766        type: quantity
   1767 
   1768 recent_apps:
   1769  app_removed_from_list:
   1770    type: event
   1771    description: The user removed the apps from recent apps screen.
   1772    bugs:
   1773      - https://github.com/mozilla-mobile/focus-android/issues/5651
   1774    data_reviews:
   1775      - https://github.com/mozilla-mobile/focus-android/pull/5769
   1776      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1777    data_sensitivity:
   1778      - interaction
   1779    notification_emails:
   1780      - android-probes@mozilla.com
   1781      - rtestard@mozilla.com
   1782    expires: never
   1783 
   1784 context_menu:
   1785  item_tapped:
   1786    type: event
   1787    description: The user has tapped an option from context menu.
   1788    bugs:
   1789      - https://github.com/mozilla-mobile/focus-android/issues/5647
   1790    data_reviews:
   1791      - https://github.com/mozilla-mobile/focus-android/pull/5773
   1792      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1793    data_sensitivity:
   1794      - interaction
   1795    notification_emails:
   1796      - android-probes@mozilla.com
   1797      - rtestard@mozilla.com
   1798    expires: never
   1799    extra_keys:
   1800      item_name:
   1801        description: |
   1802          The name of the item that was tapped. One of the following:
   1803          open_in_new_tab, open_in_private_tab, open_image_in_new_tab,
   1804          save_image, share_link, copy_link, copy_image_location, share_image
   1805        type: string
   1806 
   1807 onboarding:
   1808  get_started_button:
   1809    type: event
   1810    description: The user has tapped on get started button.
   1811    bugs:
   1812      - https://github.com/mozilla-mobile/focus-android/issues/7500
   1813    data_reviews:
   1814      - https://github.com/mozilla-mobile/focus-android/pull/7566#issuecomment-1235551604
   1815      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   1816    data_sensitivity:
   1817      - interaction
   1818    notification_emails:
   1819      - android-probes@mozilla.com
   1820    expires: never
   1821  default_browser_button:
   1822    type: event
   1823    description: The user has tapped on set as default browser button.
   1824    bugs:
   1825      - https://github.com/mozilla-mobile/focus-android/issues/7500
   1826    data_reviews:
   1827      - https://github.com/mozilla-mobile/focus-android/pull/7566#issuecomment-1235551604
   1828      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   1829    data_sensitivity:
   1830      - interaction
   1831    notification_emails:
   1832      - android-probes@mozilla.com
   1833    expires: never
   1834  skip_button:
   1835    type: event
   1836    description: The user has tapped on skip button.
   1837    bugs:
   1838      - https://github.com/mozilla-mobile/focus-android/issues/7500
   1839    data_reviews:
   1840      - https://github.com/mozilla-mobile/focus-android/pull/7566#issuecomment-1235551604
   1841      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   1842    data_sensitivity:
   1843      - interaction
   1844    notification_emails:
   1845      - android-probes@mozilla.com
   1846    expires: never
   1847  page_displayed:
   1848    type: event
   1849    description: A page from onboarding has been displayed.
   1850    bugs:
   1851      - https://github.com/mozilla-mobile/focus-android/issues/5635
   1852    data_reviews:
   1853      - https://github.com/mozilla-mobile/focus-android/pull/5869
   1854      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1855    data_sensitivity:
   1856      - interaction
   1857    notification_emails:
   1858      - android-probes@mozilla.com
   1859      - rtestard@mozilla.com
   1860    expires: never
   1861    extra_keys:
   1862      current_item:
   1863        description: The curent displayed item position.
   1864        type: quantity
   1865  skip_button_tapped:
   1866    type: event
   1867    description: The user has tapped to skip onboarding.
   1868    bugs:
   1869      - https://github.com/mozilla-mobile/focus-android/issues/5635
   1870    data_reviews:
   1871      - https://github.com/mozilla-mobile/focus-android/pull/5869
   1872      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1873    data_sensitivity:
   1874      - interaction
   1875    notification_emails:
   1876      - android-probes@mozilla.com
   1877      - rtestard@mozilla.com
   1878    expires: never
   1879    extra_keys:
   1880      current_item:
   1881        description: The curent displayed item position.
   1882        type: quantity
   1883  finish_button_tapped:
   1884    type: event
   1885    description: The user has tapped to finish onboarding.
   1886    bugs:
   1887      - https://github.com/mozilla-mobile/focus-android/issues/5635
   1888    data_reviews:
   1889      - https://github.com/mozilla-mobile/focus-android/pull/5869
   1890      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1891    data_sensitivity:
   1892      - interaction
   1893    notification_emails:
   1894      - android-probes@mozilla.com
   1895      - rtestard@mozilla.com
   1896    expires: never
   1897    extra_keys:
   1898      current_item:
   1899        description: The curent displayed item position.
   1900        type: quantity
   1901  next_button_tapped:
   1902    type: event
   1903    description: The user has tapped next onboarding.
   1904    bugs:
   1905      - https://github.com/mozilla-mobile/focus-android/issues/5635
   1906    data_reviews:
   1907      - https://github.com/mozilla-mobile/focus-android/pull/5869
   1908      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1909    data_sensitivity:
   1910      - interaction
   1911    notification_emails:
   1912      - android-probes@mozilla.com
   1913      - rtestard@mozilla.com
   1914    expires: never
   1915    extra_keys:
   1916      current_item:
   1917        description: The curent displayed item position.
   1918        type: quantity
   1919 
   1920 search_suggestions:
   1921  suggestion_tapped:
   1922    type: event
   1923    description: Search suggestion selected.
   1924    bugs:
   1925      - https://github.com/mozilla-mobile/focus-android/issues/5662
   1926    data_reviews:
   1927      - https://github.com/mozilla-mobile/focus-android/pull/5864
   1928      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1929    data_sensitivity:
   1930      - interaction
   1931    notification_emails:
   1932      - android-probes@mozilla.com
   1933      - rtestard@mozilla.com
   1934    expires: never
   1935    extra_keys:
   1936      engine_name:
   1937        description: The name of the engine used to perform the search.
   1938        type: string
   1939  search_tapped:
   1940    type: event
   1941    description: The typed text search was selected.
   1942    bugs:
   1943      - https://github.com/mozilla-mobile/focus-android/issues/5662
   1944    data_reviews:
   1945      - https://github.com/mozilla-mobile/focus-android/pull/5864
   1946      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1947    data_sensitivity:
   1948      - interaction
   1949    notification_emails:
   1950      - android-probes@mozilla.com
   1951      - rtestard@mozilla.com
   1952    expires: never
   1953    extra_keys:
   1954      engine_name:
   1955        description: The name of the engine used to perform the search.
   1956        type: string
   1957  autocomplete_arrow_tapped:
   1958    type: event
   1959    description: Search suggestion selected.
   1960    bugs:
   1961      - https://github.com/mozilla-mobile/focus-android/issues/5662
   1962    data_reviews:
   1963      - https://github.com/mozilla-mobile/focus-android/pull/5864
   1964      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1965    data_sensitivity:
   1966      - interaction
   1967    notification_emails:
   1968      - android-probes@mozilla.com
   1969      - rtestard@mozilla.com
   1970    expires: never
   1971 
   1972 advanced_settings:
   1973  remote_debug_setting_changed:
   1974    type: event
   1975    description: |
   1976      Remote debugging setting has changed.
   1977    bugs:
   1978      - https://github.com/mozilla-mobile/focus-android/issues/5653
   1979    data_reviews:
   1980      - https://github.com/mozilla-mobile/focus-android/pull/5940
   1981      - https://github.com/mozilla-mobile/focus-android/pull/7906
   1982    data_sensitivity:
   1983      - interaction
   1984    notification_emails:
   1985      - android-probes@mozilla.com
   1986      - rtestard@mozilla.com
   1987    expires: never
   1988    extra_keys:
   1989      is_enabled:
   1990        description: The new setting true for ON, false for OFF
   1991        type: boolean
   1992  open_links_setting_changed:
   1993    type: event
   1994    description: |
   1995      Open links setting has changed.
   1996    bugs:
   1997      - https://github.com/mozilla-mobile/focus-android/issues/5653
   1998    data_reviews:
   1999      - https://github.com/mozilla-mobile/focus-android/pull/5940
   2000      - https://github.com/mozilla-mobile/focus-android/pull/7906
   2001    data_sensitivity:
   2002      - interaction
   2003    notification_emails:
   2004      - android-probes@mozilla.com
   2005      - rtestard@mozilla.com
   2006    expires: never
   2007    extra_keys:
   2008      is_enabled:
   2009        description: The new setting true for ON, false for OFF
   2010        type: boolean
   2011 privacy_settings:
   2012  telemetry_setting_changed:
   2013    type: event
   2014    description: |
   2015      Telemetry setting has changed.
   2016    bugs:
   2017      - https://github.com/mozilla-mobile/focus-android/issues/5653
   2018    data_reviews:
   2019      - https://github.com/mozilla-mobile/focus-android/pull/5940
   2020      - https://github.com/mozilla-mobile/focus-android/pull/7906
   2021    data_sensitivity:
   2022      - interaction
   2023    notification_emails:
   2024      - android-probes@mozilla.com
   2025      - rtestard@mozilla.com
   2026    expires: never
   2027    extra_keys:
   2028      is_enabled:
   2029        description: The new setting true for ON, false for OFF
   2030        type: boolean
   2031  safe_browsing_setting_changed:
   2032    type: event
   2033    description: |
   2034      Safe browsing setting has changed.
   2035    bugs:
   2036      - https://github.com/mozilla-mobile/focus-android/issues/5653
   2037    data_reviews:
   2038      - https://github.com/mozilla-mobile/focus-android/pull/5940
   2039      - https://github.com/mozilla-mobile/focus-android/pull/7906
   2040    data_sensitivity:
   2041      - interaction
   2042    notification_emails:
   2043      - android-probes@mozilla.com
   2044      - rtestard@mozilla.com
   2045    expires: never
   2046    extra_keys:
   2047      is_enabled:
   2048        description: The new setting true for ON, false for OFF
   2049        type: boolean
   2050  unlock_setting_changed:
   2051    type: event
   2052    description: |
   2053      Biometric unlock setting has changed.
   2054    bugs:
   2055      - https://github.com/mozilla-mobile/focus-android/issues/5653
   2056    data_reviews:
   2057      - https://github.com/mozilla-mobile/focus-android/pull/5940
   2058      - https://github.com/mozilla-mobile/focus-android/pull/7906
   2059    data_sensitivity:
   2060      - interaction
   2061    notification_emails:
   2062      - android-probes@mozilla.com
   2063      - rtestard@mozilla.com
   2064    expires: never
   2065    extra_keys:
   2066      is_enabled:
   2067        description: The new setting true for ON, false for OFF
   2068        type: boolean
   2069  stealth_setting_changed:
   2070    type: event
   2071    description: |
   2072      Stealth setting has changed.
   2073    bugs:
   2074      - https://github.com/mozilla-mobile/focus-android/issues/5653
   2075    data_reviews:
   2076      - https://github.com/mozilla-mobile/focus-android/pull/5940
   2077      - https://github.com/mozilla-mobile/focus-android/pull/7906
   2078    data_sensitivity:
   2079      - interaction
   2080    notification_emails:
   2081      - android-probes@mozilla.com
   2082      - rtestard@mozilla.com
   2083    expires: never
   2084    extra_keys:
   2085      is_enabled:
   2086        description: The new setting true for ON, false for OFF
   2087        type: boolean
   2088  block_cookies_changed:
   2089    type: event
   2090    description: |
   2091      Block cookies setting has changed.
   2092    bugs:
   2093      - https://github.com/mozilla-mobile/focus-android/issues/6097
   2094    data_reviews:
   2095      - https://github.com/mozilla-mobile/focus-android/pull/6105
   2096      - https://github.com/mozilla-mobile/focus-android/pull/7906
   2097    data_sensitivity:
   2098      - interaction
   2099    notification_emails:
   2100      - android-probes@mozilla.com
   2101      - rtestard@mozilla.com
   2102    expires: never
   2103    extra_keys:
   2104      is_enabled:
   2105        description: |
   2106          A string containing the new block cookies option the user has chosen:
   2107          yes, third_party_only, third_party_tracker, cross_site, no
   2108        type: string
   2109 
   2110 metrics:
   2111  start_reason_process_error:
   2112    type: boolean
   2113    description: |
   2114      The `AppStartReasonProvider.ProcessLifecycleObserver.onCreate` was
   2115      unexpectedly called twice. We can use this metric to validate our
   2116      assumptions about how these APIs are called. This probe can be removed
   2117      once we validate these assumptions.
   2118    bugs:
   2119      - https://github.com/mozilla-mobile/focus-android/issues/7079
   2120    data_reviews:
   2121      - https://github.com/mozilla-mobile/focus-android/
   2122    data_sensitivity:
   2123      - technical
   2124    notification_emails:
   2125      - perf-telemetry-alerts@mozilla.com
   2126      - mleclair@mozilla.com
   2127    expires: never
   2128    metadata:
   2129      tags:
   2130        - Performance
   2131  start_reason_activity_error:
   2132    type: boolean
   2133    description: |
   2134      The `AppStartReasonProvider.ActivityLifecycleCallbacks.onActivityCreated`
   2135      was unexpectedly called twice. We can use this metric to validate our
   2136      assumptions about how these APIs are called. This probe can be removed
   2137      once we validate these assumptions.
   2138    bugs:
   2139      - https://github.com/mozilla-mobile/focus-android/issues/7079
   2140    data_reviews:
   2141      - https://github.com/mozilla-mobile/focus-android/
   2142    data_sensitivity:
   2143      - technical
   2144    notification_emails:
   2145      - perf-telemetry-alerts@mozilla.com
   2146      - mleclair@mozilla.com
   2147    expires: never
   2148    metadata:
   2149      tags:
   2150        - Performance
   2151  search_widget_installed:
   2152    type: boolean
   2153    lifetime: application
   2154    description: |
   2155      Whether or not the search widget is installed
   2156    send_in_pings:
   2157      - metrics
   2158    bugs:
   2159      - https://github.com/mozilla-mobile/focus-android/issues/
   2160    data_reviews:
   2161      - https://github.com/mozilla-mobile/focus-android/pull/7474
   2162      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2163      - https://github.com/mozilla-mobile/firefox-android/pull/4040
   2164    data_sensitivity:
   2165      - interaction
   2166    notification_emails:
   2167      - android-probes@mozilla.com
   2168    expires: never
   2169    metadata:
   2170      tags:
   2171        - Search
   2172 
   2173 search_widget:
   2174  new_tab_button:
   2175    type: event
   2176    description: |
   2177      A user pressed anywhere from the Focus logo until the start of the
   2178      microphone icon, opening a new tab search screen.
   2179    bugs:
   2180      - https://github.com/mozilla-mobile/focus-android/issues/
   2181    data_reviews:
   2182      - https://github.com/mozilla-mobile/focus-android/pull/7474
   2183      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2184      - https://github.com/mozilla-mobile/firefox-android/pull/4040
   2185    data_sensitivity:
   2186      - interaction
   2187    notification_emails:
   2188      - android-probes@mozilla.com
   2189    expires: never
   2190    metadata:
   2191      tags:
   2192        - Search
   2193  voice_button:
   2194    type: event
   2195    description: |
   2196      A user pressed the microphone icon, opening a new voice search screen.
   2197    bugs:
   2198      - https://github.com/mozilla-mobile/focus-android/issues/
   2199    data_reviews:
   2200      - https://github.com/mozilla-mobile/focus-android/pull/7474
   2201      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2202      - https://github.com/mozilla-mobile/firefox-android/pull/4040
   2203    data_sensitivity:
   2204      - interaction
   2205    notification_emails:
   2206      - android-probes@mozilla.com
   2207    expires: never
   2208    metadata:
   2209      tags:
   2210        - Search
   2211  promote_dialog_shown:
   2212    type: event
   2213    description: |
   2214      Promote search widget dialog is shown to the user.
   2215    bugs:
   2216      - https://github.com/mozilla-mobile/focus-android/issues/7506
   2217    data_reviews:
   2218      - https://github.com/mozilla-mobile/focus-android/pull/7657#issuecomment-1252242947
   2219      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2220      - https://github.com/mozilla-mobile/firefox-android/pull/4040
   2221    data_sensitivity:
   2222      - interaction
   2223    notification_emails:
   2224      - android-probes@mozilla.com
   2225    expires: never
   2226    metadata:
   2227      tags:
   2228        - Search
   2229  add_to_home_screen_button:
   2230    type: event
   2231    description: |
   2232      The user has pressed on add search widget
   2233      to home screen button from promote dialog.
   2234    bugs:
   2235      - https://github.com/mozilla-mobile/focus-android/issues/7506
   2236    data_reviews:
   2237      - https://github.com/mozilla-mobile/focus-android/pull/7657#issuecomment-1252242947
   2238      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2239    data_sensitivity:
   2240      - interaction
   2241    notification_emails:
   2242      - android-probes@mozilla.com
   2243    expires: never
   2244    metadata:
   2245      tags:
   2246        - Search
   2247  widget_was_added:
   2248    type: event
   2249    description: |
   2250      The user has added successfully the search widget from
   2251      promote search widget dialog.
   2252    bugs:
   2253      - https://github.com/mozilla-mobile/focus-android/issues/7506
   2254    data_reviews:
   2255      - https://github.com/mozilla-mobile/focus-android/pull/7657#issuecomment-1252242947
   2256      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2257    data_sensitivity:
   2258      - interaction
   2259    notification_emails:
   2260      - android-probes@mozilla.com
   2261    expires: never
   2262    metadata:
   2263      tags:
   2264        - Search
   2265 cookie_banner:
   2266  visited_setting:
   2267    type: event
   2268    description: A user visited the cookie banner handling screen
   2269    bugs:
   2270      - https://github.com/mozilla-mobile/focus-android/issues/7965
   2271    data_reviews:
   2272      - https://github.com/mozilla-mobile/focus-android/pull/8008#issuecomment-1322266028
   2273      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2274    data_sensitivity:
   2275      - interaction
   2276    notification_emails:
   2277      - android-probes@mozilla.com
   2278    expires: never
   2279    metadata:
   2280      tags:
   2281        - Privacy&Security
   2282 
   2283  setting_changed:
   2284    type: event
   2285    description: |
   2286      A user changed their setting.
   2287    extra_keys:
   2288      cookie_banner_setting:
   2289        description: |
   2290          The new setting for cookie banner handling: disabled,reject_all,
   2291          or reject_or_accept_all.
   2292        type: string
   2293    bugs:
   2294      - https://github.com/mozilla-mobile/focus-android/issues/7965
   2295    data_reviews:
   2296      - https://github.com/mozilla-mobile/focus-android/pull/8008#issuecomment-1322266028
   2297      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2298    data_sensitivity:
   2299      - interaction
   2300    notification_emails:
   2301      - android-probes@mozilla.com
   2302    expires: never
   2303    metadata:
   2304      tags:
   2305        - Privacy&Security
   2306 
   2307  cookie_banner_cfr_shown:
   2308    type: event
   2309    description: |
   2310      Cfr for cookie banner is shown to the user.
   2311    bugs:
   2312      - https://github.com/mozilla-mobile/focus-android/
   2313    data_reviews:
   2314      - https://github.com/mozilla-mobile/focus-android/
   2315      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2316    data_sensitivity:
   2317      - interaction
   2318    notification_emails:
   2319      - android-probes@mozilla.com
   2320    expires: never
   2321    metadata:
   2322      tags:
   2323        - Privacy&Security
   2324 
   2325  exception_added:
   2326    type: event
   2327    description: |
   2328      A user added a cookie banner handling exception through
   2329      the toggle in the protections panel.
   2330    bugs:
   2331      - https://bugzilla.mozilla.org/show_bug.cgi?id=1797578
   2332    data_reviews:
   2333      - https://github.com/mozilla-mobile/focus-android/pull/8124#issuecomment-1344449866
   2334      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2335    data_sensitivity:
   2336      - interaction
   2337    notification_emails:
   2338      - android-probes@mozilla.com
   2339    expires: never
   2340    metadata:
   2341      tags:
   2342        - Privacy&Security
   2343 
   2344  report_site_domain:
   2345    type: url
   2346    description: |
   2347      A user can report a site domain(Ex. for https://edition.cnn.com/
   2348      site domain will be cnn.com) when the cookie banner reducer is not
   2349      working from the cookie banner details panel.
   2350    lifetime: ping
   2351    send_in_pings:
   2352      - cookie-banner-report-site
   2353    bugs:
   2354      - https://bugzilla.mozilla.org/show_bug.cgi?id=1803589
   2355    data_reviews:
   2356      - https://github.com/mozilla-mobile/firefox-android/pull/389#pullrequestreview-1341440145
   2357      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2358    data_sensitivity:
   2359      - technical
   2360      - interaction
   2361    notification_emails:
   2362      - android-probes@mozilla.com
   2363    expires: never
   2364    metadata:
   2365      tags:
   2366        - Privacy&Security
   2367 
   2368  report_site_cancel_button:
   2369    type: event
   2370    description: |
   2371      The user has pressed the report site domain cancel button
   2372      from the cookie banner reducer details panel.
   2373    bugs:
   2374      - https://bugzilla.mozilla.org/show_bug.cgi?id=1803589
   2375    data_reviews:
   2376      - https://github.com/mozilla-mobile/firefox-android/pull/389#pullrequestreview-1341440145
   2377      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2378    data_sensitivity:
   2379      - interaction
   2380    notification_emails:
   2381      - android-probes@mozilla.com
   2382    expires: never
   2383    metadata:
   2384      tags:
   2385        - Privacy&Security
   2386 
   2387  report_domain_site_button:
   2388    type: event
   2389    description: |
   2390      The user has pressed the report site domain button
   2391      from the cookie banner reducer details panel.
   2392    bugs:
   2393      - https://bugzilla.mozilla.org/show_bug.cgi?id=1803589
   2394    data_reviews:
   2395      - https://github.com/mozilla-mobile/firefox-android/pull/389#pullrequestreview-1341440145
   2396      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2397    data_sensitivity:
   2398      - interaction
   2399    notification_emails:
   2400      - android-probes@mozilla.com
   2401    expires: never
   2402    metadata:
   2403      tags:
   2404        - Privacy&Security
   2405 
   2406  exception_removed:
   2407    type: event
   2408    description: |
   2409      A user removed a cookie banner handling
   2410      exception through the toggle in the protections panel.
   2411    bugs:
   2412      - https://bugzilla.mozilla.org/show_bug.cgi?id=1797578
   2413    data_reviews:
   2414      - https://github.com/mozilla-mobile/focus-android/pull/8124#issuecomment-1344449866
   2415      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2416    data_sensitivity:
   2417      - interaction
   2418    notification_emails:
   2419      - android-probes@mozilla.com
   2420    expires: never
   2421    metadata:
   2422      tags:
   2423        - Privacy&Security
   2424 
   2425  visited_panel:
   2426    type: event
   2427    description: A user visited the cookie banner exception panel
   2428    bugs:
   2429      - https://bugzilla.mozilla.org/show_bug.cgi?id=1797578
   2430    data_reviews:
   2431      - https://github.com/mozilla-mobile/focus-android/pull/8124#issuecomment-1344449866
   2432      - https://github.com/mozilla-mobile/firefox-android/pull/3320
   2433    data_sensitivity:
   2434      - interaction
   2435    notification_emails:
   2436      - android-probes@mozilla.com
   2437    expires: never
   2438    metadata:
   2439      tags:
   2440        - Privacy&Security