---
updatedAt: 2025-12-17T00:21:30.000Z
agentTools:
  projectIndex: https://developer.sprocket.bz/llms.txt
---

# 購入データタグ

EC サイトの購入データの情報を Sprocket に連携して、接客のセグメント条件や分析に活用するためのデータ連携タグです。

## 主な活用方法

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

## タグの設置場所

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

## データ項目

<Table align={["left","left","left","left",null]}>
  <thead>
    <tr>
      <th>
        フィールド名（Key）
      </th>

      <th>
        型
      </th>

      <th>
        値（Value）のサンプル
      </th>

      <th>
        概要
      </th>

      <th>
        セグメント条件での使用
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        transactionId
      </td>

      <td>
        文字列  
        ※必須項目
      </td>

      <td>
        'EC1234'
      </td>

      <td>
        購入トランザクションに紐づいた一意なID
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        totalAmount
      </td>

      <td>
        数値（整数）  
        ※必須項目
      </td>

      <td>
        11330
      </td>

      <td>
        購入金額合計  
        ※当該購入の購入金額合計をセットしてください。送料、消費税を含む金額を推奨。
      </td>

      <td>
        ○
      </td>
    </tr>

    <tr>
      <td>
        consumptionTax
      </td>

      <td>
        数値（整数）
      </td>

      <td>
        1030
      </td>

      <td>
        消費税額
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        shippingFee
      </td>

      <td>
        数値（整数）
      </td>

      <td>
        710
      </td>

      <td>
        送料
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        items
      </td>

      <td>
        配列
      </td>

      <td>
        [  
        \{  
        itemId: 't001',  
        name: 'フリルブラウス',  
        price: 3500,  
        quantity: 1,  
        category: 'tops',  
        brand: 'SproStyle'  
        },  
        \{  
        itemId: 'b110',  
        name: 'チノパンツ',  
        price: 6800,  
        quantity: 1,  
        category: 'bottoms',  
        brand: 'SproStyle'  
        }  
        ]
      </td>

      <td>
        itemsというキーに個別商品データの配列をセットしてください。
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        items[].itemId
      </td>

      <td>
        文字列
      </td>

      <td>
        't001'
      </td>

      <td>
        アイテムに振られる任意のIDです。例として SKU ID などを想定しています。
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        items[].name
      </td>

      <td>
        文字列
      </td>

      <td>
        'フリルブラウス'
      </td>

      <td>
        商品名
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        items[].price
      </td>

      <td>
        数値（整数）
      </td>

      <td>
        3500
      </td>

      <td>
        商品価格  
        ※税抜を推奨
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        items[].quantity
      </td>

      <td>
        数値（整数）
      </td>

      <td>
        2
      </td>

      <td>
        購入商品数
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        items[].category
      </td>

      <td>
        文字列
      </td>

      <td>
        'tops'
      </td>

      <td>
        商品カテゴリ
      </td>

      <td>
        * <br />
      </td>
    </tr>

    <tr>
      <td>
        items[].brand
      </td>

      <td>
        文字列
      </td>

      <td>
        'SproStyle'
      </td>

      <td>
        商品ブランド
      </td>

      <td>
        * <br />
      </td>
    </tr>
  </tbody>
</Table>

> 🚧 購入データタグについての補足説明
>
> * `transactionId` と `totalAmount` は必須項目です。項目が存在しない場合はエラーとなり、データが送信されません。
> * `totalAmount` と `items[].price` は値が 0 でもバリデーションエラーにはならず、データが送信されます。
> * サポートしている文字コードは UTF-8 です。

> 🚧 データ連携タグについての補足説明（全タグ共通）
>
> データ連携タグの発火タイミングやバリデーションについては「[データ連携（リアルタイム取り込み）導入手順](https://developer.sprocket.bz/docs/introduce-realtime-tag)」ページを参照してください。

## JavaScript サンプル

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

```javascript
<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
  };
  SPSDK.record('purchase', props);
})();
</script>
```

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

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

```javascript
<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
    };
    SPSDK.record('purchase', props);
  }, 500);
})();
</script>
```