[GA4] 收集使用者提供的資料 (代碼管理工具)

以下操作說明適用於已啟用「收集使用者提供的資料」功能的管理員和編輯者，可協助他們開始使用 Google 代碼管理工具傳送網站上使用者提供的資料。

Before you begin

You must turn on user-provided data collection in Google Analytics.

選擇如何設定資料收集功能

選擇如何在代碼管理工具中設定「收集使用者提供的資料」功能：

選項	說明
自動資料收集	Google Analytics 會檢查網頁，找出與電子郵件地址模式相符的字串。這個方法不適用於電話號碼和地址，建議使用下列方法做為補充。進一步瞭解這個方法
手動設定	選取要收集的使用者提供資料類型，例如電子郵件地址或電話號碼。接著，選取要如何在網頁上找出每種類型的資料，可以使用 CSS 選取器或全域 JavaScript 變數。進一步瞭解這個方法 這種方法比自動偵測使用者提供的資料更加精確，但不如在網站中加入程式碼片段可靠。如果您經常變更網站程式碼 (尤其是收集頁上的格式或 CSS 選取器)，不妨考慮在網站中加入程式碼片段。
程式碼	在網頁中加入 JavaScript 程式碼，收集電子郵件地址、電話號碼和/或姓名及地址。接著，為網頁上的每個事件設定 user_data 參數。進一步瞭解這個方法

需要設定的欄位

請參閱下表，瞭解可供設定的各個欄位。在程式碼中，請務必使用「鍵名」欄中的值來指稱欄位，並傳遞 String 類型的資料。在定義姓名和地址時，請務必將各個元件定義為個別變數 (例如名字和姓氏等)。

注意：如要傳送未經雜湊處理的資料，並讓 Google 對資料進行正規化和雜湊處理，請使用各個資料欄位的第一個鍵名，例如下方「電子郵件地址資料」欄位的「email」。若想傳送經過雜湊處理的資料，請使用開頭為 sha256_ 的鍵名。

資料欄位	鍵名	說明
電子郵件地址	電子郵件	使用者的電子郵件。 例如：「[e-mail]」
	sha256_email_address	經雜湊處理的使用者電子郵件。 範例： 「a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db」
電話號碼	phone_number	使用者的電話號碼。必須採用 E.164 格式，也就是 11 到 15 位數，內含加號 (+) 前置字元和國家/地區代碼，但不含破折號、括號或空格。 範例：「[phone]」
	sha256_phone_number	經雜湊處理的使用者電話號碼。 範例： 「e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1」
名字	address.first_name	使用者的名字。 例如：「大明」
	address.sha256_first_name	經雜湊處理的使用者名字。 範例： 「96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a」
姓氏	address.last_name	使用者的姓氏。 例如：「方」
	address.sha256_last_name	經雜湊處理的使用者姓氏。 範例： 「799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f」
街道地址	address.street	使用者的街道地址，例如：「北新路 123 號」
城市	address.city	使用者所在城市的名稱，例如：「新北市」
區域	address.region	使用者所在的州/省或區域，例如：「加州」
郵遞區號	address.postal_code	使用者的郵遞區號，例如：「234」
國家/地區	address.country	使用者的國家/地區代碼，例如：「UK」。請以 ISO 3166-1 二位字母代碼這個標準格式，提供雙字母國家/地區代碼。