[GA4] 關於「資料匯入」

使用資料匯入的好處

您所使用的每個業務系統都會產生專屬資料。比方說，顧客關係管理系統可能會有顧客忠誠度、生命週期價值，以及產品偏好等資訊。要是您是網路發布商，內容管理系統裡可能儲存了作者和文章類別等維度，若您經營電子商務，則或許會儲存價格、樣式和尺寸等項目屬性。

此外，您也使用 Analytics 來評估網站及應用程式的流量和成效。

每一項資料通常都各自獨立，彼此互無關聯，但「資料匯入」可讓您按照指定的時間表在 Analytics 中合併所有的資料，藉此彙整原本分碎零散的數據、發掘全新深入分析，以及開放眾人查閱資料。

資料匯入的運作方式

上傳資料

您可以將內含外部資料的 CSV 檔案上傳到 Analytics 資源。這些 CSV 檔案可從離線業務工具 (例如客戶關係管理或內容管理系統) 中匯出；如果資料量較少，您可以在文字編輯器或試算表中手動建立檔案。

「資料匯入」會合併您上傳的離線資料與 Analytics 收集到的事件資料。匯入資料可提升報表、比較結果和目標對象的品質，讓您更全面地瞭解線上和離線活動。

合併資料

視匯入的資料類型而定，其合併方式有 2 種：

• 收集/處理時間：系統會在收集和處理 Analytics 資料的過程中，彙整您匯入的資料和 Analytics 數據並將其視為透過事件收集到的資料，然後寫入至 Analytics 匯總表格。匯入的資料不會與 Analytics 歷來資料 (已經處理過的資料) 合併；如果您刪除匯入的資料檔案，系統就不會再進行資料合併作業，但會保留已經彙整的資料。
  
  系統會在收集/處理資料時，合併使用者資料和離線事件資料。

• 報表/查詢時間：開啟報表時，匯入的資料會與 Analytics 資料相結合，而 Analytics 會查詢報表資料。這是暫時性的資料合併做法；如果您刪除匯入的資料檔案，系統就不會再進行資料合併作業，您也無法再透過 Analytics 查看彙整後的資料。
  
  系統會在報表/查詢時間彙整費用、項目和自訂事件資料。
  
  如果您在 Analytics 中建立目標對象或在「探索」中建立區隔，系統無法提供報表時間/查詢時間資料。

匯入資料之後，系統會保留先前匯入的資料，並附加新匯入的資料。請注意，如果匯入資料與先前匯入的資料具有相同的鍵組合，系統會覆寫資料。

可匯入的中繼資料類型

中繼資料

匯入的中繼資料會加進資源已經收集到且處理過的資料。一般來說，中繼資料會儲存在自訂維度或指標中，但在某些情況下，建議您覆寫已經收集的預設資訊 (例如匯入已更新類別的產品目錄時)。

您可以匯入下列資料類型：

• 費用資料：第三方 (非 Google) 廣告聯播網的點擊次數、費用及曝光次數資料
• 項目資料：產品中繼資料，例如尺寸、顏色、樣式或其他產品相關維度
• 使用者資料：使用者中繼資料 (例如忠誠度或生命週期顧客價值)，可用來建立區隔和再行銷名單
• 離線事件：這是指匯入來源不具網路連線或不支援即時收集資料的離線事件
• 自訂事件資料：以標準欄位和/或自訂維度匯入事件的中繼資料

限制

資料來源大小	1GB
每日上傳	每項資源每天上傳 120 次

 

匯入資料類型	每資源資料來源數量上限	每種資料類型的儲存空間上限
費用資料	最多 5 秒	所有匯入來源總大小上限 1 GB
項目資料	最多 5 秒	所有匯入來源總大小上限 1 GB
使用者資料	最多 10 人	不適用
離線事件	最多 10 人	不適用
自訂事件資料	最多 5 秒	所有匯入來源總大小上限 1 GB

您可以透過「配額資訊」按鈕，查看產品中目前的配額用量。

如何匯入資料

您在匯入資料時需要建立資料來源，當中包含所要上傳的 CSV 檔案，以及現有 Analytics 欄位與 CSV 檔案中的對應欄位，例如：

請勿上傳內含相同金鑰的檔案 (例如 2 個名為 user_id 的欄位)

如要瞭解資料來源，您可以參考這篇文章

使用安全檔案傳輸通訊協定上傳資料的先決條件

