文章目錄
更新時間：2025年8月4號
原理
基本原理是使用官方提供的readAnalyticsStorage API去獲取透Client ID，然後再將其設定為自訂維度。
readAnalyticsStorage API是官方提供的API，能夠準確獲取到Client ID，不要使用第一方Cookie _ga、自訂 JavaScript、window.gaGlobal.vid等方式，這些方式都會出現獲取不到的情形，導致Client ID顯示未not set。
設定過程
接下来看设置过程，主要分为四步：
步驟一：readAnalyticsStorage API獲取Client ID
這是GA4提供的一個API，能夠準確獲取到Client ID。
它透過自訂變數範本去使用，你需要建立一個自訂變數範本，在裡面使用readAnalyticsStorage API去取得Client ID/Session ID，已經有人分享了程式，如：https://github.com/luratic/ga4_get_client_id_and_session_info下載後，在的「範本」——「變數範本」中匯入。
在GA4裡點擊「變數」——「新增」——「請選擇變數類型以開始設定…」——「GA4 – Get Client Id & Session Info (Safe API)」，命名為“Client ID”，做如下設定：
步驟二：將Client ID設定為自訂維度
在GTM上找到Google Analytics 4 的基本設定，我的GA4基本設定是“Google Analytics 4 Basic Tracking”
如果你還沒安裝Google Analytics 4 ，請看：使用Google Tag Manager 安裝 Google Analytics 4 和調優
打開基本設定，在“使用者屬性”裡做如下設定：
使用者屬性就是自訂維度。
步驟三：GTM 中預覽調試
接下來就是調試了，在GTM中點擊右上角的“預覽”進入調試狀態，如果你還不知道怎麼調試，請看：新版Google Tag Manager 預覽模式指南——Tag Assistant
調試頁面打開後，返回到Tag Assistant頁面，在事件列表裡找到Container Loaded，這個表示頁面瀏覽的意思，點擊它：
可以看到Tag Fired裡，我們設定的代碼是成功觸發。
點開“Google Analytics 4 Basic Tracking”，右上角選擇Values：
可以看到User Properties裡的client_id是有值，值是一個Client ID，表示我們的設定成功。
步驟四：GA4中註冊自訂維度
在GA4中點擊「管理」——「資源設定」——「資料顯示」——「自訂定義」——「建立自訂維度」，然後做如下誰定：
需要注意，範圍是使用者。
這樣，設定就完成了。
