[GA4] 匯入使用者資料

請勿上傳內含相同索引鍵的檔案 (例如兩個名為 user_id 的欄位)。

您可以將儲存在外部的使用者中繼資料 (例如客戶關係管理系統中的忠誠度、上次購物日期和顧客終身價值) 匯入 Analytics (分析)，藉此提升使用者分眾和再行銷目標對象的品質。

「使用者資料匯入」的運作方式

為順利匯入使用者資料，請確認能使用下列任一索引鍵，彙整您的資料與 Analytics (分析) 資料：

串流 ID 加上 Analytics (分析) 產生的 Client-ID (網站) 或應用程式執行個體 ID (應用程式)。
您為每個使用者產生的專屬 ID。舉例來說，您可以從網站或應用程式驗證服務中擷取使用者 ID，也可以從客戶關係管理系統擷取，然後再將這些專屬 ID (經雜湊處理以保護使用者隱私) 加進評估程式碼，並與事件一同傳送到 Analytics (分析)。

Analytics (分析) 會使用 1) 串流 ID 加 Client-ID 或應用程式執行個體 ID；或 2) 專屬 ID 做為對應使用者和上傳資料的索引鍵。

您可以選取任一種方法來匯入資料。

如果您是使用串流 ID 加上應用程式執行個體 ID，將使用者對應至上傳的資料，請特別注意，系統會在每次使用者安裝應用程式時指派新的應用程式執行個體 ID。如果使用者解除安裝應用程式再重新安裝，那麼在重新安裝前後收集到的資料會與兩個不同的應用程式執行個體 ID 建立關聯，因此會視為兩個不同的使用者。應用程式更新不會改變應用程式執行個體 ID。

您透過這個程序識別的使用者所觸發的每個後續事件，在與上傳作業建立關聯後，上傳資料會儲存於使用者維度中。

在 Analytics (分析) 中儲存使用者 ID

在 Analytics (分析) 中儲存使用者 ID 的方法有兩種：

使用「User-ID」維度
瞭解如何設定使用者 ID
使用以使用者為範圍且包含使用者屬性的自訂維度來擷取使用者 ID
進一步瞭解避免將 PII 傳送給 Analytics (分析) 的最佳做法

建立自訂維度

請先建立自訂維度，再上傳資料。

為您要匯入的值建立以使用者為範圍的自訂維度。舉例來說，您可以利用「loyalty_tier」使用者屬性建立「使用者忠誠度層級」自訂維度。

建立自訂維度後，Analytics (分析) 最多需要 4 個小時才能識別您匯入的資料 (如要確認系統是否已處理自訂維度，請開啟「探索」，並查看維度挑選器中是否有使用者屬性)。

建立 CSV 檔案

建立使用者 ID 和使用者屬性值的 CSV 檔案。例如：

user_id	loyalty_tier
A1234	金級
J1234	銅級
K1234	銀級
R1234	銀級

上傳資料

如要瞭解一般上傳程序，請參閱關於資料匯入。

建立資料來源時，請選取「使用者資料 (依 User-ID)」或「使用者資料 (依 Client-ID)」，視您用來辨識使用者的方式而定 (User-ID 或 Client-ID/應用程式執行個體 ID + 串流 ID)。

將 Analytics (分析) 欄位對應至已匯入欄位時，您會看到下列資訊：

第一欄會顯示：

用來彙整資料的 Analytics (分析) 欄位 (這裡是指「User-ID」)，又稱為架構鍵。
在 Analytics (分析) 中建立的自訂維度所採用的使用者屬性，與 CSV 中的欄位相符。在上述範例中，自訂維度是包含「loyalty_tier」使用者屬性的「使用者忠誠度層級」。

在第二欄中，選取 CSV 檔案內的相符欄位：

上傳資料後，Analytics (分析) 最多可能需要 24 小時的處理時間，才能讓報表、目標對象和探索使用這些資料。上傳資料後，您指定的使用者必須與您的網站或應用程式互動，才能讓這些使用者屬性與使用者活動建立關聯。

如要覆寫使用者維度值，您可以上傳新的維度值，或透過評估程式碼收集新的維度值。

此外，即使從資料上傳服務刪除使用者資料來源，也不會使相關使用者在使用者維度中儲存的值遭到刪除。您可能需要視情況追蹤使用者刪除或資料刪除作業，以便將透過資料匯入功能上傳的資料都移除，這點和所有其他收集方法一樣。

資料來源詳細資料

圖例

範圍：用來指定哪些事件會與匯入維度值相連結。自訂維度的範圍可從二選一：
- 事件：事件的說明資訊 (例如事件名稱)
- 使用者：有關觸發事件的使用者說明資訊 (例如忠誠度層級)
架構鍵：列出鍵維度或指標。您可以針對這種資料來源類型，使用鍵來結合上傳的資料與事件中的現有資料。
匯入的資料：針對您上傳至 Analytics (分析) 的資料列出可用維度和指標。

此處列舉的架構維度和指標只是其中一部分，僅供參考。實際可用的維度和指標會在您建立資料來源時，顯示在使用者介面中。

範圍	使用者
架構鍵	須含有以下任一項： Client-ID + 串流 ID User-ID
已匯入的資料	使用者屬性
注意事項	您不得上傳個人識別資訊，也不得將其與使用者資料匯入建立關聯。瞭解詳情

範本

以下是針對 Client-ID 和 User-ID 資料的 CSV 範本範例。如果您需要手動建立上傳檔案，請參考這些範例。

Client-ID

client_id	stream_id	user_property1	user_property2	user_property3
1234567890.1234567890	1234567	使用者價值 1	使用者價值 2	使用者價值 3
2345678901.2345678901	1234567	使用者價值 1	使用者價值 2	使用者價值 3
3456789012.3456789012	1234567	使用者價值 1	使用者價值 2	使用者價值 3

請確認 Client-ID 是儲存為字串而非數字，以免遭截斷而無法顯示完整的小數位數。

User-ID

user_id	user_property1	user_property2	user_property3
123abc	使用者價值 1	使用者價值 2	使用者價值 3
456def	使用者價值 1	使用者價值 2	使用者價值 3
789ghi	使用者價值 1	使用者價值 2	使用者價值 3

下載使用者資料的 CSV 匯入範本。

找出串流 ID

在「管理」頁面的「資料收集和修改」下方，點選「資料串流」。
開啟相關的資料串流。

串流 ID 位於詳細資料標題的左側。

這對您有幫助嗎？

我們應如何改進呢？