イベントタイプ

Fintezaには8種類の電子商取引イベントを送信できます。

View Item — 製品の表示
Add To Cart and Remove From Cart — カートへの製品の追加と削除
View Cart — カートの表示
Checkout Begin and Checkout Progress — チェックアウトの開始と継続
Checkout Success — 購入の正常な完了
Checkout Failed — 購入の失敗
Refund — 購入返金

その他のすべてのイベントは、Finteza側の電子商取引レポートには含まれません。

View Item #

このイベントは、製品が表示されたことを示します。表示された商品の特性は、イベントで指定されます。

fz('ecommerce', {
  "event": "View Item",
  "items": [
    {
      "id": "P12345",
      "name": "USB Charger",
      "brand": "ChargeIt",
      "category": "Accessories",
      "variant": "Black",
      "quantity": 2,
      "currency": "USD",
      "price": 2.00,
      "list_name": "Search Results",
      "list_position": 1
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "quantity": 1,
      "currency": "USD",
      "price": 3.00,
      "list_name": "Search Results",
      "list_position": 2
    }
  ]
});

その結果、2 つ（説明された各商品に1つずつ）の「View Item」イベントがFintezaに作成されます。

Add To Cart / Remove From Cart #

これらのイベントは、製品がカートに追加またはカートから削除されたときに使用されます。製品の説明に加えて、イベントのcart_idパラメータにカートIDを含める必要があります（IDはWebサイトによって生成されます）。

fz('ecommerce', {
  "event": "Add To Cart",
  "cart_id": "C89367",
  "items": [
    {
      "id": "P12345",
      "name": "USB Charger",
      "brand": "ChargeIt",
      "category": "Accessories",
      "variant": "Black",
      "quantity": 2,
      "currency": "USD",
      "price": 2.00,
      "list_name": "Search Results",
      "list_position": 1
    },
    {
      "id": "P67890",
      "name": "Finteza TShirt",
      "brand": "Finteza",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "quantity": 1,
      "currency": "USD",
      "price": 3.00,
      "list_name": "Search Results",
      "list_position": 2
    }
  ]
});

その結果、2 つ（説明された各商品に1つずつ）の「Add To Cart」イベントがFintezaに作成されます。指定されたカートIDはそれぞれのイベントに追加されます。

カートからの削除イベントではlist_nameおよびlist_positionパラメータを渡さないでください。これらのパラメータは、商品がカートに追加されたリストを説明するため、削除イベントでは意味がありません。

View Cart #

このイベントはカートの表示に関係しています。このイベントには、カートのコストに関する情報と、ある場合には追加のプロバイダー（税金、割引、純利益）に関する情報が含まれます。個々の製品に対して追加パラメータを指定することもできます。

fz('ecommerce', {
  "event": "View Cart",
  "cart_id": "C89367",
  "cart_items": 2,
  "currency": "USD",
  "value": 7.07,
  "tax_value": 0.7,
  "tax_name": "Tax",
  "tax_type": "Tax type",
  "discount_value": 1,
  "discount_name": "Black Friday",
  "discount type": "B112029",
  "discount type": "B112029"
  "items": [
    {
      "id": "P12345",
      "name": "USB Charger",
      "brand": "ChargeIt",
      "category": "Accessories",
      "variant": "Black",
      "quantity": 2,
      "currency": "USD"
      "price": 2.00,
      "value": 4.24
    },
    {
      "id": "P67890",
      "name": "Finteza TShirt",
      "brand": "Finteza",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "quantity": 1,
      "currency": "USD"
      "price": 3.00,
      "value": 2.83
    }
  ]
});

Fintezaでは、次の 3 つのイベントが作成されます。

各製品の「View Cart」イベント。このイベントにはcart_idが含まれます。
カートの「View Cart」イベント。cart_idが指定されていない場合、イベントは生成されません。

Checkout Begin / Checkout Progress #

これらは購入開始イベントと継続イベント（ユーザがすでに製品をカートに追加していてチェックアウトに進んだ場合）です。

ここでは、「View Cart」段階で使用されるパラメータに加えて、購入段階に関する情報を渡すことができます。割引や使用済みクーポンの情報もここで修正できます。

fz('ecommerce', {
  "event": "Checkout Begin",
  "cart_id": "C89367",
  "cart_items": 2,
  "currency": "USD",
  "value": 7.07,
  "tax_value": 0.7,
  "tax_name": "Tax",
  "tax_type": "Tax type",
  "discount_value": 1,
  "discount_name": "Black Friday",
  "discount type": "B112029",
  "shipping_value": 0.3,
  "shipping_name": "Shipping",
  "shipping_type": "Shipping Type",
  "checkout_step": 1,
  "checkout_option" : "Shipping"
  "items": [
    {
      "id": "P12345",
      "name": "USB Chargers",
      "brand": "ChargeIt",
      "category": "Accessories",
      "variant": "Black",
      "quantity": 2,
      "currency": "USD"
      "price": 2.00,
      "value": 4.24,
      "tax_value": 0.4,
      "tax_name": "Tax",
      "tax_type": "Tax type",
      "shipping_value": 0.2,
      "shipping_name": "Shipping",
      "shipping_type": "Standard Post"
    },
    {
      "id": "P67890",
      "name": "Finteza TShirt",
      "brand": "Finteza",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "quantity": 1,
      "currency": "USD"
      "price": 3.00,
      "value": 2.83,
      "tax_value": 0.3,
      "tax_name": "Tax",
      "tax_type": "Tax type",
      "discount_value": 0.6,
      "discount_name": "Black Friday",
      "discount type": "B112029"
    }
  ]
});

