事件类型

八种电子商务事件类型可以发送到Finteza:

所有其他事件不包含在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
    }
  ]
});

结果,将在Finteza中创建两个“浏览产品”事件,其中一个适用于每个描述的产品。

Add To Cart和Remove From Cart #

当产品添加到购物车或从购物车删除时,使用这些事件。除产品说明之外,该事件还应在cart_id参数中包含购物车ID(该ID应由您的网站生成)。

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
    }
  ]
});

结果,将在Finteza中创建两个“添加到购物车”事件,其中一个适用于每个描述的产品。指定的购物车ID将被添加到每个事件。

不要为了从购物车事件中删除而传递list_namelist_position参数。它们描述了将产品添加到购物车的列表,因此它们对于删除事件没有任何意义。

View Cart #

该事件与浏览购物车有关。该事件包含有关购物车成本以及其他提供商(如果有)的信息:税费、折扣、净利润。还可以为单个产品指定附加参数cab。

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中创建:

  • 每个产品的“浏览购物车”事件。该事件将包括cart_id
  • 购物车的“浏览购物车”事件。如果没有指定cart_id,则该事件将不会生成。

Checkout Begin / Checkout Progress #

这些是开始购买和继续购买的事件 ― 当用户已经将产品添加到购物车并进行付款时。

除了在“浏览购物车”阶段使用的参数外,有关购买阶段的信息也可在这里传递。关于折扣和使用优惠券的信息也可以在这里更正。

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中创建:

  • 每个产品的“付款开始”事件。这些事件将包括来自购物车描述的cart_idcheckout_stepcheckout_option参数。
  • 购物车的“付款开始”事件。如果没有指定cart_id,则该事件将不会生成。

Checkout Success #

该事件意味着购买成功完成。除了上一个事件的信息之外,还可以在此处指定付款(transaction_id)和存储数据(affiliate)。还可以指定以下内容:

  • 买家名(buyer)和卖家名(seller)。如果您的网站上有许多第三方卖家,则最受欢迎的卖家和买家报告将很实用。
  • 交易的付款系统费用(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中创建:

  • 每个产品的“付款成功”事件。这些事件将包括来自购物车描述的transaction_idaffiliationcart_idcheckout_stepcheckout_option参数。
  • 购物车的“付款成功”事件。如果没有指定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中创建:

  • 每个产品的“付款失败”事件。这些事件将包括来自购物车描述的detailcart_idcheckout_stepcheckout_option参数。
  • 购物车的“付款失败”事件。如果没有指定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中创建:

  • 每个产品的“退款”事件。这些事件将包括来自购物车描述的transaction_iddetailcart_id参数。
  • 购物车的“退款”事件。如果没有指定cart_id,则该事件将不会生成。