Tipos de eventos

Usted puede enviar a Finteza 8 tipos de eventos de E-Commerce:

Cualquier otro evento no entrará en los informes de E-Commerce en el lado de Finteza.


View Item #

Es el evento de visualización de un producto. En este se muestran las características del producto visualizado:

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

Como resultado, en Finteza se crearán 2 eventos "View Item", uno para cada producto descrito.

Add To Cart / Remove From Cart #

Es el evento de adición y eliminación de productos en la cesta. Aquí, aparte de la descripción del producto, se deberá transmitir el identificador de la cesta en el parámetro cart_id (el identificador deberá ser generado por su sitio 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
    }
  ]
});

Como resultado, en Finteza se crearán 2 eventos "Add To Cart", uno para cada producto descrito. En este caso, además, a cada evento se añadirá el identificador de cesta indicado.

Para el evento de eliminación de un producto de la cesta, no deberá transmitir los parámetros list_name y list_position. Estos describen la lista desde la que se han añadido los productos, y no tienen sentido para el evento de eliminación.

View Cart #

Es el evento de visualización de la cesta. Aquí se añade información sobre el valor de la cesta, así como parámetros adicionales, si están disponibles: impuestos, descuentos, beneficio neto. También se pueden indicar parámetros adicionales para productos individuales.

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

Como resultado, en Finteza se crearán 3 eventos:

  • Un evento "View Cart" para cada uno de los productos. En ellos se indicará el cart_id.
  • Evento "View Cart" para la cesta. Si el cart_id no ha sido indicado, el evento no se generará.

Checkout Begin / Checkout Progress #

Estos son los eventos de comienzo y continuación de la compra, cuando el usuario ya ha añadido productos a la cesta y procede al pago.

Además de los parámetros usados en la etapa "View Chart", aquí se puede transmitir información sobre la etapa de compra. Aquí también es posible corregir información sobre los descuentos y cupones utilizados.

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

Como resultado, en Finteza se crearán 3 eventos:

  • Un evento "Checkout Begin" para cada uno de los productos. En ellos se indicarán cart_id, checkout_step y checkout_option, tomados de la descripción de la cesta.
  • Evento "Checkout Begin" para la cesta. Si el cart_id no ha sido indicado, el evento no se generará.

Checkout Success #

Es el evento de finalización exitosa de la compra. Como complemento a la información del evento anterior, se puede indicar el identificador del pago (transaction_id) y los datos de la tienda (affiliate). Asimismo, aquí se puede indicar:

  • El nombre del comprador (buyer) y el vendedor (seller). Los informes sobre los mejores compradores y vendedores resultarán útiles si usted ofrece su sitio web para el trabajo de múltiples vendedores externos.
  • Comisión del sistema de pago para la transacción (trabsaction_fee).
  • Beneficio neto de la venta descontando comisiones, impuestos y tasas (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",
    }
  ]
});

Como resultado, en Finteza se crearán 3 eventos:

  • Un evento "Checkout Succes" para cada uno de los productos. En ellos se indicarán transaction_id, affiliation, cart_id, checkout_step, checkout_option, tomados de la descripción de la lista.
  • Evento "Checkout Success" para la cesta. Si el cart_id no ha sido indicado, el evento no se generará.

Checkout Failed #

Es el evento de intento fallido de pago del pedido. A diferencia del anterior evento, aquí no se indica el identificador de transacción transaction_id, pero sí que se añade la descripción del error 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,
    }
  ]
});

Como resultado, en Finteza se crearán 3 eventos:

  • Un evento "Checkout Failed" para cada uno de los productos. En ellos se indicarán detail, cart_id, checkout_step, checkout_option, tomados de la descripción de la cesta.
  • Evento "Checkout Failed" para la cesta. Si el cart_id no ha sido indicado, el evento no se generará.

Refund #

Es el evento de devolución del productos. Aquí se indica el identificador de pago transaction_id para establecer conexión con el pago inicial y describir el motivo de la devolución en el parámetro 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,
    }
  ]
});

Como resultado, en Finteza se crearán 3 eventos:

  • Un evento "Refund" para cada uno de los productos. En ellos se indicarán transaction_id, detail, cart_id, tomados de la descripción de la cesta.
  • Evento "Refund" para la cesta. Si el cart_id no ha sido indicado, el evento no se generará.