Source code
Revision control
Copy as Markdown
Other Tools
# 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
# Adding a new metric? We have docs for that!
---
$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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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
window_inner_height:
description: >
The height of the page window at time of load.
type: string
window_inner_width:
description: >
The width of the page window at time of load.
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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
tooltip_click:
type: event
description: >
Recorded when a feature highlight tooltip is opened.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- sdowne@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
feature:
description: The feature that was clicked on.
type: string
send_in_pings:
- newtab
topic_selection_open:
type: event
description: >
Recorded when the topic selection modal is opened
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
topic_selection_dismiss:
type: event
description: >
Recorded when the topic selection modal is dismissed (topics are not saved)
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
topic_selection_topics_saved:
type: event
description: >
Recorded when topics are saved from the topics selection modal
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
topics:
description: >
list of topics that were saved by user
type: string
previous_topics:
description: >
list of previous topics that were saved, an empty string
means no previous topics were saved
type: string
first_save:
description: >
whether or not it is the user's first time setting topics
type: boolean
send_in_pings:
- newtab
selected_topics:
type: string_list
description: >
The list of topics the user selected
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
- mcrawford@mozilla.com
expires: never
send_in_pings:
- newtab
lifetime: application
wallpaper_click:
type: event
description: >
Recorded when a user clicks on a wallpaper option
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
selected_wallpaper:
description: >
Which wallpaper has been selected by the user
Will be the title of a Wallpaper or 'none' for users
that reset the background to default
type: string
had_previous_wallpaper:
description: >
Whether or not user had a previously set wallpaper
type: boolean
had_uploaded_previously:
description: >
Whether or not user had a previously uploaded a custom wallpaper
type: boolean
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
wallpaper_highlight_cta_click:
type: event
description: >
Recorded when a user clicks the CTA on the wallpaper feature highlight
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
wallpaper_highlight_dismissed:
type: event
description: >
Recorded when a user dismisses the wallpaper feature highlight
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
wallpaper_category_click:
type: event
description: >
Recorded when a user clicks a wallpaper category option
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
selected_category:
description: >
Which wallpaper category selected by user
type: string
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
weather_change_display:
type: event
description: >
Recorded when a user changes the weather display.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
weather_display_mode: &weather_display_mode
description: >
Which display mode is selected.
type: string
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
weather_enabled:
lifetime: application
type: boolean
description: >
Whether the weather widget is enabled on the newtab.
Corresponds to the value of the
`browser.newtabpage.activity-stream.showWeather` pref.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
- sdowne@mozilla.com
expires: never
send_in_pings:
- newtab
weather_open_provider_url:
type: event
description: >
Recorded when a user opens a link to the Weather provider website.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
weather_impression:
type: event
description: >
Recorded when the weather widget is viewed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
weather_load_error:
type: event
description: >
Recorded when the weather widget is not available
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
weather_location_selected:
type: event
description: >
Recorded when a user selects a location for weather widget
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
fakespot_dismiss:
type: event
description: >
Recorded when a user dissmisses TBR fakespot feed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
fakespot_about_click:
type: event
description: >
Recorded when a user the 'About Fakespot' link in TBR fakespot feed context menu
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
fakespot_click:
type: event
description: >
Recorded when a user clicks on a card in TBR fakespot feed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
product_id:
description: >
id of fakespot product
type: string
category:
description: >
category of fakespot product
type: string
send_in_pings:
- newtab
fakespot_product_impression:
type: event
description: >
Recorded when a user triggers an impression on a card in TBR fakespot feed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
product_title:
description: >
title of fakespot product
type: string
product_id:
description: >
id of fakespot product
type: string
category:
description: >
category of fakespot product
type: string
send_in_pings:
- newtab
fakespot_cta_click:
type: event
description: >
Recorded when a user clicks on the CTA in TBR fakespot feed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
fakespot_category:
type: event
description: >
Recorded when a user changes the category in TBR fakespot feed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
category:
description: >
category that user selected
type: string
send_in_pings:
- newtab
sections_impression:
type: event
description: >
Recorded when a section is viewport and triggers an impression event
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had impression event
type: string
section_position:
description: >
position of section on newtab
type: string
is_section_followed: &is_section_followed
description: >
If click belongs in a section, if that section is followed
type: boolean
send_in_pings:
- newtab
sections_follow_section:
type: event
description: >
Recorded when a section is followed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had impression event
type: string
section_position:
description: >
position of section on newtab
type: string
event_source: &event_source
description: >
Where the source of the event originated ("button", "context menu", etc.)
type: string
send_in_pings:
- newtab
sections_unfollow_section:
type: event
description: >
Recorded when a section is unfollowed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had impression event
type: string
section_position:
description: >
position of section on newtab
type: string
event_source: *event_source
send_in_pings:
- newtab
sections_block_section:
type: event
description: >
Recorded when a section is blocked
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had impression event
type: string
section_position:
description: >
position of section on newtab
type: string
event_source: *event_source
send_in_pings:
- newtab
sections_unblock_section:
type: event
description: >
Recorded when a section is unblocked
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had unblock event
type: string
section_position:
description: >
position of section on newtab
type: string
event_source: *event_source
send_in_pings:
- newtab
inline_selection_impression:
type: event
description: >
Recorded when there is an impression on the inline selection component
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section_position:
description: >
position of the inline selection component (index point within sections)
type: string
send_in_pings:
- newtab
inline_selection_click:
type: event
description: >
Recorded when there is a click on the inline selection component
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
topic:
description: >
unique id of topic that was clicked
type: string
is_followed:
description: >
whether the click followed a topic or unfollowed. True for followed, false for unfollowed
type: boolean
section_position:
description: >
position of the inline selection component (index point within sections)
type: string
topic_position:
description: >
position of the topic within the inline selection component (index point starting at 0)
type: string
send_in_pings:
- newtab
abouthome_cache_construction:
type: timing_distribution
description: >
The length of time (in milliseconds) that it takes for the cache worker to
generate the cache and return it to the main thread
This metric was generated to correspond to the Legacy Telemetry
exponential histogram FX_ABOUTHOME_CACHE_CONSTRUCTION.
time_unit: millisecond
bugs:
data_reviews:
notification_emails:
- mconley@mozilla.com
expires: never
telemetry_mirror: FX_ABOUTHOME_CACHE_CONSTRUCTION
report_content_open:
type: event
description: >
Recorded when content reporting is opened from context menu
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- rhamoui@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
send_in_pings:
- newtab
report_content_submit:
type: event
description: >
Recorded when content reporting has been submitted
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- rhamoui@mozilla.com
expires: never
extra_keys:
card_type:
description: >
The type of the content card (e.g., "spoc", "organic")
type: string
corpus_item_id:
description: >
A content identifier.
For organic Newtab recommendations it is an opaque id produced by
Newtab's recommendation systems that corresponds uniquely to the URL.
This is the replacement for tile_id and scheduled_corpus_item_id.
type: string
is_section_followed:
description: >
If click belongs in a section, if that section is followed
type: boolean
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
received_rank:
description: >
The rank or order of the recommendation at the time it was sent to the client.
type: quantity
recommended_at:
description: >
The time in milliseconds the recommendation was recommended at.
type: quantity
report_reason:
description: >
The reason selected by the user when reporting the content
type: string
scheduled_corpus_item_id:
description: >
A content identifier.
For organic Newtab recommendations it is an opaque id produced by
Newtab's recommendation systems that corresponds uniquely to
a piece of content scheduled for a specific day on a specific surface.
This is the replacement for tile_id.
type: string
section:
description: >
If click belongs in a section, the name of the section
type: string
section_position:
description: >
If click belongs in a section, the numeric position of the section
type: string
title:
description: >
Title of the recommendation.
type: string
topic:
description: >
The topic of the recommendation. Like "entertainment".
type: string
url:
description: >
URL of the recommendation.
type: string
send_in_pings:
- newtab
metric_registered:
type: labeled_boolean
description: >
Records technical data about whether the metric registration
at runtime succeeded
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- pdahiya@mozilla.com
- mconley@mozilla.com
expires: never
ping_registered:
type: labeled_boolean
description: >
Records technical data about whether the ping registration
at runtime succeeded
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- pdahiya@mozilla.com
- mconley@mozilla.com
expires: never
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:
data_reviews:
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:
data_reviews:
data_sensitivity:
- interaction
expires: 144
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- anicholson@mozilla.com
- chutten@mozilla.com
- mmccorquodale@mozilla.com
- najiang@mozilla.com
- lina@mozilla.com
- sdowne@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 callback).
type: boolean
format: &format
description: The format of whatever item is displayed. It can differ if the content is an ad or organic. Possible responses are "spoc", "rectangle" (for ads) "billboard", "leaderboard", "small-card", "medium-card", "large-card" (for organic content).
type: string
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
scheduled_corpus_item_id: &scheduled_corpus_item_id
description: >
A content identifier.
For organic Newtab recommendations it is an opaque id produced by
Newtab's recommendation systems that corresponds uniquely to
a piece of content scheduled for a specific day on a specific surface.
This is the replacement for tile_id.
type: string
corpus_item_id: &corpus_item_id
description: >
A content identifier.
For organic Newtab recommendations it is an opaque id produced by
Newtab's recommendation systems that corresponds uniquely to the URL.
This is the replacement for tile_id and scheduled_corpus_item_id.
type: string
received_rank: &received_rank
description: The rank or order of the recommendation at the time it was sent to the client.
type: quantity
recommended_at: &recommended_at
description: The time in milliseconds the recomendation was recommended at.
type: quantity
topic:
description: The topic of the recommendation. Like "entertainment".
type: string
selected_topics:
description: >
The list of topics the user selected
type: string
is_list_card:
description: >
Where the article card is in the list component
type: boolean
section:
description: >
If click belongs in a section, the name of the section
type: string
section_position:
description: >
If click belongs in a section, the numeric position of the section
type: string
is_section_followed: *is_section_followed
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:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- anicholson@mozilla.com
- chutten@mozilla.com
- mmccorquodale@mozilla.com
- najiang@mozilla.com
- lina@mozilla.com
- sdowne@mozilla.com
- mcrawford@mozilla.ccocm
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
is_sponsored: *is_sponsored_pocket
format: *format
position: *pocket_position
recommendation_id: *recommendation_id
tile_id: *pocket_tile_id
scheduled_corpus_item_id: *scheduled_corpus_item_id
corpus_item_id: *corpus_item_id
received_rank: *received_rank
recommended_at: *recommended_at
matches_selected_topic:
description: >
Returns value based on if a the topic of the pocket recommendation matches one
of the user-selected topic categories
type: string
topic:
description: The topic of the recommendation. Like "entertainment".
type: string
selected_topics:
description: >
The list of topics the user selected
type: string
is_list_card:
description: >
Where the article card is in the list component
type: boolean
section:
description: >
If click belongs in a section, the name of the section
type: string
section_position:
description: >
If click belongs in a section, the numeric position of the section
type: string
is_section_followed: *is_section_followed
event_source: *event_source
send_in_pings:
- newtab
dismiss:
type: event
description: >
Recorded when a pocket tile is dismissed.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- sdowne@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
is_sponsored: *is_sponsored_pocket
format: *format
position: *pocket_position
recommendation_id: *recommendation_id
tile_id: *pocket_tile_id
scheduled_corpus_item_id: *scheduled_corpus_item_id
corpus_item_id: *corpus_item_id
received_rank: *received_rank
recommended_at: *recommended_at
is_list_card:
description: >
Where the article card is in the list component
type: boolean
section:
description: >
If click belongs in a section, the name of the section
type: string
section_position:
description: >
If click belongs in a section, the numeric position of the section
type: string
is_section_followed: *is_section_followed
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:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- anicholson@mozilla.com
- chutten@mozilla.com
- mmccorquodale@mozilla.com
- najiang@mozilla.com
- lina@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
is_sponsored: *is_sponsored_pocket
format: *format
position: *pocket_position
recommendation_id: *recommendation_id
tile_id: *pocket_tile_id
scheduled_corpus_item_id: *scheduled_corpus_item_id
corpus_item_id: *corpus_item_id
received_rank: *received_rank
recommended_at: *recommended_at
topic:
description: The topic of the recommendation. Like "entertainment".
type: string
matches_selected_topic:
description: >
Returns value based on if a the topic of the pocket recommendation matches one
of the user-selected topic categories
type: string
selected_topics:
description: >
The list of topics the user selected
type: string
is_list_card:
description: >
Where the article card is in the list component
type: boolean
section:
description: >
If click belongs in a section, the name of the section
type: string
section_position:
description: >
If click belongs in a section, the numeric position of the section
type: string
is_section_followed: *is_section_followed
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:
data_reviews:
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
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:
data_reviews:
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
fetch_timestamp:
type: datetime
lifetime: ping
description: |
Timestamp of when the spoc was fetched by the client
bugs:
data_reviews:
notification_emails:
- dmueller@mozilla.com
expires: never
send_in_pings:
- spoc
newtab_creation_timestamp:
type: datetime
lifetime: ping
description: |
Timestamp of when this instance of the newtab was first visible to the user.
bugs:
data_reviews:
notification_emails:
- dmueller@mozilla.com
expires: never
send_in_pings:
- spoc
thumb_voting_interaction:
type: event
description: >
Recorded when a thumbs up/down on a tile is clicked.
Only happens on click. Not on middle-click. Not on "Open in new Tab"-like
options in the context menu.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
recommendation_id: *recommendation_id
tile_id: *pocket_tile_id
format: *format
thumbs_up:
description: >
If the user clicked thumbs up.
type: boolean
thumbs_down:
description: >
If the user clicked thumbs down.
type: boolean
scheduled_corpus_item_id: *scheduled_corpus_item_id
corpus_item_id: *corpus_item_id
received_rank: *received_rank
recommended_at: *recommended_at
topic:
description: The topic of the recommendation. Like "entertainment".
type: string
is_list_card:
description: >
Where the article card is in the list component
type: boolean
section:
description: >
If event belongs in a section, the name of the section
type: string
section_position:
description: >
If event belongs in a section, the numeric position of the section
type: string
is_section_followed: *is_section_followed
send_in_pings:
- newtab
newtab_content:
coarse_os:
type: string
description: >
The name of the operating system. Possible values:
Android, iOS, Linux, Windows, or macOS
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- nbarrett@mozilla.com
expires: never
lifetime: application
send_in_pings:
- newtab-content
coarse_os_version:
type: string
description: |
The user-visible version of the operating system (e.g. "1.2.3").
If the version detection fails, this metric gets set to 0.
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- nbarrett@mozilla.com
expires: never
lifetime: application
send_in_pings:
- newtab-content
utc_offset:
type: quantity
description: >
<0-24> positive UTC offset, rounded to the nearest integer number greater than 0.
(If less than 0, then add 24.)
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- nbarrett@mozilla.com
expires: never
send_in_pings:
- newtab-content
lifetime: application
unit: utc offset
surface_id:
type: string
description: >
Surface id sent to the client from merino api
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- nbarrett@mozilla.com
expires: never
send_in_pings:
- newtab-content
- newtab
lifetime: application
followed_sections:
type: string_list
description: >
Optional metric: section ids followed by user in alphabetical order, if possible,
ordered by most recently followed. Max 2 sections
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
expires: never
send_in_pings:
- newtab-content
lifetime: application
# The `newtab-content` ping does not include any info sections, and
# therefore needs to capture experiments and rollouts independently. This
# data layout agrees with the `nimbus-targeting-context` ping for ease of
# analysis.
active_experiments:
type: object
description: >
slugs of actively enrolled experiments
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
send_in_pings:
- newtab-content
expires: never
structure:
type: array
items:
type: string
active_rollouts:
type: object
description: >
slugs of actively enrolled rollouts
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
send_in_pings:
- newtab-content
expires: never
structure:
type: array
items:
type: string
enrollments_map:
type: object
description: >
Information about historic enrollments, including the branches enrolled.
bugs:
data_reviews:
expires: never
notification_emails:
- nbarrett@mozilla.com
send_in_pings:
- newtab-content
data_sensitivity:
- technical
structure:
type: array
items:
type: object
properties:
experimentSlug:
type: string
branchSlug:
type: string
impression:
type: event
description: >
Recorded when a pocket tile is visible to the user.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- anicholson@mozilla.com
- chutten@mozilla.com
- mmccorquodale@mozilla.com
- najiang@mozilla.com
- lina@mozilla.com
- sdowne@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
is_sponsored: *is_sponsored_pocket
format: *format
position: *pocket_position
recommendation_id: *recommendation_id
tile_id: *pocket_tile_id
scheduled_corpus_item_id: *scheduled_corpus_item_id
corpus_item_id: *corpus_item_id
received_rank: *received_rank
recommended_at: *recommended_at
topic:
description: The topic of the recommendation. Like "entertainment".
type: string
selected_topics:
description: >
The list of topics the user selected
type: string
is_list_card:
description: >
Where the article card is in the list component
type: boolean
section:
description: >
If click belongs in a section, the name of the section
type: string
section_position:
description: >
If click belongs in a section, the numberic position of the section
type: string
is_section_followed:
description: >
If click belongs in a section, if that section is followed
type: boolean
send_in_pings:
- newtab-content
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:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.cocm
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
is_sponsored: *is_sponsored_pocket
format: *format
position: *pocket_position
recommendation_id: *recommendation_id
tile_id: *pocket_tile_id
scheduled_corpus_item_id: *scheduled_corpus_item_id
corpus_item_id: *corpus_item_id
received_rank: *received_rank
recommended_at: *recommended_at
matches_selected_topic:
description: >
Returns value based on if a the topic of the pocket recommendation matches one
of the user-selected topic categories
type: string
topic:
description: The topic of the recommendation. Like "entertainment".
type: string
selected_topics:
description: >
The list of topics the user selected
type: string
is_list_card:
description: >
Where the article card is in the list component
type: boolean
section:
description: >
If click belongs in a section, the name of the section
type: string
section_position:
description: >
If click belongs in a section, the numberic position of the section
type: string
is_section_followed:
description: >
If click belongs in a section, if that section is followed
type: boolean
send_in_pings:
- newtab-content
dismiss:
type: event
description: >
Recorded when a pocket tile is dismissed.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- sdowne@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
is_sponsored: *is_sponsored_pocket
format: *format
position: *pocket_position
recommendation_id: *recommendation_id
tile_id: *pocket_tile_id
scheduled_corpus_item_id: *scheduled_corpus_item_id
corpus_item_id: *corpus_item_id
received_rank: *received_rank
recommended_at: *recommended_at
section:
description: >
If click belongs in a section, the name of the section
type: string
section_position:
description: >
If click belongs in a section, the numberic position of the section
type: string
is_section_followed:
description: >
If click belongs in a section, if that section is followed
type: boolean
send_in_pings:
- newtab-content
thumb_voting_interaction:
type: event
description: >
Recorded when a thumbs up/down on a tile is clicked.
Only happens on click. Not on middle-click. Not on "Open in new Tab"-like
options in the context menu.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
recommendation_id: *recommendation_id
tile_id: *pocket_tile_id
thumbs_up:
description: >
If the user clicked thumbs up.
type: boolean
thumbs_down:
description: >
If the user clicked thumbs down.
type: boolean
scheduled_corpus_item_id: *scheduled_corpus_item_id
corpus_item_id: *corpus_item_id
received_rank: *received_rank
recommended_at: *recommended_at
topic:
description: The topic of the recommendation. Like "entertainment".
type: string
is_list_card:
description: >
Where the article card is in the list component
type: boolean
section:
description: >
If event belongs in a section, the name of the section
type: string
section_position:
description: >
If event belongs in a section, the numberic position of the section
type: string
is_section_followed:
description: >
If event belongs in a section, if that section is followed
type: boolean
send_in_pings:
- newtab-content
sections_impression:
type: event
description: >
Recorded when a section is viewport and triggers an impression event
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- nbarrett@mozilla.com
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had impression event
type: string
section_position:
description: >
position of section on newtab
type: string
is_section_followed:
description: >
If click belongs in a section, if that section is followed
type: boolean
send_in_pings:
- newtab-content
sections_follow_section:
type: event
description: >
Recorded when a section is followed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had impression event
type: string
section_position:
description: >
position of section on newtab
type: string
event_source: *event_source
send_in_pings:
- newtab-content
sections_unfollow_section:
type: event
description: >
Recorded when a section is unfollowed
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had impression event
type: string
section_position:
description: >
position of section on newtab
type: string
event_source: *event_source
send_in_pings:
- newtab-content
sections_block_section:
type: event
description: >
Recorded when a section is blocked
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had impression event
type: string
section_position:
description: >
position of section on newtab
type: string
event_source: *event_source
send_in_pings:
- newtab-content
sections_unblock_section:
type: event
description: >
Recorded when a section is unblocked
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- mcrawford@mozilla.com
expires: never
extra_keys:
newtab_visit_id: *newtab_visit_id
section:
description: >
section that had unblock event
type: string
section_position:
description: >
position of section on newtab
type: string
event_source: *event_source
send_in_pings:
- newtab-content
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
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:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- najiang@mozilla.com
expires: never
send_in_pings:
- top-sites
activity_stream:
end_session:
type: event
description: >
This is recorded with every session ended in Activity Stream.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.end#session.
bugs:
data_reviews:
notification_emails:
- najiang@mozilla.com
- msamuel@mozilla.com
expires: never
extra_keys:
value:
description: >
The session duration. Mirrors to the Legacy Telemetry
event's `value` parameter.
type: quantity
addon_version:
description: >
The Activity Stream addon version.
type: string
session_id:
description: >
The ID of the Activity Stream session in which the event occurred
type: string
page:
description: >
about:home or about_newtab - the page where the event occurred
type: string
user_prefs:
description: >
An integer representaing a user's A-S settings.
type: quantity
telemetry_mirror: Activity_stream_End_Session
event_archive_from_pocket:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#ARCHIVE_FROM_POCKET.
bugs: &activity_stream_event_bugs
data_reviews: &activity_stream_event_data_reviews
notification_emails: &activity_stream_event_emails
- najiang@mozilla.com
- msamuel@mozilla.com
- rrosario@mozilla.com
expires: never
extra_keys: &activity_stream_event_extra
value:
description: >
The `value` of the event. Mirrors to the Legacy Telemetry
event's `value` parameter.
type: string
addon_version:
description: >
The Activity Stream addon version.
type: string
session_id:
description: >
The ID of the Activity Stream session in which the event occurred
type: string
page:
description: >
about:home or about_newtab - the page where the event occurred
type: string
user_prefs:
description: >
An integer representaing a user's A-S settings.
type: quantity
action_position:
description: >
The index of card receiving interactions.
type: quantity
telemetry_mirror: Activity_stream_Event_ArchiveFromPocket
event_block:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#BLOCK.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Block
event_bookmark_add:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#BOOKMARK_ADD.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_BookmarkAdd
event_bookmark_delete:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#BOOKMARK_DELETE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_BookmarkDelete
event_click:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#CLICK.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Click
event_click_privacy_info:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#CLICK_PRIVACY_INFO.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_ClickPrivacyInfo
event_close_newtab_prefs:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#CLOSE_NEWTAB_PREFS.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_CloseNewtabPrefs
event_show_personalize:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SHOW_PERSONALIZE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_ShowPersonalize
event_hide_personalize:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#HIDE_PERSONALIZE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_HidePersonalize
event_delete:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#DELETE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Delete
event_delete_from_pocket:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#DELETE_FROM_POCKET.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_DeleteFromPocket
event_delete_confirm:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#DELETE_CONFIRM.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_DeleteConfirm
event_dialog_cancel:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#DIALOG_CANCEL.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_DialogCancel
event_dialog_open:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#DIALOG_OPEN.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_DialogOpen
event_drag:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#DRAG.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Drag
event_drop:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#DROP.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Drop
event_impression:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#IMPRESSION.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Impression
event_migration_cancel:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MIGRATION_CANCEL.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MigrationCancel
event_migration_start:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MIGRATION_START.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MigrationStart
event_open_newtab_prefs:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#OPEN_NEWTAB_PREFS.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_OpenNewtabPrefs
event_open_new_window:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#OPEN_NEW_WINDOW.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_OpenNewWindow
event_open_private_window:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#OPEN_PRIVATE_WINDOW.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_OpenPrivateWindow
event_pin:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#PIN.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Pin
event_pocket_thumbs_down:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#POCKET_THUMBS_DOWN.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_PocketThumbsDown
event_pocket_thumbs_up:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#POCKET_THUMBS_UP.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_PocketThumbsUp
event_fakespot_click:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#FAKESPOT_CLICK.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_FakespotClick
event_fakespot_category:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#FAKESPOT_CATEGORY.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_FakespotCategory
event_pref_changed:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#PREF_CHANGED.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_PrefChanged
event_preview_request:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#PREVIEW_REQUEST.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_PreviewRequest
event_save_to_pocket:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SAVE_TO_POCKET.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_SaveToPocket
event_search:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SEARCH.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Search
event_search_edit_add:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SEARCH_EDIT_ADD.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_SearchEditAdd
event_search_edit_close:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SEARCH_EDIT_CLOSE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_SearchEditClose
event_search_edit_delete:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SEARCH_EDIT_DELETE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_SearchEditDelete
event_search_handoff:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SEARCH_HANDOFF.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_SearchHandoff
event_show_privacy_info:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SHOW_PRIVACY_INFO.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_ShowPrivacyInfo
event_skipped_signin:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SKIPPED_SIGNIN.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_SkippedSignin
event_submit_email:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#SUBMIT_EMAIL.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_SubmitEmail
event_disclaimer_acked:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#DISCLAIMER_ACKED.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_DisclaimerAcked
event_menu_add_search:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_ADD_SEARCH.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuAddSearch
event_menu_add_topsite:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_ADD_TOPSITE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuAddTopsite
event_menu_collapse:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_COLLAPSE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuCollapse
event_menu_expand:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_EXPAND.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuExpand
event_menu_manage:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_MANAGE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuManage
event_menu_move_down:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_MOVE_DOWN.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuMoveDown
event_menu_move_up:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_MOVE_UP.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuMoveUp
event_menu_privacy_notice:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_PRIVACY_NOTICE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuPrivacyNotice
event_menu_remove:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#MENU_REMOVE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_MenuRemove
event_top_sites_edit:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#TOP_SITES_EDIT.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_TopSitesEdit
event_top_sites_edit_close:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#TOP_SITES_EDIT_CLOSE.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_TopSitesEditClose
event_topsite_sponsor_info:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#TOPSITE_SPONSOR_INFO.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_TopsiteSponsorInfo
event_unpin:
type: event
description: >
This is recorded with every user interaction on Activity Stream
elements.
This event was generated to correspond to the Legacy Telemetry event
activity_stream.event#UNPIN.
bugs: *activity_stream_event_bugs
data_reviews: *activity_stream_event_data_reviews
notification_emails: *activity_stream_event_emails
expires: never
extra_keys: *activity_stream_event_extra
telemetry_mirror: Activity_stream_Event_Unpin
deletion.request:
impression_id:
type: string
description: >
An identifier used by user interaction pings in Pocket/newtab and
Messaging System.
This metric was generated to correspond to the Legacy Telemetry
scalar deletion.request.impression_id.
bugs:
data_reviews:
notification_emails:
- najiang@mozilla.com
expires: never
send_in_pings: ["deletion-request"]
telemetry_mirror: DELETION_REQUEST_IMPRESSION_ID
context_id:
type: string
description: >
An identifier to identify users for Contextual Services user
interaction pings.
This metric was generated to correspond to the Legacy Telemetry
scalar deletion.request.context_id.
bugs:
data_reviews:
notification_emails:
- najiang@mozilla.com
expires: never
send_in_pings: ["deletion-request"]
telemetry_mirror: DELETION_REQUEST_CONTEXT_ID
contextual.services.topsites:
impression:
type: labeled_counter
description: >
A keyed uint recording how many times the user has viewed the
sponsored TopSites on the newtab page. The key is a combination of
the source and the placement of the TopSites tile (1-based). such as
'urlbar_1', 'newtab_2'.
This metric was generated to correspond to the Legacy Telemetry
scalar contextual.services.topsites.impression.
bugs:
data_reviews:
notification_emails:
- najiang@mozilla.com
expires: never
telemetry_mirror: CONTEXTUAL_SERVICES_TOPSITES_IMPRESSION
click:
type: labeled_counter
description: >
A keyed uint recording how many times the user has clicked on the
sponsored TopSites on the newtab page. The key is a combination of
the source and the placement of the TopSites tile (1-based). such as
'urlbar_1', 'newtab_2'.
This metric was generated to correspond to the Legacy Telemetry
scalar contextual.services.topsites.click.
bugs:
data_reviews:
notification_emails:
- najiang@mozilla.com
expires: never
telemetry_mirror: CONTEXTUAL_SERVICES_TOPSITES_CLICK