傳送 User-ID

User-ID 是您指派給個別使用者的專屬 ID。本指南說明如何將使用者 ID 傳送至 Google Analytics，以便連結不同工作階段、裝置和平台的使用者行為。

如要進一步瞭解 User-ID 功能，請參閱「評估跨平台活動」。如要瞭解如何為應用程式設定 User-ID，請參閱「設定 User-ID」。

根據使用者 ID 設定自訂維度，會導致維度含有過多不重複的值。不重複值過多會導致 Google Analytics 資料和報表準確度出現問題。進一步瞭解設定自訂維度的最佳做法。

gtag.js 代碼管理工具

事前準備

傳送使用者 ID 前，請務必完成下列事項：

• 建立 Google Analytics 帳戶和資源。
• 為網站建立網站資料串流。
• 在網站上加入 Google 代碼。
• 可存取網站的原始碼。
• 具備 Google Analytics 帳戶的編輯者角色 (或更高層級)。

傳送 User-ID

您為 user_id 傳送的值取決於使用者狀態：

• 使用者從未登入：請勿傳送 user_id 參數。
• 使用者已登入：傳送使用者 ID。
• 使用者先登入，然後登出：傳送 null。

如要將 User-ID 傳送到 Analytics，請在網站每個網頁的 config 指令中加入 user_id 參數：

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}

1. 將 TAG_ID 替換為您的代碼 ID。
2. 將註解替換成檢查使用者是否已登入，以及使用者是否已登入但隨後登出的檢查。
3. 如果使用者已登入，請將 USER_ID 替換成使用者 ID。
4. 使用者登出時，請將 user_id 設為 null。請勿傳送空字串 ("")、空白字串 (" ") 或以引號括住的字詞 "null" 或 "NULL"。