[GA4] 關於「資料匯入」

使用資料匯入的好處

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

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

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

資料匯入的運作方式

上傳資料

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

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

合併資料

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

• 收集/處理時間：系統會在收集和處理 Analytics (分析) 資料的過程中，彙整您匯入的資料和 Analytics (分析) 數據並將其視為透過事件收集到的資料，然後寫入至 Analytics (分析) 匯總表格。匯入的資料不會與 Analytics (分析) 歷來資料 (已經處理過的資料) 合併；如果您刪除匯入的資料檔案，系統就不會再進行資料合併作業，但會保留已經彙整的資料。
  
  系統會在收集/處理資料時，合併使用者資料和離線事件資料。
• 報表/查詢時間：開啟報表時，匯入的資料會與 Analytics (分析) 資料相結合，而 Analytics (分析) 會查詢報表資料。這是暫時性的資料彙整做法。如果您刪除匯入的資料檔案，系統就不會再進行資料彙整作業，您也無法再透過 Analytics (分析) 查看彙整後的資料。
  
  系統會在報表時間/查詢時間彙整費用和項目資料。
  
  如果您在 Analytics (分析) 中建立目標對象或在「探索」中建立區隔，系統無法提供報表時間/查詢時間資料。

可匯入的中繼資料類型

中繼資料

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

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

• 費用資料：第三方 (非 Google) 廣告聯播網的點擊次數、費用及曝光次數資料
• 項目資料：產品中繼資料，例如尺寸、顏色、樣式或其他產品相關維度
• 使用者資料：使用者中繼資料 (例如客戶忠誠度或效期價值)，可用來建立區隔和再行銷名單
• 離線事件：從無法即時收集事件或沒有網路連線的來源匯入的離線事件

限制

儲存空間總量	10 GB (標準資源) 1 TB (360 資源)
資料來源大小	1 GB
每日上傳	每項資源每天 120 次上傳

如何匯入資料

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

 

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

進一步瞭解資料來源

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

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

開始匯入程序

1. 在 Google Analytics (分析) 中，按一下「管理」。
2. 確認您使用正確的帳戶和資源。

3. 在「資源」欄中，按一下「資料匯入」。
4. 建立新資料來源或選取現有資料來源 (請參閱下列各節)。

建立新資料來源

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

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

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

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

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. 在 Google Analytics (分析) 中，按一下「管理」。
2. 確認您使用正確的帳戶和資源。

3. 在「資源」欄中，按一下「資料匯入」。
4. 在列出資料來源的資料列中，按一下 。

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

• 公開金鑰：公開安全檔案傳輸通訊協定伺服器金鑰，與 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
• error
• 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_