GA4の出力項目一覧を作成した

GA4のデータをBigQueryに出力した場合のデータ構造は公式ページに解説があるもののわかりくいため、俯瞰しやすい一覧を作成した。スプレッドシートして公開しておくのでご活用ください。

GA4のBigQuery出力項目一覧（Google Sheets）

一番重要なのに項目一覧からは読み取れない「イベントパラメータ」

GA4ではページビューもすべて「イベント」として計測される。

「イベント」として計測した情報は、evemt_paramsのなかに、Key-Value形式で格納されている。※どのようなKEYの項目があるか、Valueがどのカラム（String_valueなのかint_valueなのか）は「イベント」ごとに異なる

主要なイベントには以下のようなものがある

パラメータ	説明
ga_session_id	同一ユーザの内でセッションを一意に特定するID
ga_session_number	同一ユーザのセッション数（1の場合、初回訪問）
page_title	ページのタイトル
page_location	ページのURL
page_referrer	リファラURL（前のページのURL）
ignore_referrer	リファラを無視するかどうかを示すフラグ
medium	トラフィックの媒体（例: organic、CPCなど）
campaign	キャンペーン名
source	トラフィックのソース（例: Google、Newsletterなど）
term	キャンペーンのキーワード
entrances	ランディングページの場合に1を設定
engaged_session_event	エンゲージしたセッションのイベントかどうか
engagement_time_msec	エンゲージメント時間（ミリ秒）
session_engaged	セッションがエンゲージしたかどうかを示すフラグ
percent_scrolled	ページのスクロール率（パーセント）
file_extension	ダウンロードされたファイルの拡張子
file_name	ダウンロードされたファイルの名前
link_text	クリックされたリンクのテキスト
link_url	クリックされたリンクのURL
link_classes	クリックされたリンクのクラス属性
link_domain	クリックされたリンクのドメイン
outbound	外部リンクかどうかを示すフラグ
batch_ordering_id	データバッチの処理順序を示すID
batch_page_id	データバッチの処理単位を示すID

イベントごとに設定されるパラメータは異なる。

「イベントパラメータ」を取得するSQL

分析に使用する際には以下のようなSQLを実行して横持ちに変換すると使いやすい。網掛けの箇所がポイント。

SELECT
    event_date
  , event_timestamp 
  , event_name
  , (SELECT value.int_value FROM UNNEST(event_params) WHERE key = 'ga_session_id') AS ga_session_id
  , (SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'page_location') AS page_location
  , (SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'page_title') AS page_title
FROM
    `your-project-name.analytics_XXXXXXXXX.events_*`
WHERE
    _TABLE_SUFFIX  between "20240101" and  "20240531"

このSQLを実行すると、このように横持ちで出力できる。

※この話も冒頭のスプレッドシートに記載しています