將 Google Analytics 4 資料載入 BigQuery

您可以使用 Google Analytics 4 的 BigQuery 資料移轉服務連接器，將資料從 Google Analytics 4 載入至 BigQuery。您可以使用 BigQuery 資料移轉服務，安排週期性轉移工作，將 Google Analytics 4 的最新資料新增至 BigQuery。

受支援的報表

Google Analytics 4 專用的 BigQuery 資料移轉服務支援下列報表選項：

報表選項 支援
重複頻率

每天，時間是資料移轉作業最初的建立時間 (預設)

您可以設定時間。
重新整理視窗

過去 4 天 (預設)

最多可設為 30 天
補充作業時間上限

不限

雖然 Google Analytics 連接器沒有回填資料的時間上限，但您可能會因為 Google Analytics 資料保留設定而發生回填歷來資料的錯誤。

如要瞭解 Google Analytics 4 報表如何轉換成 BigQuery 資料表和檢視表，請參閱「Google Analytics 4 資料轉換」一文。

在 Google Analytics 4 移轉作業中，BigQuery 資料移轉服務會將下列報表移轉至 BigQuery：

  • Audiences
  • Demographic details
  • Ecommerce purchases
  • Events
  • Landing page
  • Pages and screens
  • Promotions
  • Tech details
  • Traffic Acquisition
  • User Acquisition

如要進一步瞭解 Google Analytics 適用的預先定義報表，請參閱「預先定義報表」。

從 Google Analytics 4 轉移資料並擷取

將 Google Analytics 4 的資料轉移至 BigQuery 時，系統會將資料載入至按日期分區的 BigQuery 資料表。資料載入的資料表分區會對應至資料來源的日期。如果為同一天排定多項移轉作業，BigQuery 資料移轉服務會以最新資料覆寫該特定日期的資料分割。同一天內多次轉移資料或執行回填作業，不會導致資料重複，其他日期的分區也不會受到影響。

重新整理視窗

更新期是指資料移轉作業在執行時，擷取資料的天數。舉例來說，如果重新整理時間範圍為三天，且每天都會進行移轉，BigQuery 資料移轉服務就會從來源資料表擷取過去三天的所有資料。在這個範例中，每天進行移轉時，BigQuery 資料移轉服務會建立新的 BigQuery 目的地資料表分割區，並複製當天的來源資料表資料，然後自動觸發回填執行作業，以更新過去兩天的來源資料表資料。系統自動觸發的回填作業會覆寫或增量更新 BigQuery 目的地資料表，具體做法取決於 BigQuery 資料移轉服務連接器是否支援增量更新。

首次執行資料移轉時，資料移轉作業會擷取重新整理視窗內的所有可用來源資料。舉例來說，如果重新整理時間範圍為三天，且您是第一次執行資料移轉作業，BigQuery 資料移轉服務會擷取三天內的所有來源資料。

重新整理視窗會對應至 TransferConfig.data_refresh_window_days API 欄位。

如要擷取重新整理時間範圍外的資料 (例如歷來資料)，或從任何轉移中斷或缺漏中復原資料，您可以啟動或排定補充作業。

事前準備

建立 Google Analytics 4 資料移轉作業前，請先詳閱下列必要條件和資訊。

必要條件

  • 在 Google Analytics 4 中，使用者帳戶或服務帳戶必須具備移轉設定所用資源 ID 的檢視者存取權。
  • 確認您已完成啟用 BigQuery 資料移轉服務的一切必要動作。
  • 建立 BigQuery 資料集，儲存 Google Analytics 4 資料。
  • 如要為 Pub/Sub 設定移轉作業執行通知，請確認您擁有 pubsub.topics.setIamPolicy 身分與存取權管理 (IAM) 權限。如果您只設定電子郵件通知，則不需要 Pub/Sub 權限。詳情請參閱 BigQuery 資料移轉服務執行通知一文。

須具備的 BigQuery 角色

如要取得建立移轉作業所需的權限，請要求管理員授予您 BigQuery 管理員 (roles/bigquery.admin) 身分與存取權管理角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色具備建立轉移作業所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要建立移轉作業，必須具備下列權限：

  • bigquery.transfers.update 使用者
  • bigquery.datasets.update 目標資料集

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

設定 Google Analytics 4 資料轉移

選取下列選項之一：

