chore(metadata-completeness): Add descriptions to tables & views

sql/moz-fx-data-shared-prod/firefox_desktop/adclick_history/metadata.yaml

@@ -0,0 +1,8 @@
+friendly_name: Adclick History
+description: |-
+  Contains the number of ad-clicks per day for each Firefox Desktop client.
+  Primary key: client_id.
+owners:
+- [email protected]
+labels:
+  owner1: kwindau

sql/moz-fx-data-shared-prod/firefox_desktop/baseline_active_users/metadata.yaml

@@ -1 +1,7 @@
 friendly_name: Firefox Desktop Baseline Active Users
+description: |-
+  Contains 1 row for every client ID that has sent a baseline ping
+  in the last 28 days, with information from when they were last seen.
+  Also contains information from the client's first seen date,
+  like attribution information.
+  Primary Key: Client ID & Submission Date

sql/moz-fx-data-shared-prod/firefox_desktop/baseline_active_users_aggregates/metadata.yaml

@@ -0,0 +1,11 @@
+friendly_name: Baseline Active Users Aggregates
+description: |-
+  Aggregated information about daily, weekly, and monthly browser usage,
+  aggregated by date, country, OS,channel, etc.
+  Calculated from the Glean baseline ping.
+owners:
+- [email protected]
+- [email protected]
+labels:
+  owner1: kwindau
+  owner2: kik

sql/moz-fx-data-shared-prod/firefox_desktop/desktop_engagement_aggregates/metadata.yaml

@@ -0,0 +1,8 @@
+friendly_name: Desktop Engagement Aggregates
+description: |-
+  Contains aggregated DAU, WAU, and MAU by different attributes for engagement ratio calculation.
+owners:
+- [email protected]
+labels:
+  owner: kwindau
+require_column_descriptions: false

sql/moz-fx-data-shared-prod/firefox_desktop/desktop_engagement_clients/metadata.yaml

@@ -0,0 +1,9 @@
+friendly_name: Desktop Engagement - Client Level
+description: |-
+  Desktop engagement data at the client level, including attribution information
+  Primary Key: Submission Date + Client ID
+owners:
+- [email protected]
+labels:
+  owner: kwindau
+require_column_descriptions: false

sql/moz-fx-data-shared-prod/firefox_desktop/desktop_installs/metadata.yaml

@@ -0,0 +1,8 @@
+friendly_name: Desktop Installs
+description: |-
+  This view contains information about Firefox desktop installs, to help track the acquisition funnel.
+owners:
+- [email protected]
+labels:
+  owner: kwindau
+require_column_descriptions: false

sql/moz-fx-data-shared-prod/firefox_desktop/desktop_retention_aggregates/metadata.yaml

@@ -0,0 +1,9 @@
+friendly_name: Desktop Retention Aggregates
+description: |-
+  Calculates user retention 4 weeks after first seen date, by app version,
+  attribution information, channel, country, and more.
+owners:
+- [email protected]
+labels:
+  owner: kwindau
+require_column_descriptions: false

sql/moz-fx-data-shared-prod/firefox_desktop/desktop_retention_clients/metadata.yaml

@@ -0,0 +1,13 @@
+friendly_name: Firefox Desktop Retention Clients
+description: |-
+  Measures 28-day (week-4) retention for Firefox Desktop clients anchored on a cohort “metric date.”
+  Metric date represents the cohort of clients who were either:
+  A) New on the metric date (first_seen_date = metric_date), or
+  B) Seen on the metric date (sent a baseline ping that day).
+  Submission date represents the date 27 days after the metric date (end of the 28-day window), when week-4 retention is evaluated.
+  Primary Key: Client ID + Metric Date
+owners:
+- [email protected]
+labels:
+  owner: kwindau
+require_column_descriptions: false

sql/moz-fx-data-shared-prod/firefox_desktop/fx_health_ind_antivirus/metadata.yaml

@@ -0,0 +1,7 @@
+friendly_name: Firefox Health Indicator - Antivirus Usage Trends
+description: |-
+  Aggregate table showing antivirus software usage by OS
+owners:
+- [email protected]
+labels:
+  owner1: kwindau

sql/moz-fx-data-shared-prod/firefox_desktop/fx_health_ind_bookmarks_by_country/metadata.yaml

@@ -0,0 +1,9 @@
+friendly_name: Firefox Health Indicator - Bookmarks By Country
+description: |-
+  Aggregate table of bookmarks added per client per day per country.
+  Primary Key:
+  - Submission Date + Normalized Country Code
+owners:
+- [email protected]
+labels:
+  owner1: kwindau

sql/moz-fx-data-shared-prod/firefox_desktop/ltv_states/metadata.yaml

@@ -0,0 +1,7 @@
+friendly_name: Firefox Desktop LTV States
+description: |-
+  Fields required for calculating LTV for Firefox Desktop clients
+owners:
+- [email protected]
+labels:
+  owner1: kwindau

sql/moz-fx-data-shared-prod/firefox_desktop_derived/baseline_active_users_aggregates_v2/metadata.yaml

@@ -3,7 +3,6 @@ description: |-
   Builds active_users_aggregates using the baseline ping.
 owners:
 - [email protected]
-- [email protected]
 labels:
   incremental: true
   table_type: aggregate

sql/moz-fx-data-shared-prod/firefox_desktop_derived/desktop_retention_clients_v1/metadata.yaml

@@ -1,6 +1,11 @@
 friendly_name: Desktop Retention Clients
 description: |-
-  Measures retention of new clients over time
+  Measures 28-day (week-4) retention for Firefox Desktop clients anchored on a cohort “metric date.”
+  Metric date represents the cohort of clients who were either:
+  A) New on the metric date (first_seen_date = metric_date), or
+  B) Seen on the metric date (sent a baseline ping that day).
+  Submission date represents the date 27 days after the metric date (end of the 28-day window), when week-4 retention is evaluated.
+  Primary Key: Client ID + Metric Date
 owners:
 - [email protected]
 labels: