使用 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 欄，以及每個要匯入的維度和/或指標 (由資料集結構定義定義) 的資料欄。

按照 資料匯入開發人員指南，使用 產品 SKU 做為第一欄的索引鍵，準備好您要匯入的產品資料 CSV 以便匯入。

圖 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 比對，而報表會自動填入您上傳的其他產品資料。