本開發人員指南說明如何使用 Android 專用的 Google Analytics (分析) SDK v3.x 導入 User ID。
總覽
使用「User ID」功能,即可在 Google Analytics (分析) 中評估橫跨不同裝置的使用者活動,例如將某行動裝置上的行銷廣告活動互動,歸給其他行動裝置或瀏覽器中發生的轉換。
使用 userId
欄位傳送 User-ID 與 Google Analytics (分析) 命中後,報表就會顯示更準確的不重複使用者人數,並提供新的跨裝置報表選項。進一步瞭解使用 User-ID 的好處。
本指南說明如何使用 userId
欄位和 Android 適用的 Google Analytics (分析) SDK,將使用者 ID 傳送至 Google Analytics (分析)。
必要條件
傳送 User ID 至 Google Analytics (分析) 前,請先:
- 設定 User ID。
- 詳閱 User ID 政策。
- 如要瞭解 User ID 的運作方式,請參閱 User ID 功能參考資料。
導入作業
針對已知的 Android 應用程式使用者,您應該使用 userId
欄位傳送代表該名使用者的 ID,並一併傳送所有 Google Analytics (分析) 命中 (例如網頁瀏覽、事件、電子商務交易等)。
如要傳送 User-ID,請使用
Measurement Protocol 與語法和 Fields.USER_ID
參數名稱設定 userId
欄位,如以下範例所示:
/** * An example method called when a user signs in to an authentication system. * * @param User user represents a generic User object returned by an authentication system on sign in. */ public void onUserSignIn(User user) { Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y"); // You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be // sent with all subsequent hits. t.set(Fields.USER_ID, user.getId()); // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles). t.send(MapBuilder .createEvent("UX", // Event category (required) "Sign In", // Event action (required) null, // Event label null) // Event value .build() ); }