使用 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 相匹配,而且您上传的其他产品数据会自动填充到报告中。