Skip to content

Fenix

metric-hub

Pre-defined metrics for fenix. These metrics are defined in metric-hub

uri_count

URIs visited

Counts the number of URIs each client visited

Data Source: baseline

Definition:
{{agg_sum("metrics.counter.events_normal_and_private_uri_count")}}

active_hours

Active Hours

Total time Firefox was active

Data Source: baseline

Definition:
COALESCE(SUM(metrics.timespan.glean_baseline_duration.value), 0) / 3600.0

days_of_use

Days of use

The number of days in an observation window that clients used the browser.

Data Source: baseline

Definition:
COUNT(DISTINCT DATE(submission_timestamp))

daily_active_users

DAU

The number of unique clients that we received a baseline ping from each day, excluding pings originating from BrowserStack. To be comparable to DAU used for KPI tracking, this metric needs to be aggregated by submission_date. If the metric is NOT aggregated by submission_date, the metric is similar to a "days of use" metric. For more details, refer to the DAU description in the Mozilla Data Documentation.

For questions, please contact bochocki@mozilla.com or firefox-kpi@mozilla.com.

Data Source: baseline_v2

Definition:
COUNT(DISTINCT CASE WHEN LOWER(metadata.isp.name) != 'browserstack' THEN client_info.client_id ELSE NULL END)

daily_active_users_v2

Fenix DAU

This is the official DAU reporting definition. The logic is detailed on the Confluence DAU page and is automatically cross-checked, actively monitored, and change controlled. Whenever possible, this is the preferred DAU reporting definition to use for Fenix. This metric needs to be aggregated by submission_date. If it is not aggregated by submission_date, it is similar to a "days of use" metric, and not DAU.

For more information, refer to [the DAU description in Confluence](https://mozilla-hub.atlassian.net/wiki/spaces/DATA/pages/314704478/Daily+Active+Users+DAU+Metric).
For questions please contact bochocki@mozilla.com or firefox-kpi@mozilla.com.

Data Source: fenix_active_users_aggregates_view

Definition:
SUM(dau)

client_level_daily_active_users_v1

Fenix Client-Level DAU

This metric reports DAU values similar (but not necessarily identical) to the official DAU reporting definition. It's generally preferable to use the official DAU reporting definition when possible; this metric exists only for cases where reporting client_id is required (e.g. for experiments). This metric needs to be aggregated by submission_date. If it is not aggregated by submission_date, it is similar to a "days of use" metric, and not DAU.

For more information, refer to [the DAU description in Confluence](https://mozilla-hub.atlassian.net/wiki/spaces/DATA/pages/314704478/Daily+Active+Users+DAU+Metric).
For questions please contact bochocki@mozilla.com or firefox-kpi@mozilla.com.

Data Source: baseline_v2

Definition:
COUNT(DISTINCT CASE WHEN LOWER(metadata.isp.name) != 'browserstack' THEN client_info.client_id ELSE NULL END)

client_level_daily_active_users_v2

Fenix Client-Level DAU

This metric reports DAU values similar (but not necessarily identical) to the official DAU reporting definition. It's generally preferable to use the official DAU reporting definition when possible; this metric exists only for cases where reporting client_id is required (e.g. for experiments). This metric needs to be aggregated by submission_date. If it is not aggregated by submission_date, it is similar to a "days of use" metric, and not DAU.

For more information, refer to [the DAU description in Confluence](https://mozilla-hub.atlassian.net/wiki/spaces/DATA/pages/314704478/Daily+Active+Users+DAU+Metric).
For questions please contact bochocki@mozilla.com or firefox-kpi@mozilla.com.

Data Source: baseline_v2

Definition:
COUNT(DISTINCT CASE WHEN metrics.timespan.glean_baseline_duration.value > 0
                         AND LOWER(metadata.isp.name) != 'browserstack'
                        THEN client_info.client_id
                        ELSE NULL END)

client_level_daily_active_users_v3

Fenix Client-Level DAU

Client-level DAU. The logic is detailed on the Confluence DAU page and is automatically cross-checked, actively monitored, and change controlled. This metric needs to be aggregated by submission_date. If it is not aggregated by submission_date, it is similar to a "days of use" metric, and not DAU.

Data Source: fenix_active_users_view

Definition:
COUNTIF(is_dau)

user_reports_site_issue_count

Site issues reported

Counts the number of times clients reported an issue with a site.

Data Source: events

Definition:
COUNTIF(event.name = 'browser_menu_action' AND
    mozfun.map.get_key(event.extra, 'item') = 'report_site_issue')

user_reload_count

Pages reloaded

Counts the number of times a client reloaded a page.

Data Source: events

Definition:
COUNTIF(event.name = 'browser_menu_action' AND
    mozfun.map.get_key(event.extra, 'item') = 'reload')

baseline_ping_count

Baseline pings

Counts the number of baseline pings received from each client.

Data Source: baseline

Definition:
COUNT(document_id)

metric_ping_count

Metrics pings

Counts the number of metrics pings received from each client.

Data Source: metrics

Definition:
COUNT(document_id)

first_run_date

First run date

The earliest first-run date reported by each client.

Data Source: baseline

Definition:
MIN(client_info.first_run_date)

performance_pageload_load_time

Pageload Load Time

Time in milliseconds from navigationStart to loadEventStart for the foreground http or https root content document.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.performance_pageload_load_time IGNORE NULLS)

performance_pageload_load_time_responsestart

Pageload Load Time Response Start

Time in milliseconds from responseStart to loadEventStart for the foreground http or https root content document.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.performance_pageload_load_time_responsestart IGNORE NULLS)

performance_page_non_blank_paint

Page Non Blank Paint

The time between navigationStart and the first non-blank paint of a foreground root content document, in milliseconds.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.performance_page_non_blank_paint IGNORE NULLS)

