購入(buy)イベントをKARTEに送信することで、購入金額や購入商品に応じた施策を実施できるようになります。

設置する場所

購入完了画面などユーザーの購入が完了したページに設置を行って下さい。

  1. 計測タグ を設置してください
    計測タグを実行するとグローバルオブジェクト tracker を参照出来るようになります
    計測タグが実行されないと tracker の参照ができず、購入イベントタグ(tracker.buy)が実行出来ません
  2. 購入イベントタグ(tracker.buy)を設置してください

タグの実装方法

下記のサンプル実装を参考に、カスタマイズして実装してください。
実装には、JavaScriptの知識が必要になります。
※ タグが正常に実行されると、KARTEには「購入(buy)」という名前のイベントが発生します

タグの実装サンプル1(シンプル版)
00001というトランザクションIDで2,000円の購入があった場合は、以下のような形で実行します。

<script type="text/javascript">
    // 実際の購入情報にあわせて購入商品情報を出力してください
    try {
        tracker.buy({
            transaction_id: "00001", // トランザクションID
            revenue: 2000, // 購入金額
        });
    } catch(e) {
        if ('tracker' in window) {
            tracker.track('_error', {
                error_message: e.message
            }
        );
      }
    }
</script>

タグの実装サンプル2(カスタマイズ版)
購入された商品情報などもトラッキングしたい場合は、以下のような形でフィールドを追加し、実行します。

<script type="text/javascript">
    // 実際のアイテム数に応じて、全ての購入商品情報を出力してください
    try {
        // 購入商品情報の配列
        var items = [{
            item_id: "0001", // 商品ID
            name: "KARTE Tシャツ 黒", // 商品名
            price: 5000, // 商品単価
            quantity: 1, // 購入数量
            item_url:"https://www.example.com/item/detail/0001", // ページURL
            item_image_url:"https://image1.jpg", // 画像URL
            l_category_name: "catA", // 商品カテゴリ
            brand_name: "brandA" // 商品ブランド
        }, {
            item_id: "0002",
            name: "KARTE Tシャツ 白",
            price: 5000,
            quantity: 1,
            item_url:"https://www.example.com/item/detail/0002",
            item_image_url:"https://image2.jpg",
            l_category_name: "catA",
            brand_name: "brandB"
        }];

        tracker.buy({
            transaction_id: "00001", // トランザクションID
            revenue: 10000, // 購入金額
            items: items, // 購入商品情報の配列
            tax: 10, // 税額
            shipping: 100, // 配送料
        });
    } catch(e) {
        if ('tracker' in window) {
            tracker.track('_error', {
                error_message: e.message
            });
        }
    }
</script>

購入(buy)イベントの標準スキーマ

イベントのフィールドは自由に変更することができますが、下記のようなKARTE標準イベントスキーマで定められたフィールドを連携することを推奨しています。

下記のフィールドを連携することで、効果計測や管理画面上でのデータ表示がリッチになるなどの恩恵を受けることができます。

KARTEの標準イベントスキーマは、イベントストアにて全て定義しています。
詳細は イベントストア をご参照ください。

フィールド名 概要
transaction_id トランザクションに紐づいたユニークなIDです。
フィールドを追加することで二重計上を防げます。
"a1b2c3" 文字列
revenue 購入金額です。
平均来訪単価の計算などに必須です。
税額、送料、手数料抜きを推奨しています。
10000 数値
tax 税額です。 10 数値
shipping 送料です。 100 数値
items 購入商品の配列です。 (上記サンプルコード参照) 配列
items.item_id アイテムのユニークIDです。SKUなどを入れてください。 "a000" 文字列
items.name 商品名です。 "KARTE Tシャツ" 文字列
items.price 商品価格です。 5000 数値
items.quantity 購入商品数です。 2 数値
items.item_url 商品ページリンク先URL "https://www.example.com/item/12345" 文字列
items.item_image_url 商品画像のURL "https://image1.jpg" 文字列
items.l_category_name 商品カテゴリの大カテゴリ名です。 "インテリア" 文字列
items.s_category_name 商品カテゴリの小カテゴリ名です。 "テーブル" 文字列
items.l_category_cd 親カテゴリコード "12" 文字列
items.s_category_cd 子カテゴリコード "1234" 文字列
items.brand_name 商品ブランド名です。 "KARTE" 文字列
items.brand_cd ブランドコード "karte" 文字列
items.sku_id SKUのID "12345" 文字列
items.sku_url SKUのURL "https://www.example.com/item/12345/?sku=1" 文字列
items.sku_image_url SKUの画像URL "https://example.com/image/12345.jpg" 文字列

注意点

  • 過去の購入(buy)イベントの削除や修正には対応していません
    たとえば、購入のキャンセル発生時にイベントを消し込むことはできません。
  • データ型によって値の記述形式が異なります
    特に数値で送るデータと文字列で送るデータで間違った形でデータが送られて計測できないケースがありますのでご注意ください。

うまく取得できない場合のチェックポイント

下記ドキュメントをご覧ください。

各種カートシステムで購入(buy)イベントタグを設置する

ECサイトで下記のカートシステムをご利用の場合は、各カート専用の購入イベントタグ設置方法がございます。
以下の各ページでご確認ください。