---
updatedAt: 2025-02-11T23:04:33.000Z
agentTools:
  projectIndex: https://developer.sprocket.bz/llms.txt
---

# ecbeing

ecbeing で Sprocket のデータ連携機能を利用するためのタグ設置方法を説明します。

## スタートアップガイド

* ecbeingを使用しているサイトにおいて、Google Tag Manager (GTM) を使って Sprocket タグ及びデータ連携（リアルタイム取り込み）を導入する手順について説明します。
* 本機能は ecbeing バージョン 10.6 以降, 及び GTM の両方を使用している場合にご利用いただけます。

## 目次

* ecbeing で利用できるデータ項目
* ユーザー属性タグ
* 購入データタグ
* ecbeing への Sprocket 導入手順
* GTMタグセットのインポート
* Sprocket API Keyの設定
* 公開と動作確認

## ecbeing で利用できるデータ項目

> 📘 ecbeing で利用できるデータ項目
>
> ecbeing において下記手順でデータ連携を実施する場合、デフォルトで利用できるデータ項目は下記です。\
> データ連携（リアルタイム取り込み）の仕様についてはデータ連携（リアルタイム取り込み）の各タグの説明ページを参照ください。

## ユーザー属性タグ

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

      <th style={{ textAlign: "left" }}>
        概要
      </th>

      <th style={{ textAlign: "left" }}>
        値（Value）のサンプル
      </th>

      <th style={{ textAlign: "left" }}>
        セグメント条件での使用
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        userId
      </td>

      <td style={{ textAlign: "left" }}>
        ユーザーを識別するユニークなID\
        ※ この項目があると会員ID連携されます
      </td>

      <td style={{ textAlign: "left" }}>
        '123456'
      </td>

      <td style={{ textAlign: "left" }}>
        *
      </td>
    </tr>
  </tbody>
</Table>

## 購入データタグ

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

      <th style={{ textAlign: "left" }}>
        概要
      </th>

      <th style={{ textAlign: "left" }}>
        値（Value）のサンプル
      </th>

      <th style={{ textAlign: "left" }}>
        セグメント条件での使用
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        transactionId
      </td>

      <td style={{ textAlign: "left" }}>
        購入トランザクションに紐づいた一意なID
      </td>

      <td style={{ textAlign: "left" }}>
        '123456'
      </td>

      <td style={{ textAlign: "left" }}>
        *
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        totalAmount
      </td>

      <td style={{ textAlign: "left" }}>
        購入金額合計\
        ※当該購入の購入金額合計をセットしてください。送料、消費税を含む金額を推奨。
      </td>

      <td style={{ textAlign: "left" }}>
        7350
      </td>

      <td style={{ textAlign: "left" }}>
        ○
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        shippingFee
      </td>

      <td style={{ textAlign: "left" }}>
        送料
      </td>

      <td style={{ textAlign: "left" }}>
        960
      </td>

      <td style={{ textAlign: "left" }}>
        *
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        items
      </td>

      <td style={{ textAlign: "left" }}>
        itemsというキーに個別商品データの配列をセットしてください。
      </td>

      <td style={{ textAlign: "left" }}>
        [\
          \{\
            itemId: '4774192627',\
            name: 'Amazon Web Services負荷試験入門',\
            price: 3800,\
            quantity: 1,\
            category: 'book',\
            brand: '技術評論社'\
          },\
          \{\
            itemId: '4295000159',\
            name: 'いちばんやさしいコンバージョン最適化の教本',\
            price: 1922,\
            quantity: 1,\
            category: 'book',\
            brand: 'インプレス'\
          }\
        ][
          \{
            itemId: '4774192627',
            name: 'Amazon Web Services負荷試験入門',
            price: 3800,
            quantity: 1,
            category: 'book',
            brand: '技術評論社'
          },
          \{
            itemId: '4295000159',
            name: 'いちばんやさしいコンバージョン最適化の教本',
            price: 1922,
            quantity: 1,
            category: 'book',
            brand: 'インプレス'
          }
        ]
      </td>

      <td style={{ textAlign: "left" }}>
        *
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        items\[].itemId
      </td>

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

      <td style={{ textAlign: "left" }}>
        '4295000159'
      </td>

      <td style={{ textAlign: "left" }}>
        *
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        items\[].name
      </td>

      <td style={{ textAlign: "left" }}>
        商品名
      </td>

      <td style={{ textAlign: "left" }}>
        'いちばんやさしいコンバージョン最適化の教本'
      </td>

      <td style={{ textAlign: "left" }}>
        *
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        items\[].price
      </td>

      <td style={{ textAlign: "left" }}>
        商品価格\
        ※税抜を推奨
      </td>

      <td style={{ textAlign: "left" }}>
        1922
      </td>

      <td style={{ textAlign: "left" }}>
        *
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        items\[].quantity
      </td>

      <td style={{ textAlign: "left" }}>
        購入商品数
      </td>

      <td style={{ textAlign: "left" }}>
        2
      </td>

      <td style={{ textAlign: "left" }}>
        *
      </td>
    </tr>
  </tbody>
</Table>

## ecbeing への Sprocket 導入手順

下記の項目では Sprocket タグ 及び データ連携（リアルタイム取り込み）導入のための GTM 設定手順について説明します。

