將 Google Analytics 4 資料載入 BigQuery
您可以使用 Google Analytics 4 連接器的 BigQuery 資料移轉服務,將 Google Analytics 4 的資料載入 BigQuery。您可以使用 BigQuery 資料移轉服務,安排週期性移轉工作,將 Google Analytics 4 的最新資料新增至 BigQuery。
連接器總覽
Google Analytics 連接器的 BigQuery 資料移轉服務支援下列資料移轉選項。
| 資料移轉選項 | 支援 |
|---|---|
| 受支援的報表 | Google Analytics 連接器支援從 Google Analytics Data API v1 移轉報表資料。
如要瞭解 Google Analytics 報表如何轉換為 BigQuery 資料表和檢視表,請參閱「Google Analytics 報表轉換」。 |
| 重複頻率 | Google Analytics 連接器支援每日資料移轉。 根據預設,資料移轉作業會排定在建立資料移轉作業時執行。您可以在設定資料移轉作業時,設定資料移轉時間。 |
| 重新整理時間範圍 | 您可以排定資料移轉作業,在執行資料移轉時擷取最多 30 天的 Google Analytics 資料。設定資料移轉作業時,您可以設定重新整理回溯期的時間長度。 根據預設,Google Analytics 連接器的重新整理回溯期為 4 天。 詳情請參閱「重新整理時間範圍」。 |
| 補充資料可用性 | 執行資料補充作業,擷取排定資料移轉作業以外的資料。只要在資料來源的資料保留政策允許範圍內,即可擷取歷來資料。 如要瞭解 Google Analytics 的資料保留政策,請參閱「Google Analytics 資料保留政策」。 |
限制
- 不重複使用者和工作階段指標的匯總總計可能不準確,且可能與 Google Analytics 中的值不一致。
- Google Analytics 4 連接器不支援轉移自訂屬性。
從 Google Analytics 4 移轉作業擷取資料
將資料從 Google Analytics 4 移轉至 BigQuery 時,系統會將資料載入依日期分區的 BigQuery 資料表。資料載入的資料表分區會對應至資料來源的日期。如果您在同一天安排多項移轉作業,BigQuery 資料移轉服務會以最新資料覆寫該日期的分區。在同一天進行多次移轉或執行補充作業,不會產生重複資料,其他日期的分區也不會受到影響。重新整理時間範圍
「更新回溯期」是指資料移轉時,資料移轉作業擷取資料的天數。舉例來說,如果更新時間範圍為三天,且每天都會進行移轉,BigQuery 資料移轉服務會從來源資料表擷取過去三天的所有資料。在本例中,每日移轉作業執行時,BigQuery 資料移轉服務會建立新的 BigQuery 目的地資料表分區,並複製當天的來源資料表資料,然後自動觸發補充執行作業,使用過去兩天的來源資料表資料更新 BigQuery 目的地資料表分區。自動觸發的回填執行作業會覆寫或增量更新 BigQuery 目的地資料表,具體取決於 BigQuery 資料移轉服務連接器是否支援增量更新。
首次執行資料移轉作業時,系統會擷取重新整理期間內的所有可用來源資料。舉例來說,如果更新時間範圍為三天,且您首次執行資料移轉作業,BigQuery 資料移轉服務會擷取三天內的所有來源資料。
如要擷取更新時間範圍以外的資料 (例如歷來資料),或從任何移轉中斷或缺漏中復原資料,您可以啟動或排定補充執行作業。事前準備
建立 Google Analytics 4 資料移轉作業前,請先詳閱下列必要條件和資訊。
必要條件
- 在 Google Analytics 4 中,使用者帳戶或服務帳戶必須具備移轉設定所用資源 ID 的檢視權限。
- 確認您已完成啟用 BigQuery 資料移轉服務的所有必要動作。
- 建立 BigQuery 資料集,用於儲存 Google Analytics 4 資料。
- 如要設定 Pub/Sub 的移轉作業執行通知,請確認您具備
pubsub.topics.setIamPolicyIdentity and Access Management (IAM) 權限。如果只設定電子郵件通知,則不需要 Pub/Sub 權限。詳情請參閱 BigQuery 資料移轉服務執行通知一文。
必要的 BigQuery 角色
如要取得建立 BigQuery 資料移轉服務資料移轉作業所需的權限,請要求管理員授予您專案的 BigQuery 管理員 (roles/bigquery.admin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備建立 BigQuery 資料移轉服務資料移轉作業所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
您必須具備下列權限,才能建立 BigQuery 資料移轉服務資料移轉作業:
-
BigQuery 資料移轉服務權限:
-
bigquery.transfers.update -
bigquery.transfers.get
-
-
BigQuery 權限:
-
bigquery.datasets.get -
bigquery.datasets.getIamPolicy -
bigquery.datasets.update -
bigquery.datasets.setIamPolicy -
bigquery.jobs.create
-
詳情請參閱「授予 bigquery.admin 存取權」。
自訂報表
Google Analytics 適用的 BigQuery 資料移轉服務連接器,支援在 Google Analytics 移轉設定中指定維度和指標,以使用自訂報表。這些自訂報表會從 BigQuery 資料移轉服務支援的 Google Analytics Data API 版本擷取資料。
建立 Google Analytics 移轉作業時,您可以指定自訂報表。
自訂報表限制
- 每項移轉設定只能有一份自訂報表。
- 每份自訂報表最多支援 9 個維度和 10 個指標。
- 並非所有維度與指標都能夠彼此相容。建立移轉作業前,請使用 GA4 Dimensions & Metrics Explorer 工具,驗證自訂報表維度和指標。
- 不支援自訂維度和指標。
設定 Google Analytics 4 資料移轉作業
選取下列選項之一:
控制台
前往 Google Cloud 控制台的「Data transfers」(資料移轉) 頁面。
按一下「 建立移轉作業」。
在「Create transfer」(建立轉移作業)頁面執行下列操作:
- 在「Source type」(來源類型) 部分,「Source」(來源) 請選取「Google Analytics 4」。
在「Data source details」(資料來源詳細資料) 區段:
在「Destination settings」(目的地設定) 部分的「Destination dataset」(目的地資料集) 選單,請選取您為了儲存資料而建立的資料集。
在「Transfer config name」(轉移設定名稱) 專區,「Display name」(顯示名稱) 請輸入資料移轉作業的名稱。移轉作業名稱可以是任何值,能讓您辨識移轉作業,方便您日後在必要時進行修改。
在「Schedule options」(排程選項) 專區:
- 選取「Start now」(立即開始) 或「Start at set time」(在所設時間開始執行),並提供開始日期和執行時間。
- 在「Repeats」(重複頻率) 選取選項,指定資料移轉作業的執行頻率。如果選取「Days」(天),請按照世界標準時間提供有效的值。
選用:在「Service Account」(服務帳戶) 選單中,選取與 Google Cloud 專案相關聯的服務帳戶。所選服務帳戶必須具備必要角色,才能執行這項資料移轉作業。
如果使用聯合身分登入,您必須擁有服務帳戶才能建立資料移轉作業。如果是以 Google 帳戶登入,則不一定要透過服務帳戶建立資料移轉作業。如要進一步瞭解如何搭配使用服務帳戶與資料移轉作業,請參閱使用服務帳戶的相關說明。
選用步驟:在「Notification options」(通知選項) 部分執行下列操作:
選用步驟:如果您使用 CMEK,請在「Advanced options」(進階選項) 部分選取「Customer-managed key」(客戶管理的金鑰),畫面隨即會列出可用的 CMEK 供您選擇。如要瞭解 CMEK 如何與 BigQuery 資料移轉服務搭配運作,請參閱指定移轉作業加密金鑰的相關說明。
按一下「儲存」。
bq
輸入 bq mk 指令並提供移轉建立標記 - --transfer_config。必須使用下列旗標:
--data_source--target_dataset--display_name--params
bq mk --transfer_config \ --project_id=PROJECT_ID \ --target_dataset=DATASET \ --display_name=NAME \ --params='PARAMETERS' \ --data_source=DATA_SOURCE
其中:
- PROJECT_ID:您的專案 ID。如果未指定
--project_id,系統會使用預設專案。 - DATASET:資料移轉設定的目標資料集。
- NAME:資料移轉設定的顯示名稱。移轉作業名稱可以是任意值,日後需要修改移轉作業時,能夠據此識別即可。
- PARAMETERS:JSON 格式的已建立資料移轉設定參數,例如
--params='{"param":"param_value"}'。如果是 Google Analytics 4 移轉作業,則必須提供property_id參數。 - DATA_SOURCE:資料來源 -
ga4。
舉例來說,下列指令會使用資源 ID 468039345 建立名為 My Transfer 的 Google Analytics 4 資料移轉作業,並將目標資料集設為 mydataset。
資料移轉作業會在預設專案中建立:
bq mk --transfer_config --project_id=your_project --target_dataset=mydataset --display_name=My Transfer --params='{"property_id":"468039345"}' --data_source=ga4
API
請使用 projects.locations.transferConfigs.create 方法,並提供 TransferConfig 資源的例項。
指定轉移作業的加密金鑰
您可以指定客戶自行管理的加密金鑰 (CMEK),為移轉作業執行的資料加密。您可以使用 CMEK 支援從 Google Analytics 4 轉移資料。指定移轉作業的 CMEK 時,BigQuery 資料移轉服務會將 CMEK 套用至任何擷取資料的中繼磁碟快取,確保整個資料移轉工作流程符合 CMEK 規範。
如果移轉作業原本並非使用 CMEK 建立,則無法更新現有移轉作業來新增 CMEK。舉例來說,您無法將原本預設加密的目的地資料表,變更為以 CMEK 加密。反之,您也無法將 CMEK 加密的目的地資料表變更為其他加密類型。
如果移轉設定最初是以 CMEK 加密建立,則可更新移轉作業的 CMEK。更新移轉設定的 CMEK 時,BigQuery 資料移轉服務會在下次執行移轉作業時,將 CMEK 傳播至目的地資料表,並在移轉作業執行期間,以新的 CMEK 取代任何過時的 CMEK。詳情請參閱「更新移轉作業」。
您也可以使用專案預設金鑰。指定移轉作業的專案預設金鑰時,BigQuery 資料移轉服務會將專案預設金鑰,設為任何新移轉設定的預設金鑰。
定價
執行 Google Analytics 4 移轉作業無須付費。
資料移轉至 BigQuery 後,適用標準 BigQuery 儲存空間和查詢定價。
配額
Google Analytics 4 移轉作業須遵守 Google Analytics 4 Analytics 資源配額。如要提高每項資源的配額,請升級至 Google Analytics 360。