主控台

  1. 前往 Google Cloud 控制台的「資料移轉」頁面。

    前往「資料移轉」

  2. 按一下 「建立移轉作業」。

  3. 在「Create transfer」(建立轉移作業)頁面執行下列操作：

    • 在「來源類型」部分，針對「來源」選擇「Google Analytics 4」。

  4. 在「Data source details」(資料來源詳細資料) 區段：

    • 在「資源 ID」欄位中，輸入資源 ID。
    • 選用步驟：在「Table Filter」(資料表篩選器) 欄位，輸入要涵蓋的資料表清單 (以半形逗號分隔)，例如 Audiences, Events。您可以為這份清單加上 - 前置字元來排除特定資料表，例如 -Audiences, Events。預設會加入所有資料表。
    • 選用步驟：在「Refresh window」(重新整理時間範圍) 欄位中，輸入重新整理時間範圍的天數。重新整理時間範圍的預設值為 4 天，最多可設為 30 天。

  5. 在「Destination settings」(目的地設定) 部分的「Destination dataset」(目的地資料集) 選單，請選取您為了儲存資料而建立的資料集。

  6. 在「Transfer config name」(轉移設定名稱) 專區，「Display name」(顯示名稱) 請輸入資料移轉作業的名稱。移轉作業名稱可以是任何值，能讓您辨識移轉作業，方便您日後在必要時進行修改。

  7. 在「Schedule options」(排程選項) 專區：

    • 選取「Start now」(立即開始) 或「Start at set time」(在所設時間開始執行)，並提供開始日期和執行時間。
    • 「Repeats」請選擇您要多久移轉一次。如果選取「Days」(天)，請按照世界標準時間提供有效的值。

  8. 選用：在「Service Account」(服務帳戶) 選單，選取與貴組織 Google Cloud 專案相關聯的服務帳戶。所選服務帳戶必須具備必要角色，才能執行這項資料移轉作業。

    如果使用聯合身分登入，您必須擁有服務帳戶才能建立資料移轉作業。如果以 Google 帳戶登入，則不一定要透過服務帳戶建立資料移轉作業。如要進一步瞭解如何搭配使用服務帳戶與資料移轉作業，請參閱使用服務帳戶的相關說明。

  9. 選用步驟：在「Notification options」(通知選項) 部分執行下列操作：

    • 按一下啟用電子郵件通知的切換開關。當您啟用此選項時，移轉管理員會在移轉作業失敗時收到電子郵件通知。
    • 點選切換按鈕，啟用 Pub/Sub 通知。在「Select a Cloud Pub/Sub topic」(選取 Cloud Pub/Sub 主題) 選取主題名稱，或是點選「Create a topic」(建立主題)。這個選項會針對移轉作業設定 Pub/Sub 執行通知。

  10. 選用步驟：如果您使用 CMEK，請在「Advanced options」(進階選項) 部分選取「Customer-managed key」(客戶管理的金鑰)，畫面隨即會列出可用的 CMEK 供您選擇。如要瞭解 CMEK 如何與 BigQuery 資料移轉服務搭配運作，請參閱指定移轉作業加密金鑰的相關說明。

  11. 按一下 [儲存]。

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 和目標資料集 mydataset，建立名為 My Transfer 的 Google Analytics 4 資料移轉作業。

資料移轉作業會在預設專案中建立：

  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 資源的執行個體。

限制

  • 不重複使用者和工作階段指標的匯總總計可能不準確，且可能與 Google Analytics 中的值不符。

指定轉移作業的加密金鑰

您可以指定客戶自行管理的加密金鑰 (CMEK)，為轉移作業加密資料。您可以使用 CMEK 支援從 Google Analytics 4 轉移資料。

指定移轉作業的 CMEK 後，BigQuery 資料移轉服務會將 CMEK 套用至所有已擷取資料的中間磁碟快取，確保整個資料移轉工作流程符合 CMEK 規定。

如果轉移作業最初並非使用 CMEK 建立，您就無法更新現有轉移作業來新增 CMEK。舉例來說，您無法將原本預設加密的目的地資料表，變更為使用 CMEK 加密。反之，您也無法將 CMEK 加密的目的地資料表變更為其他類型的加密。

如果移轉設定最初是使用 CMEK 加密建立，您可以更新移轉的 CMEK。更新移轉作業設定的 CMEK 時，BigQuery 資料移轉服務會在下次執行移轉作業時，將 CMEK 傳播至目的地資料表。屆時，BigQuery 資料移轉服務會在移轉作業執行期間，以新的 CMEK 取代任何過時的 CMEK。詳情請參閱「更新轉移作業」。

您也可以使用專案預設鍵。 使用移轉作業指定專案預設金鑰時，BigQuery 資料移轉服務會將專案預設金鑰做為任何新移轉作業設定的預設金鑰。

定價

執行 Google Analytics 4 轉移作業不會產生任何費用。

資料移轉至 BigQuery 之後，即適用標準的 BigQuery 儲存空間和查詢計價方式。

配額

Google Analytics 4 轉移作業須遵守 Google Analytics 4 執行的Analytics 資源配額。如要提高每個資源的配額，請升級至 Google Analytics 360。