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:regionId、ga:cityId、ga:countryIsoCode 或 ga:subContinentCode 做為鍵。城市 ID 和國家/地區 ID 會列在「指定地理區域」表格中。ISO-3166-1 alpha-2 和 UN 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."
]
}
費用資料加總與覆寫
為費用資料建立自訂資料來源 / 資料集時，您可以選擇如何處理與現有資料列相符的一列資料 (即日期、來源、媒介) 時。可採用的選項包括：
- 加總 (預設)：新資料會加入任何先前相符的資料，且指標會加總。
- 覆寫 - 新資料會覆寫任何先前的所有相符資料。
如要瞭解已為資料集設定哪種類型，請使用自訂資料來源清單方法，檢查 importBehavior 屬性是否設為 OVERWRITE 或 SUMMATION。
費用資料列層級的加總與覆寫值
您也可以在標頭中加入「ga:importBehavior」欄，藉此覆寫每個上傳檔案的資料集行為。您可以針對資料列中的不同資料列，將 ga:importBehavior 的值設為 SUMMATION 或 OVERWRITE。
舉例來說，下列檔案會覆寫 Facebook/cpc 和 Yahoo/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。