performance_pageload_req_anim_frame_callback

Pageload Load Req Animation Frame Callback

Time spent in milliseconds calling all request animation frame callbacks for a document before it has reached readystate complete.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.performance_pageload_req_anim_frame_callback IGNORE NULLS)

performance_pageload_dcl

Pageload DCL

Time in milliseconds from navigationStart to domContentLoaded for the foreground http or https root content document.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.performance_pageload_dcl IGNORE NULLS)

performance_pageload_dcl_responsestart

Pageload DCL Response Start

Time in milliseconds from responseStart to domContentLoaded for the foreground http or https root content document.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.performance_pageload_dcl_responsestart IGNORE NULLS)

performance_pageload_fcp

Pageload FCP

The time between navigationStart and the first contentful paint of a foreground http or https root content document, in milliseconds. The contentful paint timestamp is taken during display list building and does not include rasterization or compositing of that paint.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.performance_pageload_fcp IGNORE NULLS)

performance_pageload_fcp_responsestart

Pageload FCP Response Start

The time between responseStart and the first contentful paint of a foreground http or https root content document, in milliseconds. The contentful paint timestamp is taken during display list building and does not include rasterization or compositing of that paint.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.performance_pageload_fcp_responsestart IGNORE NULLS)

perf_startup_cold_main_app_to_first_frame

Startup Cold Main App to First Frame

The duration from *Application's initializer to the first Android frame being drawn in a COLD MAIN start up.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.perf_startup_cold_main_app_to_first_frame IGNORE NULLS)

perf_startup_cold_view_app_to_first_frame

Startup Cold View App to First Frame

The duration from *Application's initializer to the first Android frame being drawn in a COLD VIEW start up.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.timing_distribution.perf_startup_cold_view_app_to_first_frame IGNORE NULLS)

storage_stats_app_bytes

App Byte Size

The size of the app's APK and related files as installed: this is expected to be larger than download size.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.memory_distribution.storage_stats_app_bytes IGNORE NULLS)

storage_stats_cache_bytes

Cache Byte Size

The size of all cached data in the app.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.memory_distribution.storage_stats_cache_bytes IGNORE NULLS)

storage_stats_data_dir_bytes

Data Dir Byte Size

The size of all data minus cache_bytes.

Data Source: metrics

Definition:
ARRAY_AGG(metrics.memory_distribution.storage_stats_data_dir_bytes IGNORE NULLS)

tagged_sap_searches

Tagged SAP Searches

Total number of tagged SAP searches. This metric is deprecated, use tagged_search_count instead

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('tagged_sap')}}

organic_search_count

Organic searches

Counts organic searches, which are searches that are not performed through a Firefox SAP and which are not monetizable. Learn more in the search data documentation.

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('organic')}}

ad_click_organic

Organic Ad Click Count

Total number of Organic Ad Click Counts

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('ad_click_organic')}}

searches_with_ads_organic

Organic Search With Ads Count

Total number of Organic Search With Ads Counts

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('search_with_ads_organic')}}

search_count

SAP searches

Counts the number of searches a user performed through Firefox's Search Access Points. Learn more in the search data documentation.

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('search_count')}}

searches_with_ads

Search result pages with ads

Counts search result pages served with advertising. Users may not actually see these ads thanks to e.g. ad-blockers. Learn more in the search analysis documentation.

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('search_with_ads')}}

ad_clicks

Ad clicks

Counts clicks on ads on search engine result pages with a Mozilla partner tag.

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('ad_click')}}

tagged_search_count

Tagged SAP searches

Counts the number of searches a user performed through Firefox's Search Access Points that were submitted with a partner code and were potentially revenue-generating. Learn more in the search data documentation.

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('tagged_sap')}}

tagged_follow_on

Tagged follow-on searches

Counts the number of follow-on searches with a Mozilla partner tag. These are additional searches that users performed from a search engine results page after executing a tagged search through a SAP. Learn more in the search data documentation.

