GA4 と BigQuery を連携

GA4（Google アナリティクス 4）のデータを BigQuery に連携すると、標準レポートでは見えないイベント単位の生ログデータを SQL で自由に分析できるようになる。

手順1：GCP プロジェクト作成 & BigQuery API 有効化

1. https://console.cloud.google.com/ にアクセス
2. プロジェクトを新規作成
3. 左上「ナビゲーションメニュー」 ＞ 「APIとサービス」 ＞ 「ライブラリ」
4. 「BigQuery API」を検索 → 有効化
   • 「この API を使用するには、認証情報が必要になる可能性があります。」とあるが、GA4 → BigQuery の連携だけなら、認証情報の追加は不要
   • 今回は GA4 側が内部的にBigQuery API を使う
   • 手動で API をプログラムから呼び出すわけではないため、認証情報（APIキーやOAuthクライアントなど）を自分で作成する必要はない

手順2：GA4 側で BigQuery にエクスポート設定

1. https://analytics.google.com にログイン
2. 対象の GA4 プロパティを開く
3. 左下 ⚙「管理（Admin）」をクリック
4. プロパティ設定 ＞ サービス間のリンク設定 ＞ [BigQuery へのリンク] を選択
5. 「リンクを作成」 ＞ プロジェクト選択
   • 先ほど作成した GCP プロジェクトを選ぶ
   • データのロケーションは基本「asia-northeast1（東京）」にしたほうがいい
     • データが物理的に保管される地域のこと
     • GA4のユーザーが日本中心なら、東京が最も高速・安定
     • Cloud FunctionsやCloud Storageなども東京リージョンで統一できる
     • BigQueryの利用料金はどのリージョンでも基本同じ（ストレージ・クエリ共に）
     • BigQuery のデータセットロケーションは一度作ると変更不可
     • ロケーションが違うと、データをまたいでクエリを実行することも基本できない
6. エクスポート設定を選択
   • エクスポートタイプ：
     • 毎日（無料プランOK）
     • ストリーミング（ベストエフォート）は有料らしいので今回は外す
       • 5〜15分以内の遅延でイベントがBQに入る
       • 生成されるのは events_intraday_YYYYMMDD テーブル（暫定データ）
       • リアルタイム監視や即時アラート用に便利
   • ユーザーデータ：
     • 日別
     • 1日に1回、前日の全イベントデータを BigQuery にまとめて送る方式
     • データセットに events_YYYYMMDD というテーブルが1日ごとに生成されます
7. 保存して完了

手順3：BigQuery 側で確認

• 翌日以降、analytics_<property_id> データセットが作成され、events_YYYYMMDD のテーブルが毎日1つずつ作成される
• GA4 のデータ構造は「イベントベース」なので、1ユーザーの1ページビューも1行ずつ保存されている
• セッション分析やユーザーごとの集計には、user_pseudo_id + session_id でグループ化するのが基本
• 各フィールドの説明は下記

event_params の中身の例：

同時にユーザー単位のテーブル pseudonymous_users_YYYYMMDD もできている。

• events_YYYYMMDD はイベント単位（1行＝1イベント）
• pseudonymous_users_YYYYMMDD はユーザー単位（1行＝1ユーザー）

手順4：クエリを書いてチェック

直近30日の UU・セッション数・PV を出してみる。

WITH base_events AS (
  SELECT
    event_date,
    user_pseudo_id,
    -- セッションID（イベントパラメータから抽出）
    (SELECT value.int_value FROM UNNEST(event_params)
     WHERE key = "ga_session_id") AS session_id,
    event_name
  FROM
  `your_project.your_dataset.events_*`
  WHERE
    _TABLE_SUFFIX BETWEEN FORMAT_DATE('%Y%m%d', DATE_SUB(CURRENT_DATE(), INTERVAL 30 DAY))
                    AND FORMAT_DATE('%Y%m%d', DATE_SUB(CURRENT_DATE(), INTERVAL 1 DAY))
)

SELECT
  event_date,
  COUNT(DISTINCT user_pseudo_id) AS unique_users,
  COUNT(DISTINCT session_id) AS sessions,
  COUNTIF(event_name = 'page_view') AS pageviews
FROM
  base_events
GROUP BY
  event_date
ORDER BY
  event_date;

ちゃんと出た。クエリを保存しておく。

補足・注意点