使用 Management API 匯入「產品資料」

Google Analytics (分析) 開發人員關係團隊 Andrew Wales - 2014 年 5 月

本指南將說明如何使用 Management API 匯入產品資料，藉此簡化 加強型電子商務的導入作業。如要進一步瞭解如何匯入產品資料，請參閱 產品資料匯入範例。

簡介

將產品資料匯入 Google Analytics (分析) 可簡化並減少需要與命中和事件等命中時一併傳送所需的電子商務資料量。在收集時間傳送至 Google Analytics (分析) 的單一產品 ID 或 SKU 可與匯入的產品資料合併，以在報表中填入產品維度和指標。

事前準備

在完成本解決方案指南之前，請先閱讀：

總覽

如要啟用產品資料的資料匯入功能，請按照下列步驟操作：

  1. 建立資料集
  2. 準備要上傳的產品資料 CSV
  3. 使用 Management API 上傳產品資料
  4. 更新電子商務程式碼以傳送產品 SKU

如要瞭解如何使用網頁介面將資料集上傳至 Google Analytics (分析)，請參閱「加強型電子商務使用手冊」。

建立資料集

匯入產品資料的第一步是為產品資料建立資料集，並設定結構定義，定義要匯入的維度和指標。

按照 資料匯入開發人員指南建立資料集，並選取「產品資料」做為資料集類型，並選取「產品 SKU」做為鍵。

圖 1：建立產品資料集。

建立資料集後，請記下「自訂資料來源 ID」，您將在下一個步驟中使用 Management API 將產品資料匯入 Google Analytics (分析)。

準備要上傳的產品資料 CSV

您的產品資料 CSV 必須包含標題列、「產品 SKU」欄，以及「資料集」架構定義，要匯入的每個維度和/或指標的資料欄。

請按照 資料匯入開發人員指南的說明，備妥 CSV 格式的產品資料以進行匯入，並在第一欄中用 產品 SKU 做為索引鍵。

圖 2：準備要以 CSV 檔案上傳的產品資料。

CSV 檔案看起來會像這樣：

ga:productSku,ga:productName,ga:productBrand,ga:productCategoryNew,ga:productVariant,ga:productPrice
12345,Triblend Shortsleeve T-Shirt,Google,Apparel,black,15.25
67890,Donut Friday Scented T-Shirt,Google,Apparel,gray,33.85
10292,Kaiser the Snake T-Shirt,Google,Apparel,green,19.10
67584,Organic Cotton Android T-Shirt,Google,Apparel,black,13.50
90876,Maps Biking T-Shirt,Google,Apparel,blue,15.65

使用 Management API 上傳產品資料

建立資料集、定義結構定義，並備妥要以 CSV 格式上傳的產品資料之後，就可以開始 使用 Management API 上傳產品資料。

上傳、驗證及處理產品資料之後，如果從資源傳送至 Google Analytics (分析) 的命中資料相符，產品 SKU 就會與上傳的產品資料合併。

更新電子商務程式碼以傳送產品 SKU

上傳產品資料後，請更新電子商務程式碼，在每次命中時一併傳送產品 SKU，以及要在報表中看到的其他資料，例如自訂維度或指標。

// Example of sending a transaction when joining with imported product data.
ga('create', 'UA-XXXX-Y');
ga('require', 'ec', 'ec.js'); // Load the Enhanced Ecommerce plug-in. Required.

// The product name, price, and other product data will be added to this hit
// at collection time if the value of the id field matches a Product SKU
// you've uploaded.
ga('ec:addImpression', {
  'id': '12345',              // Product ID/SKU (Key). Required.
  'list': 'Search Results',
  'position': 1,
  'dimension1': 'Member'
});

ga('send', 'pageview');       // Send the impression with a pageview hit.

從加強型電子商務導入傳送的產品 ID 現在會與已匯入產品資料集中的產品 SKU 相符，而報表會自動填入您已上傳的額外產品資料。