Management API を使用した商品データのインポート

Andrew Wales、Google アナリティクス デベロッパー リレーションズ – 2014 年 5 月

このガイドでは、Management API を使用して商品データをインポートすることで、拡張 e コマースの実装を簡素化する方法について説明します。商品データのインポートの詳細については、商品データのインポートの例をご覧ください。

はじめに

商品データを Google アナリティクスにインポートすると、ページビューやイベントなどのヒットと一緒に送信する e コマースデータを簡略化し、量を減らすことができます。インポートした商品データには、データ収集時に Google アナリティクスに送信される商品 ID か SKU を 1 つ統合することができます。そうすることで、レポートに商品のディメンションや指標などのデータを入力できます。

始める前に

このソリューション ガイドを完了する前に、以下をお読みください。

概要

商品データへのデータのインポートを有効にするには:

  1. データセットを作成する
  2. アップロード用の商品データ CSV を準備する
  3. Management API を使用して商品データをアップロードする
  4. e コマースコードを更新して商品の SKU を送信する

管理画面を利用して Google アナリティクスにデータセットをアップロードする方法については、拡張 e コマースのユーザーガイドをご覧ください。

データセットを作成する

商品データをインポートするには、まず商品データのデータセットを作成し、インポートしたいディメンションと指標を定義するスキーマを設定します。

データ インポート デベロッパー ガイドに従ってデータセットを作成し、[データセットのタイプ] として [商品データ] を、[キー] として [商品の SKU] を指定します。

図 1: 商品データセットの作成

データセットの作成後、[カスタム データソース ID] をメモしておいてください。次の手順で、Management API を使用して Google アナリティクスに商品データをインポートするときに、この 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 アナリティクスに送信された外部のヒットと値が一致すると、商品 SKU がアップロードされた商品データと結びつけられます。

商品の SKU を送信するように e コマースコードを更新

商品データのアップロードが完了したら、商品の SKU とそれぞれのヒット、カスタム ディメンションやカスタム指標など、レポートに追加したいデータを送信するように e コマースコードを更新します。

// 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.

拡張 e コマースの実装から送信された商品 ID が、インポートした商品データセット内の商品 SKU と照合され、アップロードした追加の商品データがレポートに自動的に入力されます。