使用 Management API 导入产品数据

Andrew Wales，Google Analytics（分析）开发技术推广部 - 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（分析）时会用到此 ID。

准备要上传的产品数据 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

在上传产品数据之后，请更新您的电子商务代码以随每个匹配发送产品 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 相匹配，并且报告中将自动填充您上传的其他产品数据。