Firefox desktop

Pre-defined metrics for firefox_desktop that can be used across all experiments. These metrics are defined in jetstream-config

active_hours

Active hours

Measures the amount of time (in 5-second increments) during which Firefox received user input from a keyboard or mouse. The Firefox window does not need to be focused.

Data Source: clients_daily

Definition:

{{agg_sum("active_hours_sum")}}

---

uri_count

URIs visited

Counts the total number of URIs visited. Includes within-page navigation events (e.g. to anchors).

Data Source: clients_daily

Definition:

{{agg_sum("scalar_parent_browser_engagement_total_uri_count_sum")}}

---

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: search_clients_engines_sources_daily

Definition:

{{agg_sum("sap")}}

---

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: 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: search_clients_engines_sources_daily

Definition:

{{agg_sum("tagged_follow_on")}}

---

ad_clicks

Ad clicks

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

Data Source: search_clients_engines_sources_daily

Definition:

{{agg_sum("ad_click")}}

---

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: search_clients_engines_sources_daily

Definition:

{{agg_sum("search_with_ads")}}

---

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: search_clients_engines_sources_daily

Definition:

{{agg_sum("organic")}}

---

unenroll

Unenrollments

Counts the number of clients with an experiment unenrollment event.

Data Source: normandy_events

Definition:

{{agg_any(
     """        event_category = 'normandy'
        AND event_method = 'unenroll'
        AND event_string_value = '{experiment_slug}'
     """)}}

---

view_about_logins

about:logins viewers

Counts the number of clients that viewed about:logins.

Data Source: events

Definition:

{{agg_any(
     """            event_method = 'open_management'
            AND event_category = 'pwmgr'
         """)}}

---

view_about_protections

about:protections viewers

Counts the number of clients that viewed about:protections.

Data Source: events

Definition:

{{agg_any(
     """            event_method = 'show'
            AND event_object = 'protection_report'
         """)}}

---

connect_fxa

Connected FxA

Counts the number of clients that took action to connect to FxA. This does not include clients that were already connected to FxA at the start of the experiment and remained connected.

Data Source: events

Definition:

{{agg_any(
     """            event_method = 'connect'
            AND event_object = 'account'
         """)}}

---

pocket_rec_clicks

Clicked Pocket organic recs in New Tab

Counts the number of Pocket rec clicks made by each client.

Data Source: activity_stream_events

Definition:

COUNTIF(
    event = 'CLICK'
    AND source = 'CARDGRID'
    AND JSON_EXTRACT_SCALAR(value, '$.card_type') = 'organic'
)

---

pocket_spoc_clicks

Clicked Pocket sponsored content in New Tab

Counts the number of Pocket sponsored content clicks made by each client.

Data Source: activity_stream_events

Definition:

COUNTIF(
    event = 'CLICK'
    AND source = 'CARDGRID'
    AND JSON_EXTRACT_SCALAR(value, '$.card_type') = 'spoc'
)

---

days_of_use

Days of use

The number of days in the interval that each client sent a main ping.

Data Source: clients_daily

Definition:

COUNT(ds.submission_date)

---

qualified_cumulative_days_of_use

QCDOU

The number of days in the interval that each client sent a main ping, given that the client had >0 active hours and >0 URIs loaded.

Data Source: clients_daily

Definition:

COUNTIF(
    active_hours_sum > 0 AND
    scalar_parent_browser_engagement_total_uri_count_normal_and_private_mode_sum > 0
)

---

disable_pocket_clicks

Disabled Pocket in New Tab

Counts the number of clicks to disable Pocket in New Tab made by each client.

Data Source: activity_stream_events

Definition:

COUNTIF(
    event = 'PREF_CHANGED'
    AND source = 'TOP_STORIES'
    AND JSON_EXTRACT_SCALAR(value, '$.status') = 'false'
)

---

disable_pocket_spocs_clicks

Disabled Pocket sponsored content in New Tab

Counts the number of clicks to disable Pocket sponsored content in New Tab made by each client.

Data Source: activity_stream_events

Definition:

COUNTIF(
    event = 'PREF_CHANGED'
    AND source = 'POCKET_SPOCS'
    AND JSON_EXTRACT_SCALAR(value, '$.status') = 'false'
)

---