[GA4] BigQuery Export 架構

本文將說明 Google Analytics 4 資源資料和 Google Analytics for Firebase 資料匯出至 BigQuery 時所使用的格式和架構。

資料集

針對每一個連至 BigQuery 的 Google Analytics 4 資源和 Firebase 專案,系統會分別在 BigQuery 專案中加入一個名為「analytics_<property_id>」的資料集。資源 ID 是指 Analytics 資源 ID,可在 Google Analytics 4 資源的資源設定以及 Firebase 的應用程式數據分析設定中找到。每個已啟用 BigQuery 匯出功能的 Google Analytics 4 資源和應用程式,都會將自身資料匯出至該單一資料集。

表格

如果啟用「每日匯出」選項,每個資料集內每天都會建立一個名為 events_YYYYMMDD 的資料表。

若啟用「串流匯出」選項,系統會建立名稱格式為 events_intraday_YYYYMMDD 的資料表,系統一整天都會記錄事件,因此這個資料表會持續填入資料。events_YYYYMMDD 完成後,這份資料表會在每天結束時刪除。

並非觸發事件的所有裝置都會在事件觸發當天傳送資料至 Analytics。為了反映這段延遲時間,Analytics 會更新每日資料表 (events_YYYYMMDD),加入事件觸發日期後三天內的事件。不論是否延後收到事件,事件都會有正確的時間戳記。系統不會記錄在這三天過後才收到的事件。

如果您使用的是 BigQuery 沙箱,系統不會匯入任何當天事件,且需要遵循其他限制

如要匯入當天資料,請從沙箱升級

events_YYYYMMDD 資料表中,每個資料欄都代表不同事件的專用參數。部分參數是安插在 RECORDS 的巢狀結構中,有些 RECORDS (例如 itemsevent_params) 則可以多個並存。這些表格欄的說明如下。

單一事件的資料可能包含一或多項 RECORDS,並分別以一或多列表示。例如,如果 page_view 事件包含多個 event_params,會以類似下表的形式呈現。初始資料列包含事件名稱、日期、時間戳記和其他不重複的資料項目。與事件相關聯的每個參數都包含 event_params RECORD。這些重複的 RECORDS 會直接填入初始事件列下方的後續資料列中。

event_date event_timestamp event_name event_params.key event_params_value.string_value
20220222 1643673600483790 page_view page_location https://example.com
      page_title 首頁
      參照連結網址
      source google
      page_referrer https://www.google.com
      <parameters...> <values...>

此事件資料在 GA4 使用者介面中如下所示。

這對您有幫助嗎?

我們應如何改進呢?
12522449163390962809
true
搜尋說明中心
true
true
true
true
true
69256
搜尋
清除搜尋內容
關閉搜尋
主選單
false
false
false