Google Analytics (分析) 4 DAG

總覽

本頁面會說明如何設定 tcrm_bq_to_ga4 或 tcrm_gcs_to_ga4 DAG，以及如何準備資料。

Google Analytics (分析) 4 (舊稱「應用程式 + 網站」) 是一種新的資源，其報表與您在通用 Analytics (分析) 資源中看到的報表不同。Google Analytics (分析) 4 資源的優點之一就是可用於網站和/或應用程式，通用 Analytics (分析) 資源只支援網站。詳情請參閱公告內容。

詳情請參閱認識新一代的 Google Analytics (分析)

設定 Airflow 變數

建立新的必要 tcrm_bq_to_ga4 DAG 變數

下表說明執行 tcrm_bq_to_ga4 DAG 所需的變數。只有在您打算使用 BigQuery 做為資料來源時，才需要設定這些變數。

變數名稱 預設值 變數資訊
bq_dataset_id my_dataset 包含資料的 BigQuery 資料集名稱。
bq_table_id my_table 包含資料的 BigQuery 資料表名稱。
api_secret Google Analytics (分析) 4 API 密鑰，請參閱「查詢參數」一節，進一步瞭解如何建立 API 密鑰
payload_type 從 gtag 或 firebase 中選擇
measurement_id 如果payload_type為gtag，則為必填屬性
firebase_app_id 如果payload_type為firebase，則為必填屬性

建立新的必要 tcrm_gcs_to_ga4 DAG 變數

下表說明執行 tcrm_gcs_to_ga4 DAG 所需的變數。只有在打算使用 Google Cloud Storage 做為資料來源時，才需要設定這些變數。

變數名稱 範例值 變數資訊
gcs_bucket_name my_bucket Cloud Storage 值區名稱。
gcs_bucket_prefix folder/sub_folder 值區中資料資料夾的路徑。
gcs_content_type JSON Cloud Storage 內容類型。
api_secret Google Analytics (分析) 4 API 密鑰，請參閱「查詢參數」一節，進一步瞭解如何建立 API 密鑰
payload_type gtag 從 gtag 或 firebase 中選擇
measurement_id 如果payload_type為gtag，則為必填屬性
firebase_app_id 如果payload_type為firebase，則為必填屬性

準備要傳送至 Google Analytics (分析) 4 的資料

注意：如需詳細規定，請參閱 Measurement Protocol 4 API{target="_blank"}。

如要將資料傳送至 GA4，您可以從下列 2 個選項中選擇，範例是以 login 事件為基礎：

  1. 透過 BigQuery 使用 SQL 資料表格式的 tcrm_bq_to_ga4 DAG。

    id payload
    1 {"client_id":1,"events":[{"name":"login" "params":{"method": "Google"}}]} }

  2. 透過 Google Cloud Storage 使用 JSON 格式的 tcrm_gcs_to_ga4 DAG。

    {"id": 1, "payload":{"client_id":1,"events":[{"name":"login", "params":{"method": "Google"}}]} }

執行 DAG

在 Airflow 主控台中，按一下頂端選單列中的 DAGs 選項。在左側清單中，找到您要執行的 DAG。然後按一下清單右側的 Play 按鈕，以執行它。

讀取 DAG 的記錄

請參閱常見問題中的閱讀 DAG 記錄。