Data Source: mobile_search_clients_engines_sources_daily

Definition:
{{agg_sum('tagged_follow_on')}}

spoc_tiles_impressions

Sponsored Tiles Impressions

Number of times Contile Sponsored Tiles are shown.

Data Source: events

Definition:
COALESCE(COUNTIF(
          event.category = 'top_sites'
          AND event.name = 'contile_impression'
      ),0)

spoc_tiles_clicks

Sponsored Tiles Clicks

Number of times user clicked a Contile Sponsored Tile.

Data Source: events

Definition:
COALESCE(COUNTIF(
          event.category = 'top_sites'
          AND event.name = 'contile_click'
      ),0)

spoc_tiles_disable_rate

Sponsored Tiles Disable Rate

Fraction of users who disable Contile Sponsored Tiles

Data Source: metrics

Definition:
COALESCE(MAX(
    CAST(
       metrics.boolean.customize_home_contile AS int )
  ),0)

spoc_tiles_preference_toggled

Sponsored Tiles Preference Toggled

Number of times Contile Sponsored Tiles setting is flipped.

Data Source: events

Definition:
COALESCE(SUM(CASE WHEN
          event.category = 'customize_home'
          AND event.name = 'preference_toggled'
          AND `mozfun.map.get_key`(event.extra, 'preference_key') = 'contile'
    THEN 1 ELSE 0 END
  ),0)

new_profile_activation

New Profile Activation

A new profile is counted as activated one week after creation if it meets the following conditions: 1) at least 3 days of use during first week 2) at least one search between days 4-7.

Data Source: new_profile_activation

Definition:
COALESCE(SUM(activated))

fxa_sign_in

Firefox Accounts Signed In

Whether a user was signed into FxA at any point in the period

Data Source: metrics

Definition:
MAX(IF(metrics.boolean.preferences_signed_in_sync, 1, 0))

turn_on_notifications_ctr_onboarding

Turn on Notification Click

This metric looks at proportion of all new profiles that were exposed to the turn on notification card and clicked the action during on-boarding.

Data Source: special_onboarding_events

Definition:
COALESCE(SUM(turn_on_notifications_flag))

set_to_default_ctr_onboarding

Set to Default Click

This metric looks at proportion of all new profiles that were exposed to the set to default card and clicked the action during on-boarding.

Data Source: special_onboarding_events

Definition:
COALESCE(SUM(set_to_default_flag))

sign_in_ctr_onboarding

Sign in Click

This metric looks at proportion of all new profiles that were exposed to the sign-in card and clicked the action during on-boarding.

Data Source: special_onboarding_events

Definition:
COALESCE(SUM(sign_in_flag))

at_least_1_cta_ctr_onboarding

Clicked at least one CTA

This metric looks at proportion of all new profiles that were exposed to onboarding cards and clicked at least one action during on-boarding.

Data Source: special_onboarding_events

Definition:
COALESCE(SUM(at_least_1_cta))

bookmarks_add_v1

Added Bookmarks

Number of Added Bookmarks

Data Source: feature_usage_metrics_v1

Definition:
SUM(bookmarks_add)

bookmarks_delete_v1

Deleted Bookmarks

Number of Deleted Bookmarks

Data Source: feature_usage_metrics_v1

Definition:
SUM(bookmarks_delete)

bookmarks_add_users_v1

Added Bookmarks Users

Number of Users that Added Bookmarks

Data Source: feature_usage_metrics_v1

Definition:
SUM(bookmarks_add_users)

bookmarks_delete_users_v1

Deleted Bookmarks Users

Number of Users that Deleted Bookmarks

Data Source: feature_usage_metrics_v1

Definition:
SUM(bookmarks_delete_users)

engagement_rate_v1

Fenix Engagement Rate

The Engagement Rate is calculated as the ratio between DAU and MAU. For each day, we use the single-day DAU number and divide it by the MAU corresponding to the 28-day period ending on that day. For OKR reporting, we then calculate a 28-day moving average of this number. More information is provided on the New Profiles, Retention and Engagement Rate Confluence Page.

Data Source: fenix_engagement_view

Definition:
SUM(dau) / SUM(mau)

retention_rate_v1

Fenix Retention Rate

The Retention Rate is calculated as the proportion of clients that are active on the 4th week after the metric date.

Data Source: fenix_retention_view

Definition:
SUM(retained_week_4) / SUM(active_metric_date)

new_profile_retention_rate_v1

Fenix New Proflie Retention Rate

The New Profile Retention Rate is calculated as the proportion of new profiles that are active on the 4th week after the metric date. More information is provided on the New Profiles, Retention and Engagement Rate Confluence Page.

Data Source: fenix_retention_view

Definition:
SUM(retained_week_4_new_profiles) / SUM(new_profiles_metric_date)