トランザクションタグの実装

トランザクションタグの設置

AB Tastyでは、お客様のウェブサイトで行われた取引に関するデータ（取引金額、支払い方法、購入商品数など）と、購入商品に関する情報（カートの平均金額、商品価格など）を保存することができます。

このデータは、指標やフィルターの形で各キャンペーンのレポートで利用できます。これについては、「新しいレポート：トランザクション指標とEコマースデータ」を参照してください。

トランザクションデータをAB Tastyに送信し、レポートに表示するには、購入確認ページでAB Tastyの一般タグの後にトランザクションタグを追加する必要があります。トランザクションタグは、3つの方法で実装できます。

トランザクションタグがウェブサイトに実装されたら、先にQAプロセスを実行することができます。詳細については、「トランザクションタグのQA」を参照してください。

トランザクションタグへのアクセス

1. 「AB Tasty」のダッシュボードにアクセスします。

2. 「歯車」→「設定」→「タグの実装」→「トランザクションスタグ」をクリックします。

3. 「Copy to clipboard」をクリックして、購入確認画面にコードを貼り付けます。

4. 自社のデータに基づいて設定を変更します。

タグ構成

トランザクションタグには2つの部分があり、1つ目はトランザクションに関する情報（ID、名前、金額、配送料など）を送信することができ、2つ目はウェブサイトを訪れたお客様が購入した商品に関するアイテムや商品の詳細を送信することができます。

トランザクションの設定

トランザクションの設定は、購入に関連する一般的な情報と一致します。必要に応じて、この情報にアイテムに関する設定を追加することができます。

tid、ta、tr、およびicnの設定は、トランザクションタグの実装時に宣言する必要があります。その他の設定はオプションですが、後でレポートにマッチングフィルタを適用できるようにするために、これらの設定も行うことをお勧めします。

パラメータ名	意味	定義	例
tid	トランザクションID	トランザクションIDと一致しています。	tid: "OD564"
ta	トランザクションの所属	設定するゴールのリストに表示される、トランザクションに割り当てられた名前と一致しています。	ta: "Purchase"
tr	取引収入	取引金額と一致しています。税金と配送料を含みます。	tr:15000
ts	トランザクションの出荷	配送料の支払い期限と一致します。	ts: 1000
tt	取引税	納税の時期と一致します。	tt: 10.00
tc	取引通貨	トランザクションで使用される通貨と一致しています。	tc: "YEN"
tcc	トランザクションのクーポンコード	決済時に使用した割引クーポンとの併用が可能です。	tcc: "Coupon"
PM	支払方法	トランザクションで使用された支払い方法と一致しています。	pm: "Paypal"
sm	配送方法	配信タイプと一致しています。	sm"Fedex"
icn	アイテムのカウント数	トランザクション中に購入されたアイテムの合計数と一致します。	icn:12

取引額と通貨に関する情報は収集されますが、通貨換算は行われません。値は、ウェブサイトで収集されたものと同様に、レポートに表示されます。

アイテム別設定

購入したアイテムに関連する情報を、各取引にリンクさせることができます。そのためには、トランザクションタグの「アイテム」セクションで、トランザクションに関する設定に加えて、以下の設定を行う必要があります。

tidとinの設定を宣言する必要があります。特に、tidの設定は、メインのトランザクションに対して宣言されたものと一致しなければなりません。

パラメータ名	意味	定義	例
tid	トランザクションID	トランザクションIDと一致しています。	tid: "OD564"
in	アイテム名	アイテム名と一致しています。	in: "Shoe"
ip	商品価格	アイテムの価格と連動しています。	ip: 3.5
iq	アイテム数	トランザクション中にアイテムが購入された回数と一致しています。	iq:4
ic	アイテムコード	アイテムのSKU（ストックキーピングユニット）と一致しています。	ic:"SKU47"
iv	項目カテゴリー	そのアイテムが属するカテゴリーと一致していること。	iv: "Blue"

アイテムに関する設定のJavaScriptによる実装については、開発者向けドキュメントをご参照ください。

タグの実装方法

トランザクションタグは、3つの異なる方法で実装できます。

• 上記のように、Webサイトの購入確認ページのソースコードにtransactionタグを実装することをお勧めします。私たちの例をご覧ください。
• また、タグマネジメントシステム（TMS）を介してタグを実装することもできます。TMSでは、トランザクションの設定やアイテムに関する設定を宣言することができます。詳しくは、ページ最下部の「タグマネジメントシステムで実装する場合の推奨事項」をご参照ください。

