使用 GA4 資料匯入，將 Google Analytics 數據與外部數據結合

GA4 資料匯入功能，可以將外部數據（包含線下交易、第三方數據、CRM資料、內部數據等等）匯入 GA4 資源，與現有數據進行彙整，取得更完整、精確的數據；本篇文章將會說明 GA4 資料匯入運作方式與使用設定教學。

什麼時候會需要使用 GA4 資料匯入?

雖然 GA4 資源可以同時收集 APP 與網站數據，但很多時候， GA4 仍然不能涵蓋所有數據範圍，需要依靠外部系統取得更完整的數據，以電商網站來說：

• 除了線上的轉換，可能也有線下的交易。
• 除了使用者在網站(APP)產生的數據，可能也有其他 CRM 系統的客戶數據。
• 除了網站(APP)公開的商品基本資訊以外(名稱、售價、分類等等)，可能也有內部商品資訊(庫存、成本、配合廠商等等)。

如果要同時使用所有數據，通常會需要額外的分析工具(例如 Google Data Studio)，將所有資料來源( GA4 數據、線下交易、第三方數據、CRM資料、內部數據等等)彙整在一起；而現在，透過 GA4 資料匯入功能，可以將外部數據直接上傳至 GA4 資源，在 GA4 資源彙整不同來源數據，提供更完整的數據報表；此外， 結合 GA4 與外部數據，可以取得更精準的使用者屬性，並利用這些使用者屬性，建立 GA4 目標對象，取得自訂使用者群組。

GA4 資料匯入介紹

上傳資料

GA4 資料匯入功能提供不同種類的上傳資料類型（產品資料、使用者資料-按User ID、使用者資料-按裝置ID、離線事件資料等等），將要上傳的資料整理成 CSV 格式，即可匯入 GA4；系統會自動比對匯入資料鍵值（離線事件資料除外），將匯入的額外參數資訊添加到與鍵值匹配的事件，依照不同資料類型，對鍵值與額外參數資訊有不同的規範，詳細說明如下：

產品資料

• 鍵值：產品 ID(item_id)
• 支援的額外參數資訊：產品名稱(item_name)、產品分類1(item_category)、產品分類2(item_category2)、產品分類3(item_category3)、產品分類4(item_category4)、產品分類5(item_category5)、產品品牌(item_brand)、變化版本(item_variant)

使用前必須導入網站(APP)電子商務代碼；上傳資料後，系統會自動比對電子商務產品 ID，只要比對相符，就會將匯入的額外參數資訊與現有數據整合。

備註：由於 GA4 尚未開放產品範圍的自訂維度，因此除了預設支援參數以外，無法額外添加自訂產品參數。

使用者資料 – 按 User ID

• 鍵值：User ID(user_id)
• 支援的額外參數資訊：使用者範圍層級自訂維度

使用前必須導入網站(APP) User ID 機制，並確認要上傳的參數已經設定為使用者範圍層級自訂維度；上傳資料後，系統會自動比對 User ID ，只要比對相符，就會將匯入的額外參數資訊與該 User ID 數據整合。

使用者資料 – 按裝置 ID

• 鍵值：裝置 ID (user_pseudo_id)、資料串流 ID
• 支援的額外參數資訊：使用者範圍層級自訂維度

使用前需確認要上傳的參數已經設定為使用者範圍層級自訂維度；上傳資料後，系統會自動比對裝置 ID 與資料串流 ID ，只要比對相符，就會將匯入的額外參數資訊與該裝置 ID 數據整合。

離線事件資料

離線事件資料匯入的目的不是與現有數據彙整，而是為了建立離線產生的事件，因此，離線事件資料沒有鍵值欄位，取而代之的是完整事件參數資訊欄位，系統會依照上傳的參數資訊，建立全新的事件。

處理程序

資料匯入後，系統會先經過資料比對處理程序，找出與鍵值比對相符的數據，才會將額外參數資訊與現有數據整合；依照不同上傳資料類型，分為處理時匯入與查詢時匯入兩種處理方式（不包含離線事件資料）：

處理時匯入（Processing Time）

• 使用此處理方式的資料類型：使用者資料-按 User ID、使用者資料-按裝置 ID

資料匯入後，系統會在事件產生時比對鍵值，如果比對相符，就會把該鍵值對應的額外參數資訊添加到該事件，額外參數資訊會跟著事件一起被儲存，即便日後刪除資料匯入的檔案，也不會影響已儲存的額外參數資訊。

注意事項：

1. 不可回溯過去事件
   • 系統會在事件產生當下比對鍵值，對於過去已經發生的事件，無法進行比對。
2. 不會即時更新
   • 系統會在事件產生當下比對鍵值，直到比對相符為止，匯入資料才會被更新；也就是說，如果上傳的鍵值一直無法比對到相符的事件，那麼該鍵值對應的額外參數資訊則永遠不會被更新。
3. 額外參數資訊非永久性
   • 資料匯入支援的額外參數資訊為使用者範圍自訂維度（使用者屬性），因此，如果未來有新的維度值產生，原有維度值就會被覆蓋。
4. 已儲存數據無法移除
   • 系統會在鍵值比對相符時，將額外參數資訊添加到事件上，因此，匯入的額外參數資訊會和事件一起儲存，即便日後刪除資料匯入檔案，已儲存的額外參數資訊也不會被移除。
   • GA4 提供資料刪除功能，透過此功能可以刪除已儲存的額外參數資訊，詳細說明可以參考 使用 GA4 資料刪除功能，移除 GA4 資源異常數據。

查詢時匯入（Query Time）

使用此處理方式的資料類型：產品資料

