設定上傳檔案格式

瞭解如何建立 CSV 匯入檔案並設定格式。

本文提供了幾個實用的訣竅,方便您建立要上傳至 Analytics (分析) 的檔案並設定格式。設定必須正確,否則可能會發生上傳錯誤。

本文內容:

一般注意事項

  1. 資料檔必須以 CSV (逗號分隔值) 格式上傳。
  2. CSV 檔案的標題必須與目標「資料集」的架構完全相符。欄的順序則必須與架構中指定的順序相同,且所有欄名都必須使用內部的 ga. 維度或指標名稱,而非顯示名稱 (例如「ga:source」而非「來源」)。
  3. 上傳資料的格式設定必須正確。詳情請見以下說明。

建立上傳檔案

雖然您可以自由使用任何可行的方法建立上傳檔案,但使用文字編輯器或試算表應用程式仍是較為簡單的方式。不論採用何種方式,都要有「資料集」架構來建立上傳檔案標題。

取得架構

如果要複製或下載資料集的架構,請修改資料集並按一下 [取得架構] 按鈕。

取得資料集架構的方法如下:
  1. 登入 Google Analytics (分析)。
  2. 按一下 [管理],然後瀏覽至您要上傳資料的目的地資源
  3. 在「資源」欄中找出哪一個資源包含將存放您資料的資料集,並選取該資源。
  4. 按一下 [資料匯入]。
  5. 按一下目標資料集的 [名稱] 連結。
  6. 按一下靠近網頁底部的 [取得架構] 按鈕,下方對話方塊就會顯示。

使用文字編輯器

如果要使用文字編輯器建立上傳檔案,只要將架構複製起來,再貼到新檔案的第一行即可。接著,您就可以在這個標題下方加入資料 (每列一筆紀錄)。

請確定編輯器建立的是純文字檔。除非檔案已確實儲存為純文字檔 (.txt),最好不要使用 Microsoft Word 等 Rich Text 編輯器。Rich Text 格式包含額外的格式設定及控制字元,可能會造成匯入錯誤發生。

使用試算表

如果要將上傳資料加入試算表中,請先依照上述步驟取得資料集架構,再按一下 [下載架構範本] 按鈕。系統便會將架構標題放在「下載」目錄中。接著,您可以透過常用的試算表程式開啟該架構。請使用試算表的「匯入」功能,匯入您想要上傳的資料。如果檔案已經可以上傳了,請使用試算表程式的「另存新檔」或「匯出」功能,並選擇 [CSV] 做為輸出格式。

設定上傳資料的格式

使用「資料匯入」時,上傳檔案中的每一行都應該包含一筆匹配的相關資訊。匹配所包含的個別維度和指標會以逗號分隔,檔案中的每一行都會以換行符號做為結束符號。如果您想要上傳的實際資料包含逗號,請用引號括住該項資料。在上傳資料中不當使用逗號、引號和換行符號,可說是發生內容錯誤最常見的原因。因此,如果能瞭解「資料匯入」功能如何處理這些錯誤,在過程中便可省下不少麻煩。

逗號

在 CSV 檔案中使用逗號代表新增儲存格。換句話說,如果資料匯入功能看到未逸出的逗號,就會假設您要新增一欄。下例是格式正確的資料:

abc123,29.99,藍色,XXL 
def345,100,紅色,M
ghi678,1035.20,綠色,S

在這種情況下,「資料匯入」功能會看到四欄資料:

abc123 29.99 藍色 XXL
def345 100 紅色 M
ghi678 1035.20 綠色 S

如果我們在資料中多加一個逗號,像是將數字欄格式設為貨幣 (加入逗號來代表千分位,如下所示),結果會怎麼樣?

ghi678,"1,035.20",綠色,S

現在當您嘗試上傳這個檔案時,資料匯入功能會因為額外的逗號而看到五欄,所以上傳的表格看起來就會像這樣:

abc123 29.99 藍色 XXL
def345 100 紅色 M
ghi678 1 035.20 綠色 S

這樣就會產生錯誤,例如:

「錯誤:欄數不一致」

引號

英文雙引號可用來「逸出」儲存格的值。一般來說,如果儲存格的值包含逗號,建議您使用半形引號包圍該值。否則,資料匯入功能就會將逗號解讀為新增儲存格 (如上所示)。

範例:

ghi678,"1,035.20",綠色,S

系統會將 "1,035.20" 視為單一儲存格 (但「資料匯入」功能會將其視為字串,而非貨幣值)。

用引號逸出儲存格時,您必須調整引號數量。如果某一列的引號數量為奇數,匯入就會失敗,並出現像這樣的錯誤訊息:

「錯誤:第 x 列的 CSV 格式無效」。

換行符號

CSV 檔案中的換行符號是用來代表另起一列。資料匯入功能不支援在儲存格中使用換行符號,即使這些符號用引號逸出也一樣。如果資料列包含多餘的換行符號,該列或之後任一列的欄數就會發生錯誤,導致以下錯誤訊息產生:

「錯誤:CSV 列格式無效」

後續步驟

這對您有幫助嗎?

我們應如何改進呢?
true
選擇自己的學習路徑

歡迎使用 google.com/analytics/learn 這項新資源,瞭解如何發揮 Google Analytics (分析) 4 的最大效益。新版網站提供了影片、文章、引導式流程等多種資源,以及 Google Analytics (分析) Discord、網誌、YouTube 頻道和 GitHub 存放區的連結。

立即開始學習!

搜尋
清除搜尋內容
關閉搜尋
主選單
3202217895838070566
true
搜尋說明中心
true
true
true
true
true
69256
false
false