• 最後に、AB Tastyタグを使って、購入確認ページにJavaScriptの命令を自動的に注入することができます。この場合、グローバルコード機能を使用しますので、ページのソースコードを変更する必要はありません。詳しくは、グローバルコードオプションをご参照ください。

コードの実装例

トランザクションタグを実装する最も良い方法は、ウェブサイトの購入確認ページのソースコード内に実装することです。下記のコードテンプレートをご利用ください。

トランザクションタグを実装するには、以下の手順で行います。

１．以下のコードをすべてコピーして、確認ページに貼り付けてください。

これは一般的なトランザクションタグで、変数はあなたのウェブサイトに固有のものです。

// transaction tag <script> window.abtasty.send(“transaction”, { tid: __TRANSACTION_ID__, // Format: STRING, value example: “OD564" ta: __TRANSACTION_NAME__, // Format: STRING, value example: “Purchase” tr: __TRANSACTION_REVENUE__, // Format: FLOAT, value example: 15.47 ts: __TRANSACTION_SHIPPING__, // Format: FLOAT, value example: 3.5 tt: __TRANSACTION_TAXES__, // Format: FLOAT, value example: 2.60 tc: __TRANSACTION_CURRENCY__, // Format: STRING, value example: “EUR” tcc: __TRANSACTION_COUPON_CODE__, // Format: STRING, value example: “Coupon” pm: __TRANSACTION_PAYMENT_METHOD__, // Format: STRING, value example: “Paypal” sm: __TRANSACTION_SHIPPING_METHOD__, // Format: STRING, value example: “Fedex” icn: __TRANSACTION_ITEM_COUNT_NUMBER__ // Format: INTEGER, value example: 12 }); </script>

// Some code

// transaction items tag <script> window.abtasty.send(“item”, { “tid”: __TRANSACTION_ID__, // Format: STRING, value example: “OD564” “in”: __TRANSACTION_ITEMS[i].ITEM_NAME__, // Format: STRING, value example: “Shoe” “ip”: __TRANSACTION_ITEMS[i].ITEM_PRICE__, // Format: FLOAT, value example: 3.5 “iq”: __TRANSACTION_ITEMS[i].ITEM_QUANTITY__, // Format: INTEGER, value example: 4 “ic”: __TRANSACTION_ITEMS[i].ITEM_CODE__, // Format: STRING, value example: “SKU47” “iv”: __TRANSACTION_ITEMS[i].ITEM_CATEGORY__ // Format: STRING, value example: “Blue” }); </script>

2.TRANSACTION_XXX__の値を、あなたのソースコードやデータレイヤーにある独自のデータで置き換えます。

3.値に適切なフォーマット（文字列、浮動小数点、整数）を適用します。

4.コードにループを作成し、トランザクションに含まれるアイテムの数だけループが発生するようにします。

トランザクションアイテムの場合、キー/値のペアは、トランザクションの各アイテムに固有のものです。

トランザクションに複数のアイテムが含まれている場合、Transaction Itemsはトランザクションのアイテム数だけ送信する必要があります。

トランザクションアイテムは、各アイテムごとに独立して送信する必要があります。

ソースコードに実装する際の推奨事項

・トランザクションパラメーターとアイテムパラメーターの名前を変更してはいけません。

・TRANSACTION_XXX__`の値を置き換える際には、前後のオープニングやクロージングのダブルアンダースコア`__`は残しません。

・各行の最後には必ずコンマ `,` を入れてください（最終行を除いて、コンマは必須ではありません）。

・inパラメータの値の形式が文字列であっても、二重 " " や一重 ' ' を引用符で囲んではいけません。

・トランザクションタグをページの一番下、つまりジェネリックタグのずっと後に実装します。transactionタグはgenericタグの後に起動する必要がありますが、ページの一番下に配置することで、genericタグがすでに起動していること、そしてtransactionタグが依存しているすべての値がロードされていることを保証します。

タグマネジメントシステムで導入する際の推奨事項

・必ずジェネリックタグをページの一番上の位置に実装してから実行してください。

・トランザクションタグは2番目の位置、つまりジェネリックタグの後に実装してください。そうしないと、`AB Tasty is undefined`というエラーメッセージが表示されます。