如果您打算在步驟 5 使用安全檔案傳輸通訊協定選項，請確認安全檔案傳輸通訊協定伺服器支援 ssh-rsa 和 ssh-dss 主機金鑰演算法。進一步瞭解如何驗證您使用的主機金鑰演算法，以及如何設定安全檔案傳輸通訊協定伺服器網址的格式。

開始匯入程序

1. 在 「管理」的「資料收集和修改」下方，點選「資料匯入」。
   前一個連結會開啟您上次存取的 Analytics 資源，您可以使用資源選取器變更資源。 必須是編輯者或更高層級在資源層級已成功啟動匯入程序。
2. 建立新資料來源或選取現有資料來源 (請參閱下列各節)。

建立新資料來源

1. 按一下 [建立資料來源]。
2. 為資料來源檔案命名。
3. 選取資料類型：
   • 費用資料 (僅限查詢時匯入)
   • 項目資料 (報表/查詢時匯入)
   • 使用者資料 (依使用者 ID) (收集/處理時匯入)
   • 使用者資料 (依用戶端 ID) (收集/處理時匯入)
   • 離線事件資料 (收集/處理時匯入)
   • 自訂事件資料 (報表/查詢時匯入)
4. 看到提示訊息時，按一下「請詳閱條款」。在您要匯入裝置或使用者資料時，系統就會顯示這則提示。
5. 執行下列任一操作：
   • 點選「手動上傳 CSV 檔案」，然後選取電腦上的 CSV 檔案，再按一下「開啟」。
   或
   • 選取 [安全檔案傳輸通訊協定]SFTP。
   • 安全檔案傳輸通訊協定伺服器使用者名稱：輸入安全檔案傳輸通訊協定伺服器的使用者名稱。
   • 安全檔案傳輸通訊協定伺服器網址：輸入安全檔案傳輸通訊協定伺服器的網址。
   • 頻率：選擇上傳頻率 (每日、每週、每月)。
   • 開始時間：選取您希望開始上傳的時段。
   • 建立資料來源後，您會在用來建立資料來源的介面中看到安全檔案傳輸通訊協定伺服器的公開金鑰，此外也可以在資料來源詳細資料中取得金鑰 (請見下文說明)。
6. 點選 [下一步] 前往對應階段。
7. 選取要彼此對應的 Analytics 欄位和匯入欄位。視需要編輯欄位名稱。
8. 按一下「匯入」。

將資料上傳到現有資料來源

1. 在現有資料來源的資料列中，按一下 [立即匯入]。
2. 如果已設定用來匯入 CSV 檔案的資料來源，請選取要匯入的 CSV 檔案，然後按一下「開啟」。

CSV 檔案中的欄位必須全部或部分與原始欄位相同。如要匯入不同欄位 (但當中包含的資料類型與原始欄位相同)，請刪除現有資料來源並新建一個。

在來源資源中匯入的資料會自動匯出至綜覽資源和子資源。

驗證安全檔案傳輸通訊協定主機金鑰演算法、設定安全檔案傳輸通訊協定伺服器網址的格式

驗證演算法

您可以透過多種方法驗證安全檔案傳輸通訊協定伺服器是否使用 ssh-rsa 或 ssh-dss 主機金鑰演算法。舉例來說，您可使用 OpenSSH 遠端登入用戶端，透過下列指令查看伺服器記錄：

ssh -vv <您的安全檔案傳輸通訊協定伺服器名稱>

如果您的伺服器支援上述任一演算法，伺服器記錄中應會顯示下列這一行文字：

debug2: host key algorithms: rsa-sha2-512, rsa-sha2-256, ssh-rsa

設定安全檔案傳輸通訊協定伺服器網址的格式

如果安全檔案傳輸通訊協定伺服器網址的格式有誤，匯入設定就會失敗，並顯示內部錯誤訊息。

上傳資料匯入檔案時，安全檔案傳輸通訊協定伺服器網址通常包含 3 個部分，例如：

sftp://example.com//home/jon/upload.csv 包含以下部分：

• 網域：example.com
• 主目錄：//home/jon
• 檔案路徑：/upload.csv

以上例來說，上傳檔案位於主目錄。

網址中網域部分的格式有很多種設定方式，您可以使用網域名稱，也可使用伺服器的 IPv4 或 IPv6 位址 (包不包含通訊埠編號皆可)：

• 網域名稱：sftp://example.com
• IPv4 (含通訊埠編號)：sftp://142.250.189.4:1234
• IPv4 (不含通訊埠編號)：sftp://142.250.189.4
• IPv6 (含通訊埠編號)：sftp://[2607:f8b0:4007:817::2004]:1234
• IPv6 (不含通訊埠編號)：sftp://[2607:f8b0:4007:817::2004]

