資料匯入開發人員指南

透過 Google Analytics (分析) Management API,您可以透過程式輔助方式存取 Google Analytics (分析) 的資料匯入功能。

簡介

Management API 可讓您上傳、列出、刪除及取得上傳的檔案,以及列出資料集。如想大致瞭解「資料匯入」功能的優點,請參閱說明中心的關於資料匯入一文。

Management API 中的兩個啟用「資料匯入」的資源如下:

  • 自訂資料來源資源,在網頁介面中稱為「資料集」,用來存放上傳檔案的容器。一組自訂資料來源代表與 Google Analytics (分析) 資源相關的所有資料集。
  • Upload 資源,代表已上傳的檔案。「上傳」資源集合代表您上傳到資料集的所有檔案。

應用實例

資料匯入功能有三個頂層類別,每個類別各有其用途。機構如下:

匹配資料匯入

退款資料

已全額或部分退款的電子商務交易可上傳至 Google Analytics (分析)。如此一來,您就能輕鬆自動核對 Google Analytics (分析) 電子商務報表中的資料和已處理退款的事宜。

若要瞭解如何將退款資料匯入 Google Analytics (分析),請參閱「退款資料匯入範例」一文。

擴展資料匯入

使用者資料

您可以從外部客戶關係管理工具上傳不含個人識別資訊的使用者資料,然後為最有價值的使用者區隔建立 Google Ads 再行銷目標對象。

如要瞭解如何將使用者資料匯入 Google Analytics (分析),以建立 Google Ads 再行銷目標對象,請參閱:

廣告活動資料

您可以將廣告活動資料匯入 Google Analytics (分析),以便自訂您業務的廣告活動成效分析。

如要瞭解如何將廣告活動資料匯入 Google Analytics (分析),請參閱「使用 Management API 匯入廣告活動資料」一文。

地理資料

您可以匯入地理區域 ID 和區域的對應關係,以便按自訂區域製作 Google Analytics (分析) 資料報表。舉例來說,在美國,您的營業據點可能橫跨東部、中部和西部各州;在歐洲,則營運地點可能橫跨北、中及南部。您可以使用 ga:regionIdga:cityIdga:countryIsoCodega:subContinentCode 做為索引鍵。城市 ID 和國家/地區 ID 會列在「指定地理區域」表格中。您可以在 ISO-3166-1 alpha-2UN M.49 表格中分別找到國家/地區 ISO 代碼和子洲別代碼。

如要進一步瞭解如何匯入地理資料,請參閱「地理區域資料匯入範例」

內容資料

您可以上傳作者和主題等內容相關中繼資料,透過 Google Analytics (分析) 針對網站上發布的文章進行深入分析。

如要瞭解如何將內容資料匯入 Google Analytics (分析),請參閱「內容資料匯入範例」一文。

產品資料

將「產品資料」匯入 Google Analytics (分析) 後,需要隨命中和事件等命中時需要傳送的電子商務資料量變得更加簡化並減少了。單一產品 ID 或 SKU 可與匯入的產品資料合併,在報表中填入產品維度和指標。

如要瞭解如何將產品資料匯入 Google Analytics (分析),請參閱「使用 Management API 匯入產品資料」一文。

Summary data import

費用資料

您可以上傳非 Google 付費廣告活動的費用資料,然後透過 Google Analytics (分析) 平台分析投資報酬率,並比較所有線上廣告和行銷投資的廣告活動成效。

若要瞭解如何將費用資料匯入 Google Analytics (分析),請參閱使用 Management API 匯入費用資料

概念

處理狀態

上傳檔案後,上傳作業的狀態會是 PENDING,直到上傳作業通過驗證並處理完畢為止。如果處理成功,狀態會變更為 COMPLETED

如果處理期間發生錯誤,上傳失敗,上傳作業的狀態會是 FAILED。系統會提供錯誤清單,協助您找出檔案的問題。以下是驗證失敗的上傳回應範例:

{
  id: "YU4DersR_ORzyzXC_AoWw",
  kind: "analytics#upload",
  accountId: "12345",
  customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
  status: "FAILED",
  errors:
  [
    "Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
    "Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
    "Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
    "Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
  ]
}

費用資料總和或覆寫

為費用資料建立自訂資料來源 / 資料集時,您可以選擇指定如何處理上傳的檔案,其中有一列資料鍵 (如日期、來源、媒介) 與現有資料列相符。可採用的選項包括:

  • summation (預設) - 新資料會加進任何先前的相符資料,並加總指標。
  • overwrite - 新資料會覆寫任何先前的相符資料。

如要找出資料集已設定的類型,請使用自訂資料來源清單方法,檢查 importBehavior 屬性是否已設為 OVERWRITESUMMATION

費用資料列層級總和與覆寫值

您也可以在標頭中加入 ga:importBehavior 欄,覆寫每個上傳檔案的資料集行為。您可以針對每列,將 ga:importBehavior 的值設為 SUMMATIONOVERWRITE

舉例來說,以下檔案會覆寫 Facebook/cpcYahoo/cpc 先前的任何費用資料,但「Bing/cpc」列會加進該日期和「來源/媒介」組合的現有費用資料,

ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE

格式和限制

資料必須是格式正確的 CSV 檔案,才能上傳到 Google Analytics (分析)。本節將說明必須滿足的限制,系統才會視為有效上傳至所有資料匯入類型。

如果違反以下任何限製或發生剖析錯誤,上傳要求就會失敗並產生錯誤訊息。API 會在單一回應中回報最多 10 個錯誤,協助使用者減少無效上傳的數量。

檔案限制

  • 編碼:UTF-8
  • 檔案大小上限:1 GB

標頭限制

  • 第一列視為欄標題,因此為必要項目。 必須定義特定欄要包含的維度和指標。

資料列限制

  • 資料列上限為 1 MB。

儲存格格式設定

  • 儲存格的長度上限為 2048 個字元。
  • 系統會移除儲存格開頭和結尾的空格。
  • 如要在儲存格中指定半形逗號,儲存格的值應置於雙引號內。例如:source1,"medium,ether",group1,100 - 第二個儲存格的值是中等。
  • 如要在儲存格中指定雙引號,除了開始和結尾雙引號外,也請在半形雙引號之間逸出雙引號。例如:source1,"medium""ether",group1,100 - 第二個儲存格的值是 medium"ether