3. event_paramsについて（BigQueryのGoogle Analytics 4プロパティ）

この記事では、BigQueryのGoogle Analytics 4(旧Web +App)プロパティのevent_paramsカラムについて説明します。

event_paramsはevent_nameの種類によって内容が変わります。event_paramsについてと、event_paramsを参照するときのサンプルクエリをご紹介します。

event_nameに紐づくevent_paramsについて

各イベント(event_name)の各パラメータはevent_paramsの中に入っています。
各パラメータの説明は以下の記事をご覧ください。

event_params関連のサンプルクエリ

event_paramsのデータはネストされた繰り返し列のため、必要なパラメータを抽出して扱いやすくします。

以下がサンプルクエリになります。

-- データを取得する対象期間を設定
CREATE TEMPORARY FUNCTION fromDate() AS (DATE('2018-10-03'));
CREATE TEMPORARY FUNCTION toDate()  AS (DATE('2018-10-03'));

SELECT
  PARSE_DATE("%Y%m%d", event_date) AS date
  , (SELECT value.string_value FROM UNNEST(event_params) AS params WHERE params.key = 'firebase_screen_class') AS firebase_screen_class
  , (SELECT value.string_value FROM UNNEST(event_params) AS params WHERE params.key = 'firebase_previous_class') AS firebase_previous_class
  , (SELECT value.int_value FROM UNNEST(event_params) AS params WHERE params.key = 'firebase_screen_id') AS firebase_screen_id
FROM `firebase-public-project.analytics_153293282.events_*`
WHERE
_TABLE_SUFFIX BETWEEN FORMAT_DATE('%Y%m%d', fromDate()) AND FORMAT_DATE('%Y%m%d', toDate())
AND event_name = 'screen_view'
AND platform != 'WEB'
LIMIT 10

出力結果

screen_viewイベントの「firebase_screen_class」、「firebase_previous_class」、「firebase_screen_id」を取得しています。
縦持ちから横持ちのデータに変換できたので、扱いやすくなったと思います。

以下に示す通り、firebase_screen_classはstring型、firebase_screen_idはint型で記録されています。

そのため、firebase_screen_classのときは「value.string_value」をSELECTの後に書きます。

(SELECT value.string_value FROM UNNEST(event_params) AS params WHERE params.key = 'firebase_screen_class') AS firebase_screen_class

そのため、firebase_screen_idのときは「value.int_value」をSELECTの後に書きます。

(SELECT value.int_value FROM UNNEST(event_params) AS params WHERE params.key = 'firebase_screen_id') AS firebase_screen_id

最後に

他のパラメータも同じようにクエリを書くことで扱いやすい形式に変換できます。

このマガジンの記事

1. アプリの各画面を閲覧したユーザー数をBigQueryで集計する方法
2. Google Analytics 4の各イベントについての説明(page_view, screen_viewなど)
3. event_paramsについて（BigQueryのGoogle Analytics 4プロパティ）
4. GAをBigQueryで分析する際の注意点（WebとAppの違いやPlatformの絞り込み）
5. BigQueryでGoogle Analyticsを分析するときに参照したいドキュメント一覧
6. BigQueryのUDFの使い方や使用例の紹介（SQL編）
7. BigQueryのクエリのスケジューリングの設定方法や使い方