如果不含通訊埠編號，則預設通訊埠為 22。

您可以設定正確的網址格式來加入或排除主目錄。以下是格式設定正確的網址範例，其中以不同的格式識別網域。這些範例包含通訊埠編號，但您也可選擇不使用通訊埠編號。

• 包含主目錄：
  • sftp://example.com//home/jon/upload.csv (網域名稱)
  • sftp://142.250.189.4:1234//home/jon/upload.csv (IPv4 含通訊埠編號)
• 排除主目錄：
  • sftp://example.com/upload.csv (網域名稱)
  • sftp://[2607:f8b0:4007:817::2004]:1234/upload.csv (IPv6 含通訊埠編號)

如果上傳檔案位於主目錄的子目錄，網址看起來會像這樣：

sftp://example.com//home/jon/data/upload.csv

這是可使用下列格式類型：

• 包含主目錄：
  • sftp://example.com//home/jon/data/upload.csv
  • sftp://142.250.189.4:1234//home/jon/data/upload.csv (IPv4 含通訊埠編號)
• 排除主目錄：
  • sftp://example.com/data/upload.csv
  • sftp://[2607:f8b0:4007:817::2004]:1234/data/upload.csv (IPv6 含通訊埠編號)

如果上傳的檔案未儲存於主目錄 (//home/jon) 或主目錄的子目錄中 (//home/jon/data)，而是儲存在 /foo/bar 目錄中，則上傳檔案的正確格式看起來會像這樣：

sftp://example.com//foo/bar/upload.csv (主目錄會換成 //foo/bar)

查看資料來源詳細資料、取得安全檔案傳輸通訊協定公開金鑰、匯入新資料、刪除資料來源

1. 在 「管理」的「資料收集和修改」下方，點選「資料匯入」。
   前一個連結會開啟您上次存取的 Analytics 資源，您可以使用資源選取器變更資源。

   必須是檢視者或更高層級在資源層級查看資料來源詳細資料。

2. 在列出資料來源的資料列中，按一下 。

您可以查看每一項上傳作業的名稱、資料類型、公開金鑰和記錄。

• 公開金鑰：公開安全檔案傳輸通訊協定伺服器金鑰，與 Analytics 所儲存 (永不共用) 的相符私密金鑰對應，用來確保伺服器與 Analytics 資料匯入伺服器之間採用安全私密的連線。您必須在伺服器上授權這個公開金鑰，確保資料匯入可以安全執行。
• 已匯入 %：成功匯入的資料列數除以匯入檔案中的列數後，算出的百分比。100% 表示已成功匯入所有資料列。
• 媒合率：在匯入檔案中，最近 90 天內可在資源中找到的金鑰比例。100% 表示最近 90 天內，您資料的實用性和關聯性。
  注意：「已匯入的百分比」和「媒合率」與費用、項目和自訂事件資料匯入相關，但不適用於使用者資料匯入或離線事件資料匯入。

如要匯入新資料：

按一下 [立即匯入]，然後選擇電腦上相關的 CSV 檔案。

如何刪除資料來源：

1. 按一下 > [刪除資料來源]。
2. 詳閱刪除通知，然後按一下 [刪除資料來源]。

您可以刪除收集/處理時間資料，但如果您要移除先前上傳自 Analytics 所處理各項事件的資料，之後可能還需要刪除使用者或使用者屬性。如果刪除已經匯入的檔案，與匯入完成後收集到的事件相關並經過處理的資料不會跟著移除。 進一步瞭解資料刪除要求，請參閱這篇文章。

預留的名稱和前置字元

下列事件名稱、事件參數名稱、使用者屬性名稱和前置字元會預留供 Analytics 使用。如果您嘗試上傳的資料包含任何保留的名稱或前置字元，系統就不會上傳這筆資料。

例如：

• 如果您要匯入的事件使用了預留名稱，系統不會上傳該事件及其參數。
• 如果您要匯入的事件使用有效名稱，但其中一個參數使用了預留名稱，系統會匯入該事件，但不會匯入使用預留名稱的參數。

預留事件名稱

• ad_activeview
• ad_activeview
• ad_exposure
• ad_impression
• ad_query
• adunit_exposure
• app_clear_data
• app_install
• app_remove
• app_update
• 錯誤
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• os_update
• screen_view
• session_start
• user_engagement

預留事件參數名稱

• firebase_conversion

預留使用者屬性名稱

• first_open_after_install
• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id

預留前置字元 (適用於事件參數和使用者屬性)

• ga_
• google_
• firebase_