[GA4][BigQuery] 在BigQuery找到GA4自訂維度參數

GA4 網站分析商務實戰 Sep 19, 2025
快速導覽

前言

在GA4分析數據資料時,通常會在【自訂定義】增加自訂維度參數 - 事件 。
當GA4資料匯進BigQuery時,要在哪裡找到這些自訂維度呢?


適合產業:所有產業
適合對象:使用BigQuery的數據資料進行分析的人

1. BigQuery查詢GA4事件參數的2個常見技巧

之前有分享 [BigQuery] BigQuery查詢GA4事件參數的2個常見技巧
建議各位先了解BigQuery的資料結構~


2. GA4【自訂定義】- 【自訂維度】事件範圍參數


2-1 BigQuery欄位找事件範圍的自訂維度參數

當自訂維度參數是屬於 【事件範圍】,在BigQuery裡要在event_params.key欄位才能找到事件範圍的自訂維度參數。

欄位名稱

說明

event_params.key

事件參數名稱

event_params.value.string_value

事件參數以字串 (例如網址或廣告活動名稱) 表示,這個欄位就會填入該參數。

event_params.value.int_value

事件參數以整數表示,這個欄位就會填入該參數

event_params.value.float_value

事件參數以浮點值表示,這個欄位就會填入該參數。目前未使用這個欄位。

event_params.value.double_value

事件參數以雙精度浮點值表示,這個欄位就會填入該參數。

之前分享的文章 [BigQuery] BigQuery查詢GA4事件參數的2個常見技巧 內也有說明每個事件參數value類型。

2-2 舉例說明


GA4資源


BigQuery欄位


如果要在BigQuery找出這個自訂維度的值,SQL語法如下

💡
SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'social_platform'


3. GA4【自訂定義】- 【自訂維度】使用者範圍參數

3-1 BigQuery欄位找使用者範圍的自訂維度參數

當自訂維度參數是屬於 【使用者範圍】,在BigQuery裡要在user_properties.key欄位才能找到使用者範圍的自訂維度參數。

欄位名稱

說明

user_properties.key

使用者屬性名稱

user_properties.value.string_value

使用者屬性的字串值。

user_properties.value.int_value

使用者屬性的整數值。

user_properties.value.float_value

目前未使用這個欄位。

user_properties.value.double_value

使用者屬性的雙精度浮點數值。

user_properties.value.set_timestamp_micros

上次設定使用者屬性的時間 (以微秒為單位)。

3-2 舉例說明

GA4資源

BigQuery欄位

如果要在BigQuery找出這兩個自訂維度的值,SQL語法如下

💡
SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'custom_user_id'
💡
SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'custom_client_id'


以上就是本次簡單的分享~


Tags