diff options
Diffstat (limited to '')
-rw-r--r-- | browser/components/newtab/metrics.yaml | 1589 |
1 files changed, 1589 insertions, 0 deletions
diff --git a/browser/components/newtab/metrics.yaml b/browser/components/newtab/metrics.yaml new file mode 100644 index 0000000000..04845fcda0 --- /dev/null +++ b/browser/components/newtab/metrics.yaml @@ -0,0 +1,1589 @@ +# This Source Code Form is subject to the terms of the Mozilla Public +# License, v. 2.0. If a copy of the MPL was not distributed with this +# file, You can obtain one at http://mozilla.org/MPL/2.0/. + +# Adding a new metric? We have docs for that! +# https://firefox-source-docs.mozilla.org/toolkit/components/glean/user/new_definitions_file.html + +--- +$schema: moz://mozilla.org/schemas/glean/metrics/2-0-0 +$tags: + - 'Firefox :: New Tab Page' + +newtab: + locale: + type: string + description: > + The application's locale as of when newtab's TelemetryFeed was init. + Comes from `Services.local.appLocaleAsBCP47`. + Looks like `en-US`. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + lifetime: application + + newtab_category: + type: string + description: > + The current setting of the newtab page. + One of ["enabled", "disabled", "extension"] or any value from + SiteClassifier like "known-hijacker" or "social-media". + Similar to Activity Stream's PAGE_TAKEOVER_DATA event's + `newtab_url_category`. + Sampled once after newtab init. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + lifetime: application + + homepage_category: + type: string + description: > + The current setting of the home page. + One of ["enabled", "disabled", "extension"] or any value from + SiteClassifier like "known-hijacker" or "social-media". + Similar to Activity Stream's PAGE_TAKEOVER_DATA event's + `home_url_category`. + Sampled once after newtab init. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + lifetime: application + + opened: + type: event + description: > + Recorded when newtab UI is opened via `about:newtab` or `about:home` or + `about:welcome` and has been made visible (see `visibility_event_rcvd_ts` + in + [detect-user-session-start.js](https://searchfox.org/mozilla-central/source/browser/components/newtab/content-src/lib/detect-user-session-start.js)). + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + extra_keys: + newtab_visit_id: &newtab_visit_id + description: > + The id of this newtab visit. + Allows you to separate multiple simultaneous newtabs and + build an event timeline of actions taken from this newtab. + type: string + source: + description: > + The source that opened this newtab. + One of + * `about:newtab` + * `about:home` + * `about:welcome` + * `other` + (See `ONBOARDING_ALLOWED_PAGE_VALUES`). + type: string + send_in_pings: + - newtab + + closed: + type: event + description: > + Recorded when newtab UI is closed by + * navigation + * closing the tab + + Doesn't mean that the newtab was ever visible to a user. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + extra_keys: + newtab_visit_id: *newtab_visit_id + send_in_pings: + - newtab + + blocked_sponsors: + type: string_list + description: > + The advertiser names that have been dismissed by the user. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1828234 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1828234#c1 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + - ttran@mozilla.com + expires: never + send_in_pings: + - newtab + lifetime: application + + sov_allocation: + type: string_list + description: > + The partner group assignment for sov + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1840311 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1840311#c3 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + - ttran@mozilla.com + expires: never + send_in_pings: + - newtab + lifetime: application + +newtab.search: + enabled: + lifetime: application + type: boolean + description: > + Whether the search input is enabled on the newtab. + Corresponds to the value of the + `browser.newtabpage.activity-stream.showSearch` pref. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + +newtab.handoff_preference: + enabled: + lifetime: application + type: boolean + description: > + Records whether the + browser.newtabpage.activity-stream.improvesearch.handoffToAwesomebar preference is + enabled or disabled + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1864496 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1864496 + data_sensitivity: + - interaction + expires: 128 + notification_emails: + - fx-search-telemetry@mozilla.com + + +topsites: + enabled: + lifetime: application + type: boolean + description: > + Whether "topsites" is enabled on the newtab. + AKA the "Shortcuts" section. + Corresponds to the value of the + `browser.newtabpage.activity-stream.feeds.topsites` pref. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + + sponsored_enabled: + lifetime: application + type: boolean + description: > + Whether sponsored topsites are enabled on the newtab. + AKA the "Sponsored Shortcuts" section. + Corresponds to the value of the + `browser.newtabpage.activity-stream.showSponsoredTopSites` pref. + Can be `true` even if topsites.enabled is `false`. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + + impression: + type: event + description: > + Recorded when topsite tiles are loaded. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1820707 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1820707#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1821556#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1824842#c7 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + extra_keys: + advertiser_name: &advertiser_name + description: > + The name of the advertiser of the tile + type: string + tile_id: &tile_id + description: > + The tile id of the advertiser provided by Contile. Like `74357`. + type: quantity + newtab_visit_id: *newtab_visit_id + is_sponsored: &is_sponsored + description: Whether the topsite tile was sponsored. + type: boolean + position: &topsite_position + description: The position (0-index) of the topsite tile. + type: quantity + send_in_pings: + - newtab + + click: + type: event + description: > + Recorded when a topsite tile is clicked. + Only happens on click. Not on middle-click. Not on "Open in new Tab"-like + options in the context menu. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1820707 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1766887 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786670#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1820707#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1821556#c3 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1824842#c7 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + extra_keys: + advertiser_name: *advertiser_name + tile_id: *tile_id + newtab_visit_id: *newtab_visit_id + is_sponsored: *is_sponsored + position: *topsite_position + send_in_pings: + - newtab + + show_privacy_click: + type: event + description: > + Recorded when the "Our Sponsors and Your Privacy" menu item in the three- + dots menu of a sponsored topsite is clicked. + Corresponds to the receipt of a dispatched `ABOUT_SPONSORED_TOP_SITES` + action by `TelemetryFeed`. + bugs: + - https://mozilla-hub.atlassian.net/browse/DENG-1364 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1857324 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1857324 + data_sensitivity: [interaction] + notification_emails: + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - sbetancourt@mozilla.com + expires: never + extra_keys: + advertiser_name: *advertiser_name + tile_id: *tile_id + newtab_visit_id: *newtab_visit_id + position: *topsite_position + send_in_pings: + - newtab + + dismiss: + type: event + description: > + Recorded when the "Dismiss" menu item in the three-dots menu of a topsite + is clicked. + Corresponds to the receipt of a dispatched `BLOCK_URL` action by + `TelemetryFeed`. + Applies to both sponsored and non-sponsored topsites. + `advertiser_name` is only provided for sponsored topsites. + bugs: + - https://mozilla-hub.atlassian.net/browse/DENG-1363 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1857324 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1857324 + data_sensitivity: [interaction] + notification_emails: + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - sbetancourt@mozilla.com + - kdemtchouk@mozilla.com + - mbowerman@mozilla.com + expires: never + extra_keys: + advertiser_name: *advertiser_name + tile_id: *tile_id + newtab_visit_id: *newtab_visit_id + is_sponsored: *is_sponsored + position: *topsite_position + send_in_pings: + - newtab + + pref_changed: + type: event + description: > + Recorded when specific topsites prefs have changed. + + The list of possible prefs is presently: + * browser.newtabpage.activity-stream.feeds.topsites + * browser.newtabpage.activity-stream.showSponsoredTopSites + bugs: + - https://mozilla-hub.atlassian.net/browse/D0-1293 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1857324 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1857324 + data_sensitivity: [interaction] + notification_emails: + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - sbetancourt@mozilla.com + - kdemtchouk@mozilla.com + - mbowerman@mozilla.com + expires: never + extra_keys: + pref_name: + description: The full name of the pref whose value just changed. + type: string + new_value: + description: The new (current) value the pref just changed to. + type: boolean + send_in_pings: + - newtab + + rows: + lifetime: application + type: quantity + unit: integer + description: > + The number of topsite tile rows configured to be shown on the newtab + page. Corresponds to the value of the + `browser.newtabpage.activity-stream.topSitesRows` pref. This is not the + number of rows actually seen by the user: if the browser window is + partially off-screen, or isn't wide enough to accommodate eight tiles per + row, the actual number of rows may be different. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1821556 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1821556#c3 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + + sponsored_tiles_configured: + lifetime: application + type: quantity + unit: integer + description: > + The number of topsite tiles configured to be shown on newtab. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1862493 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi + data_sensitivity: + - technical + notification_emails: + - gleonard@mozilla.com + expires: never + send_in_pings: + - newtab + + sponsored_tiles_received: + lifetime: application + type: text + description: > + The stringified JSON of tiles processed for display (array of objects). + Includes tiles not displayed and reason for not displaying. + Fields included: advertiser, provider, display_position, + display_fail_reason. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi + data_sensitivity: + - web_activity + notification_emails: + - gleonard@mozilla.com + expires: never + send_in_pings: + - newtab + +pocket: + is_signed_in: + lifetime: application + type: boolean + description: > + Whether the Firefox user is signed in to Pocket. + Does not correspond to a pref, so its value is resampled at newtab's + component init and whenever there is a Discovery Stream user event. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + + enabled: + lifetime: application + type: boolean + description: > + Whether Pocket is enabled on the newtab. + AKA the "Recommended by Pocket" section. + Corresponds to the value of the + `browser.newtabpage.activity-stream.feeds.section.topstories` pref. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + + sponsored_stories_enabled: + lifetime: application + type: boolean + description: > + Whether Pocket sponsored stories are enabled on the newtab. + Corresponds to the value of the + `browser.newtabpage.activity-stream.showSponsored` pref. + Can be `true` even if pocket.enabled is `false`. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + data_sensitivity: + - technical + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + send_in_pings: + - newtab + + impression: + type: event + description: > + Recorded when a pocket tile is visible to the user. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1854245 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1862670 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1854245 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + extra_keys: + newtab_visit_id: *newtab_visit_id + is_sponsored: &is_sponsored_pocket + description: Whether the pocket tile was sponsored (has an ad shim). + type: boolean + position: &pocket_position + description: The position (0-index) of the pocket tile. + type: quantity + recommendation_id: &recommendation_id + description: > + The id from the Pocket API response that returned the recommendation. + Like "{61934fe5-fbb0-4f4e-b9dd-7eab5f6ee9cd}". + type: string + tile_id: &pocket_tile_id + description: > + A content identifier. + For organic Pocket recommendations it is an opaque id produced by + Pocket's recommendation systems. + For sponsored Pocket content it is Kevel's "ad ID". + type: quantity + send_in_pings: + - newtab + + click: + type: event + description: > + Recorded when a pocket tile is clicked. + Only happens on click. Not on middle-click. Not on "Open in new Tab"-like + options in the context menu. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1854245 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1862670 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1854245 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + extra_keys: + newtab_visit_id: *newtab_visit_id + is_sponsored: *is_sponsored_pocket + position: *pocket_position + recommendation_id: *recommendation_id + tile_id: *pocket_tile_id + send_in_pings: + - newtab + + save: + type: event + description: > + Recorded when a user decides to save a pocket tile. + Does not mean it ends up successfully saved. + Just that the user clicked on "Save to Pocket" in the little pocket + tile menu. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1854245 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1862670 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1854245 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + extra_keys: + newtab_visit_id: *newtab_visit_id + is_sponsored: *is_sponsored_pocket + position: *pocket_position + recommendation_id: *recommendation_id + tile_id: *pocket_tile_id + send_in_pings: + - newtab + + topic_click: + type: event + description: > + Recorded when a pocket "Popular Topic" is clicked. + Only happens on click. Not on middle-click. Not on "Open in new Tab"-like + options in the context menu. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1854245 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1786612 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1817105#c11 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1854245 + data_sensitivity: + - interaction + notification_emails: + - anicholson@mozilla.com + - chutten@mozilla.com + - mmccorquodale@mozilla.com + - najiang@mozilla.com + - lina@mozilla.com + expires: never + extra_keys: + newtab_visit_id: *newtab_visit_id + topic: + description: The topic that was clicked on. Like "entertainment". + type: string + send_in_pings: + - newtab + + shim: + type: text + lifetime: ping + description: | + Opaque partner identifier for a given ad impression or engagement action, + unique per market and region. + Pocket + [proxies requests to ad partners](https://github.com/Pocket/proxy-server/) + and provides them solely with market, region, and action to generate these + shims. Thus, though the contents of this field are obscure, they cannot + identify clients. + At time of writing this information is a comma-separated trio. + The first item is an index into the proxy server's list of acceptable http + endpoints for contacting the ad service. The second item is a + several-hundred-byte base64-encoded JSON-encoded struct with fields for, + amongst other things, market and region. The third is unknown, but appears + to be a signature or checksum. + This shim should not be sent with the client_id. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1862670 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1862670 + data_sensitivity: + - stored_content # Required for text type, and to encourage scrutiny + notification_emails: + - chutten@mozilla.com + - najiang@mozilla.com + expires: never + send_in_pings: + - spoc + + +messaging_system: + event_context_parse_error: + type: counter + lifetime: ping + description: | + How often we failed to parse event_context as JSON. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event_reason: + type: string + lifetime: ping + description: | + The event_context's `reason`. Likely something like + "welcome-window-closed" or "app-shut-down",. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event_page: + type: string + lifetime: ping + description: | + The event_context's `page`. Almost always "about:welcome". + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event_source: + type: string + lifetime: ping + description: | + The event_context's `source`. Likely something like "primary_button". + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event_context: + type: text + lifetime: ping + description: | + The stringified JSON of `event_context`. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - web_activity + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event_screen_family: + type: text + lifetime: ping + description: | + A string identifier of the message family derived from the message id + (e.g. MR_WELCOME_DEFAULT). + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1867627 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - web_activity + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + - nsauermann@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event_screen_id: + type: text + lifetime: ping + description: | + A string identifier of the message screen id + (e.g. AW_MOBILE_DOWNLOAD). + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1867627 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - web_activity + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + - nsauermann@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event_screen_initials: + type: text + lifetime: ping + description: | + A string identifier of the message screen initials + (e.g. 'EMAG' for EASY_SETUP, MOBILE_DOWNLOADS, AMO, GRATITUDE). + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1867627 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - web_activity + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + - nsauermann@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event_screen_index: + type: quantity + unit: integer + lifetime: ping + description: | + A number identifier of the screen index in a sequence of screens + (e.g. 0 for first message). + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - web_activity + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + - nsauermann@mozilla.com + expires: never + send_in_pings: + - messaging-system + + message_id: + type: text + lifetime: ping + description: | + A string identifier of the message in Activity Stream Router. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - web_activity + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + event: + type: string + description: > + The type of event. Any user defined string + (e.g. “IMPRESSION”, “CLICK_BUTTON”, "INDEXEDDB_OPEN_FAILED", “SESSION_END”) + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + ping_type: + type: string + description: > + Type of event the ping is capturing. + e.g. "cfr", "whats-new-panel", "onboarding" + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + source: + type: string + description: > + The source of the interaction described by the other metrics. + e.g. "frecent_links", "newtab", "CFR" + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + client_id: + type: uuid + lifetime: ping + description: | + The client_id according to Telemetry. + Might not always have a value due to policy around specific types of + ping being sent. Value may be the canary client id + `c0ffeec0-ffee-c0ff-eec0-ffeec0ffeec0` + in pings near when the data upload pref is disabled (if Telemetry gets + to go first), or between when a client_id has been removed and when it + has been regenerated. + Present only in some circumstances (see + [bug 1484035]https://bugzilla.mozilla.org/show_bug.cgi?id=1484035)). + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1755549 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1484035 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1755549 + data_sensitivity: + - technical + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + locale: + type: string + lifetime: ping + description: > + The locale as supplied to the messaging system by + `Services.locale.appLocaleAsBCP47`. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + browser_session_id: + type: uuid + lifetime: ping + # Disable yamllint for long lines. + # yamllint disable + description: > + The Legacy Telemetry browser "session id". + Identifies a specific period from application start to shutdown. + See [the "main" ping docs](https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/data/main-ping.html) + for details. + # yamllint enable + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + impression_id: + type: uuid + lifetime: ping + description: > + The unique impression identifier for a specific client. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + bucket_id: + type: string + lifetime: ping + description: > + A name shared between multiple messages that may individually be too + targetted. + e.g. a message that gets shown on specific websites or a message asking + about personal information. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + addon_version: + type: string + lifetime: ping + description: > + Used to hold the system addon's version, + now is almost certainly an echo of the app's build id. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - pmcmanis@mozilla.com + - dmosedale@mozilla.com + expires: never + send_in_pings: + - messaging-system + + unknown_key_count: + type: counter + description: | + The sum of all unknown keys counted. + Useful for testing. + Can be removed after bug 1600008 is resolved. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - chutten@mozilla.com + expires: never + send_in_pings: + - messaging-system + + unknown_keys: + type: labeled_counter + description: | + Ping keys supplied to the messaging system for which + we did not have a corresponding metric mapped to how often they attempted + to be recorded. + You may have forgotten to define an appropriate metric in + `browser/components/newtab/metrics.yaml`. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + glean_ping_for_ping_failures: + type: counter + description: | + How often something went awry within + `AboutWelcome.submitGleanPingForPing`, preventing ping submission. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + - chutten@mozilla.com + expires: never + send_in_pings: + - metrics + + invalid_nested_data: + type: labeled_counter + description: | + We received a ping with non-scalar data on a field of this name. + If this is existing pre-PingCentre-replacement data, you may need to + augment the logic in + `AboutWelcome.submitGleanPingForPing` like the other `handledKeys`. + If this is for new, post-PingCentre-replacement data, you should + probably prefer a flat structure. + If you're unsure, please ask in + [the #glean channel](https://chat.mozilla.org/#/room/#glean:mozilla.org). + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + - chutten@mozilla.com + expires: never + send_in_pings: + - messaging-system + + +messaging_system.attribution: + source: + type: string + lifetime: ping + description: | + Attribution's source, possibly derived from the utm parameter of the same + name. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + medium: + type: string + lifetime: ping + description: | + Attribution's medium, possibly derived from the utm parameter of the same + name. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + campaign: + type: string + lifetime: ping + description: | + Attribution's campaign, possibly derived from the utm parameter of the + same name. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + content: + type: string + lifetime: ping + description: | + Attribution's content, possibly derived from the utm parameter of the + same name. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + experiment: + type: string + lifetime: ping + description: | + Attribution's experiment key. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + variation: + type: string + lifetime: ping + description: | + Attribution's variation key. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + ua: + type: string + lifetime: ping + description: | + Attribution's ua key. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + dltoken: + type: string + lifetime: ping + description: | + String representation of the dltoken identifying the particular + installer used to install this Firefox. + Likely a UUID, if present. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + msstoresignedin: + type: string + lifetime: ping + description: | + Either the string "true" or the string "false" to indicate whether the + attributed install came from the Microsoft store and, if so, whether the + user was signed in at the time. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1756209 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1756209 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + dlsource: + type: string + lifetime: ping + description: | + Mozilla-specific download "source" name. Could be something like + "mozillaci" to identify that the installer came from + `{archive|ftp}.mozilla.org`. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1819997 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1819997 + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - interaction + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + + unknown_keys: + type: labeled_counter + description: | + Attribution keys supplied to the messaging system for which + we did not have a corresponding metric, and the count of how + often that happened. + Either add this key to a list of known attribution keys in + `AboutWelcomeTelemetry` to suppress or define an appropriate metric in + `browser/components/newtab/metrics.yaml` to collect. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1825863 + data_sensitivity: + - technical + notification_emails: + - dmosedale@mozilla.com + - pmcmanis@mozilla.com + expires: never + send_in_pings: + - messaging-system + +top_sites: # Replacement for PingCentre "topsites-impression|click" pings. + ping_type: + type: string + description: > + The ping's type. In other situations might be designated by an event's + name or an interaction field. E.g. "topsites-impression", + "topsites-click". + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_sensitivity: + - interaction + notification_emails: + - najiang@mozilla.com + expires: never + send_in_pings: + - top-sites + + position: + type: quantity + unit: topsite position + description: > + The position (1-based) of the topsites item being interatcted with. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_sensitivity: + - interaction + notification_emails: + - najiang@mozilla.com + expires: never + send_in_pings: + - top-sites + + source: + type: string + description: > + The source of the interaction. Always set to "newtab". + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_sensitivity: + - interaction + notification_emails: + - najiang@mozilla.com + expires: never + send_in_pings: + - top-sites + + tile_id: + type: string + description: > + String-encoded number for the tile's sponsored tile id. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_sensitivity: + - interaction + notification_emails: + - najiang@mozilla.com + expires: never + send_in_pings: + - top-sites + + reporting_url: + type: url + description: > + The url to report this interaction to. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_sensitivity: + - web_activity + notification_emails: + - najiang@mozilla.com + expires: never + send_in_pings: + - top-sites + + advertiser: + type: string + description: > + The name of the advertiser providing the sponsored TopSite. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_sensitivity: + - interaction + - web_activity + notification_emails: + - najiang@mozilla.com + expires: never + send_in_pings: + - top-sites + + context_id: + type: uuid + description: > + An identifier to identify users for Contextual Services user interaction pings. + bugs: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_reviews: + - https://bugzilla.mozilla.org/show_bug.cgi?id=1836283 + data_sensitivity: + - technical + notification_emails: + - najiang@mozilla.com + expires: never + send_in_pings: + - top-sites |