購入データタグ

主な活用方法

・累計購入金額に応じてシナリオを出し分ける　
・累計購入回数に応じてシナリオを出し分ける
・接客シナリオ表示でどういう商品が購入されたか、詳細な分析を行う

タグの設置場所

購入完了ページにタグを設置して、購入データを出力してください。

データ項目

フィールド名（Key）	型	値（Value）のサンプル	概要	セグメント条件での使用
transactionId	文字列 ※必須項目	'EC1234'	購入トランザクションに紐づいた一意なID
totalAmount	数値（整数） ※必須項目	11330	購入金額合計 ※当該購入の購入金額合計をセットしてください。送料、消費税を含む金額を推奨。	○
consumptionTax	数値（整数）	1030	消費税額
shippingFee	数値（整数）	710	送料
items	配列	[ { itemId: 't001', name: 'フリルブラウス', price: 3500, quantity: 1, category: 'tops', brand: 'SproStyle' }, { itemId: 'b110', name: 'チノパンツ', price: 6800, quantity: 1, category: 'bottoms', brand: 'SproStyle' } ]	itemsというキーに個別商品データの配列をセットしてください。
items[].itemId	文字列	't001'	アイテムに振られる任意のIDです。例として SKU ID などを想定しています。
items[].name	文字列	'フリルブラウス'	商品名
items[].price	数値（整数）	3500	商品価格 ※税抜を推奨
items[].quantity	数値（整数）	2	購入商品数
items[].category	文字列	'tops'	商品カテゴリ
items[].brand	文字列	'SproStyle'	商品ブランド

🚧
購入データタグについての補足説明

transactionId と totalAmount は必須項目です。項目が存在しない場合はエラーとなり、データが送信されません。

totalAmount と items[].price は値が 0 でもバリデーションエラーにはならず、データが送信されます。

サポートしている文字コードは UTF-8 です。

🚧
データ連携タグについての補足説明（全タグ共通）
データ連携タグの発火タイミングやバリデーションについては「データ連携（リアルタイム取り込み）導入手順」ページを参照してください。

JavaScript サンプル

個別商品データはサンプルを参考に、配列として変数にセットしてください。ファンクション SPSDK.record() の第1パラメータに固定文字列 'purchase' を、第2パラメータに配列でデータ項目を指定します。

<script type="text/javascript">
(function() {
  var items = [
    {
      itemId: 't001',
      name: 'フリルブラウス',
      price: 3500,
      quantity: 1,
      category: 'tops',
      brand: 'SproStyle'
    },
    {
      itemId: 'b110',
      name: 'チノパンツ',
      price: 6800,
      quantity: 1,
      category: 'bottoms',
      brand: 'SproStyle'
    }];
  var props = {
    transactionId: 'EC1234',
    totalAmount: 11330,
    consumptionTax: 1030,
    shippingFee: 710,
    items: items
  };
  console.log('Sprocket: Purchase props:\n' + JSON.stringify(props, null, '  '));
  SPSDK.record('purchase', props);
})();
</script>

データ連携タグの実行順が保証できない場合

Sprocket タグが読み込まれてからデータ連携を実行する処理を組み込んでください。コード例は下記です。

<script type="text/javascript">
(function() {
  var count = 0;
  setTimeout(function wait() {
    if (++count > 10) return;
    if (typeof SPSDK === 'undefined') return setTimeout(wait, 500);
    var items = [
      {
        itemId: 't001',
        name: 'フリルブラウス',
        price: 3500,
        quantity: 1,
        category: 'tops',
        brand: 'SproStyle'
      },
      {
        itemId: 'b110',
        name: 'チノパンツ',
        price: 6800,
        quantity: 1,
        category: 'bottoms',
        brand: 'SproStyle'
      }];
    var props = {
      transactionId: 'EC1234',
      totalAmount: 11330,
      consumptionTax: 1030,
      shippingFee: 710,
      items: items
    };
    console.log('Sprocket: Purchase props:\n' + JSON.stringify(props, null, '  '));
    SPSDK.record('purchase', props);
  }, 500);
})();
</script>