> 📘 下記の設定を始める前に
>
> 事前に接客を行いたいページへ GTM タグを埋め込み、GTM が使える状態にしておいてください。

## GTM タグセットのインポート

> 👍 このセクションで行うこと
>
> ecbeing と Sprocket との連携には GTM タグセットを利用します。GTM タグセットにはSprocket へのデータ送信を行うための設定が一通り入っており、GTM タグセットのインポートと簡単な設定を行うだけで Sprocket の導入が完了します。\
> このセクションでは GTM へのタグセットのインポート手順を解説します。

弊社のメンバーより GTM タグセットを受けとってください。

Google Tag Manager の管理画面を開きます。トップ画面で［管理］を選択します。

<Image className="border" width="80%" border={true} src="https://files.readme.io/793107d-Google___2020-08-21_18-32-43.png" />

［コンテナをインポート］を選択します。

<Image className="border" width="80%" border={true} src="https://files.readme.io/df0b09f-Google___2020-08-21_18-33-54.png" />

コンテナファイルを選択を押下し、弊社メンバーより受け取っているタグセットを選択します。

<Image className="border" width="80%" border={true} src="https://files.readme.io/3ec7f58-Google___2020-08-21_18-35-19.png" />

ワークスペースを選択します。既存のワークスペースを使うか、新規のワークスペースを使うか選択します。特に理由がないのであれば新規ワークスペースを選択することをお勧めします。ここでは新規ワークスペースを選択した場合の手順を説明します。

> 📘 既存ワークスペースを使う場合
>
> 既存ワークスペースを使うこともできますが、その場合は既存の変更を打ち消してしまったりといったトラブルが発生することがありますので、注意して作業を進めてください。ワークスペースの数が足りない時などを除いて、基本的には新規ワークスペースを使うことが推奨です。

<Image className="border" width="80%" border={true} src="https://files.readme.io/39eb8bf-Google___2020-08-21_18-37-19.png" />

新規ワークスペースを選択した場合は、ワークスペースを新たに作成します。下記の入力蘭を適当に埋め、保存を選択してください。

<Image className="border" width="80%" border={true} src="https://files.readme.io/bbf35cc-Google___2020-08-21_18-40-40.png" />

この様になれば OK です。

<Image className="border" width="80%" border={true} src="https://files.readme.io/2898a24-Google___2020-08-21_18-42-02.png" />

最後にインポートオプションを選択します。下記の様に選択してください。

<Image className="border" width="80%" border={true} src="https://files.readme.io/9cbecca-Google___2020-08-21_18-42-58.png" />

インポートのプレビューと確認に変更が表示されるので、更新や削除などの危険な変更がないかどうか、あるならば問題のない変更であるかどうかを確認してください。\
問題がなければ最後に確認を選択してください。

<Image className="border" width="80%" border={true} src="https://files.readme.io/c38b170-Google___2020-08-21_18-44-11.png" />

ここまでの手順で、新規に作成したワークスペースに Sprocket 連携用のタグセットが設置された状態になります。

## Sprocket サービスIDの設定

> 👍 このセクションで行うこと
>
> このセクションでは Sprocket タグを使用するためのサービスIDを設定します。\
> こちらを設定すれば GTM のセットアップは完了です。

Sprocket タグを発火させるには、変数 `const_sprocket_service_id` に［Sprocket サービスID］を設定する必要があります。管理画面から新規に作成したワークスペースを選択し、 `変数 > const_sprocket_apikey` の順に選択して画像の様な画面を出してください。

<Image className="border" width="80%" border={true} src="https://files.readme.io/3b3b29e-1.png" />

画像の文字列入力欄に［Sprocket サービスID］を入力して保存してください。\
［Sprocket サービスID］は Sprocket管理画面 > タグ情報 > サービスID より取得するか、もしくは担当コンサルタントから受け取ってください。

<Image className="border" width="80%" border={true} src="https://files.readme.io/5b6c336-2.png" />

ここまでの手順を行えば GTM の設定は完了です。

> 📘 GTM コンテナの公開
>
> この段階ではまだサイト上で Sprocket タグは動作していません。GTM コンテナの公開を行うことで、ワークスペースに加えた変更がサイトに反映されます。

## 公開と動作確認

> 👍 このセクションで行うこと
>
> コンテナを公開したら実サイトで Sprocket の稼働が開始します。\
> このセクションでは、コンテナの公開後に Sprocket がサイト上で稼働していることをチェックする手順を説明します。

コンテナの公開を行うと Sprocket が実サイト上で稼働した状態になります。

公開を行ったら、サイト上で Sprocket が動作していることを確認します。\
下記の動作確認コマンドを埋込先サイトの URL バーに入力し、Enter を押してください。

javascript:(alert(SPSDK.params.services))

> 🚧 チェックの際の注意
>
> 上記のコマンドを URL バーへコピーペーストすると、外側の javascript( ) の文字列がストリップされてしまうことがあります。その場合には手打ちで javascript( ) を追記し、上記のコマンドと同じ文字列をURLバーに入力してからコマンドを実行してください。

画像のように ID 文字列が表示されれば Sprocket が動作しています。

<Image className="border" width="80%" border={true} src="https://files.readme.io/ff97ae4-842aadf-examination.sakura.ne.jp__2020-04-17_19-10-33.png" />

以上で Sproket の設置は完了です。