Fintezaでは、次の 3 つのイベントが作成されます。

各商品の「Checkout Begin」イベント。このイベントには、カートの説明からcart_id、checkout_step、checkout_optionが含まれます。
カートの「Checkout Begin」イベント。cart_idが指定されていない場合、イベントは生成されません。

Checkout Success #

このイベントは、購入が正常に完了したことを意味します。前回のイベントの情報に加えて、ここで支払いID（transaction_id）とストアデータ（affiliate）を指定することができます。以下を追加指定できます。

購入者名（buyer）と販売者名（seller）。上位の販売者と購入者のレポートは、多くのサードパーティ販売者がサイトで活動している場合に役立ちます<分節 0198>
取引の支払いシステム手数料（transaction_fee）。
純売上高、純手数料、税金、手数料（profit）。

fz('ecommerce', {
  "event": "Checkout Success",
  "transaction_id": "CH38027",
  "affiliation": "Online store",
  "buyer": "john_smith",
  "seller": "Europe Shop",
  "cart_id": "C89367",
  "cart_items": 2,
  "currency": "USD",
  "value": 7.07,
  "profit": 2,
  "transaction_fee": 0.07,
  "tax_value": 0.7,
  "tax_name": "Tax",
  "tax_type": "VAT",
  "discount_value": 1,
  "discount_name": "Black Friday",
  "discount type": "B112029",
  "shipping_value": 0.3,
  "shipping_name": "Shipping",
  "shipping_type": "Standard Post",
  "checkout_step": 1,
  "checkout_option" : "Shipping",
  "items": [
    {
      "id": "P12345",
      "name": "USB Charger",
      "brand": "ChargeIt",
      "category": "Accessories",
      "variant": "Black",
      "quantity": 2,
      "currency": "USD"
      "price": 2.00,
      "value": 4.24,
      "profit": 1.6,
      "transaction_fee": 0.04,
      "tax_value": 0.4,
      "tax_name": "Tax",
      "tax_type": "VAT",
      "discount_value": 0.4,
      "discount_name": "Black Friday",
      "discount type": "B112029",
      "shipping_value": 0.2,
      "shipping_name": "Shipping",
      "shipping_type": "Standard Post",
    },
    {
      "id": "P67890",
      "name": "Finteza TShirt",
      "brand": "Finteza",
      "category": "T-Shirts",
      "variant": "Red",
      "quantity": 1,
      "currency": "USD"
      "price": 3.00,
      "value": 2.83,
      "profit": 0.4,
      "transaction_fee": 0.03,
      "tax_value": 0.3,
      "tax_name": "Tax",
      "tax_type": "VAT",
      "discount_value": 0.6,
      "discount_name": "Black Friday",
      "discount type": "B112029"
      "shipping_value": 0.1,
      "shipping_name": "Shipping",
      "shipping_type": "Standard Post",
    }
  ]
});

Fintezaでは、次の 3 つのイベントが作成されます。

各商品の「Checkout Success」イベント。このイベントには、カートの説明からtransaction_id、affiliation、cart_id、checkout_step、checkout_optionが含まれます。
カートの「Checkout Success」イベント。cart_idが指定されていない場合、イベントは生成されません。

Checkout Failed #

このイベントは、注文の支払いに失敗したことを反映しています。前のイベントとは異なり、このイベントには transaction_idが含まれていませんが、detailパラメータにエラーの説明が含まれています。

fz('ecommerce', {
  "event": "Checkout Failed",
  "detail": "WebMoney Payment Error",
  "cart_id": "C89367",
  "cart_items": 2,
  "currency": "USD",
  "value": 7.07,
  "checkout_step": 1,
  "checkout_option" : "Shipping",
  "items": [
    {
      "id": "P12345",
      "name": "USB Charger",
      "brand": "ChargeIt",
      "category": "Accessories",
      "variant": "Black",
      "quantity": 2,
      "currency": "USD"
      "price": 2.00,
      "value": 4.24,
    },
    {
      "id": "P67890",
      "name": "Finteza TShirt",
      "brand": "Finteza",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "quantity": 1,
      "currency": "USD"
      "price": 3.00,
      "value": 2.83,
    }
  ]
});

Fintezaでは、次の 3 つのイベントが作成されます。

各商品の「Checkout Failed」イベント。このイベントには、カートの説明からdetail、cart_id、 checkout_step、checkout_optionが含まれます。
カートの「Checkout Failed」イベント。cart_idが指定されていない場合、イベントは生成されません。

Refund #

このイベントは製品の払い戻しを反映しています。イベントには、元の支払いにリンクする支払い識別子transaction_idと、の払い戻し理由の説明（detailパラメータ）が含まれます。

fz('ecommerce', {
  "event": "Refund",
  "transaction_id": "P7788112313",
  "detail": "Broken",
  "cart_id": "C89367",
  "cart_items": 2,
  "currency": "USD",
  "value": 7.07,
  "items": [
    {
      "id": "P12345",
      "name": "USB Charger",
      "brand": "ChargeIt",
      "category": "Accessories",
      "variant": "Black",
      "quantity": 2,
      "currency": "USD"
      "price": 2.00,
      "value": 4.24,
    },
    {
      "id": "P67890",
      "name": "Finteza TShirt",
      "brand": "Finteza",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "quantity": 1,
      "currency": "USD"
      "price": 3.00,
      "value": 2.83,
    }
  ]
});

Fintezaでは、次の 3 つのイベントが作成されます。

各商品の「Refund」イベント。このイベントには、カートの説明からtransaction_id、detail、 cart_idが含まれます。
カートの「Refund」イベント。cart_idが指定されていない場合、イベントは生成されません。