Focus ios

metric-hub

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

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)

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

Focus iOS 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 Focus iOS. 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: focus_ios_active_users_aggregates_view

Definition:

SUM(dau)

client_level_daily_active_users_v1

Focus iOS 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

Focus iOS 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. 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

Focus iOS 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: focus_ios_active_users_view

Definition:

COUNTIF(is_dau)

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')}}

ad_clicks_organic

Ad Clicks through organic traffic

Counts clicks on ads on search engine result pages that are not tagged with an eligible Mozilla partner code.

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 search count

Number of searches performed through a Search Access Point.

Data Source: mobile_search_clients_engines_sources_daily

Definition:

{{agg_sum('search_count')}}

search_count_imputed

SAP search count (legacy to glean conversion)

Imputed SAP for converting historical search counts from legacy to glean

Data Source: mobile_search_clients_engines_sources_daily

Definition:

ROUND(SUM(IF((submission_date >= '2023-01-01') AND (browser_version_info.major_version < 111), search_count - search_count * 0.4, search_count)))

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_search_count

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')}}

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')}}

searches_with_ads

Search result pages with ads (a.k.a. Ad Impressions) both tagged and organic

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")}}

engagement_rate_v1

Focus iOS 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: focus_ios_engagement_view

Definition:

SUM(dau) / SUM(mau)

retention_rate_v1

Focus iOS 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: focus_ios_retention_view

Definition:

SUM(retained_week_4) / SUM(active_metric_date)

new_profile_retention_rate_v1

Focus iOS 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: focus_ios_retention_view

Definition:

SUM(retained_week_4_new_profiles) / SUM(new_profiles_metric_date)