資料匯入後，系統會在執行 GA4 預設報表時比對鍵值，如果報表內維度與鍵值相符，就會把該鍵值對應的額外參數資訊更新到報表（僅更新報表顯示的部分，不會修改底層數據），一旦刪除資料匯入檔案，原本匯入的額外參數資訊也會跟著移除。

注意事項：

1. 支援的報表
   • 資料匯入只會在預設報表進行比對，分析中心報表無法套用資料匯入結果。
2. 即時更新
   • 系統會在執行 GA4 預設報表時比對所有鍵值，只要比對相符，就會將鍵值對應的額外參數資訊更新在報表上（可追溯過去數據）。
3. 匯入資料不會進行儲存
   • 系統只會將額外參數資訊更新在報表上，不會修改底層數據，一旦刪除資料匯入檔案，所有額外參數資訊也會跟著消失。

GA4 資料匯入設定

Step1: 準備上傳資料

上圖為產品資料類型範例，確認要上傳的資訊包含資料類型所需鍵值(產品資料類型鍵值為 item_id)與要匯入的額外參數資訊，最後將檔案儲存為 CSV 格式即可。

Step2: 建立資料來源

點擊 GA4 資源左下角管理 -> 資源層級資料匯入 -> 建立資料來源。

Step3: 資料來源詳細資料設定

依序完成資料來源詳細資料的設定，確認無誤後，點擊右上方下一步。

• 資料來源名稱
  • 輸入匯入資料名稱，方便日後辨識與管理匯入資料。
• 資料類型
  • 依照需求選擇要使用的資料類型，建立後不可修改資料類型。
• 上傳要匯入的資料
  • 上傳先前準備好的 CSV 檔案。

Step4: 選擇匯入資料對應欄位

選擇匯入欄位要對應的 GA 欄位（灰色勾勾的欄位為必填欄位，也是系統使用的的鍵值），將匯入的額外參數資訊更新到對應的 Analytics 欄位，確認設定無誤後點擊右上方匯入即可完成設定。

備註：依照不同的資料類型，顯示的 GA 欄位有可能不同，如果要使用的欄位沒有出現在 GA 欄位，請再次確認是否已設定該欄位的使用者範圍自訂維度，詳細設定方式可以參考定義事件參數欄位，設定 GA4 自訂維度與自訂指標。

Step5: 確認資料匯入狀態

返回資料匯入總覽，確認資料匯入已完成(狀態顯示綠勾)，即可前往報表查看資料匯入結果。

備註：如果匯入資料類型的處理程序為處理時匯入，需等待新的數據產生且與鍵值相符，資料匯入參數資訊才會進行更新。

更新匯入資料

完成資料匯入後，如果要更新檔案內容，可以點擊立即匯入上傳最新檔案，系統會以最新的檔案為準。

離線事件資料匯入

使用離線事件資料匯入，必須嚴格按照系統規定的命名邏輯，否則系統將無法辨識欄位，導致資料上傳失敗或上傳數據缺漏，詳細的欄位說明如下：

必要欄位

• 資料串流與使用者資訊(measurement_id + client_id 或 firebase_app_id + app_instance_id)
  • 依照不同需求，可以自由選擇使用 GA4 評估 ID + client ID 或是 Firebase 應用程式 ID + APP廣告 ID，系統會依照上傳的組合，將新增的事件歸類於對應的資料串流。
• 事件名稱(event_name)
  • 要建立的離線事件名稱，事件名稱只能使用英文字母、數字與底線，且開頭必須為英文字母，使用中文事件名稱會導致事件上傳失敗。

選用欄位

• 時間戳(timestamp_micros)
  • 建立離線事件的時間戳，系統默認為資料匯入當下的時間為事件時間戳，可依照需求自訂事件時間戳，使用的時間戳必須為24小時內，否則會導致事件上傳失敗。
• 使用者 ID (user_id)
  • 通常為線下的會員編號，使用前請確認線上數據(網站或APP)已經導入 User ID 機制，且會員在線上與線下的會員編號為一致，否則有可能出現使用者重複計算或是線上線下使用者數據無法對齊的問題。
• 事件參數(event_param.[參數名稱])
  • 事件參數名稱只能使用英文字母、數字與底線，且開頭必須為英文字母，使用中文事件參數會導致事件上傳失敗（參數值則沒有此限制）。
• 使用者屬性(user_property.[使用者屬性])
  • 使用者屬性只能使用英文字母、數字與底線，且開頭必須為英文字母，使用中文使用者屬性會導致事件上傳失敗（使用者屬性值則沒有此限制）。
• 產品參數(item[產品順序編號].[產品參數名稱])
  • 由於 GA4 尚未開放產品範圍的自訂維度，因此除了 GA4 電子商務支援的參數以外，無法使用自定義產品參數名稱。

注意事項

• 已儲存數據無法移除
  • 成功上傳離線事件資料後，即便日後刪除資料匯入檔案，已建立的事件也不會被移除。
  • GA4 提供資料刪除功能，透過此功能可以刪除已建立的事件，詳細說明可以參考 使用 GA4 資料刪除功能，移除 GA4 資源異常數據。
• 限制與用量
  • 除了上述有關名稱的限制以外(不能使用中文)，所有事件都必須遵守 GA4 對於事件的限制與用量規定，詳細資訊可以參考 Google Analytics 4 事件，你必須知道的4件事情。

GA4 資料匯入用量限制

• 總用量限制
  • 所有上傳資料來源總用量限制為 10 GB。
• 單一資料來源限制
  • 單一資料來源用量限制為 1 GB。
• 每日上傳限制
  • 每日最多可以上傳 24 個檔案。

更多有關 GA4 資料匯入的說明，可以參考官方文件。