IntegracionesFinteza JavaScript ClientE-Commerce

E-Commerce

Si usted tiene una tienda online, Finteza le ayudará a conseguir análisis detallados de la misma, gracias al soporte de eventos de E-Commerce. Configurando el envío en su sitio web, podrá:

  • Descubrir qué productos y marcas son populares
  • Determinar el volumen de ventas real
  • Estimar el beneficio no realizado, cuando un comprador potencial no completa una compra por algún motivo.

Y esta ni siquiera es la lista de información completa que podrá obtener. Encontrará más información en el artículo "Finteza dispone ahora de e-Commerce".

Cómo funciona esto #

El E-Commerce funciona de forma similar a los eventos. De la misma forma, podrá establecer un código de seguimiento en su sitio web, y después añadir a las páginas las funciones necesarias para el envío de eventos: por ejemplo, al superar una nueva etapa de la compra, añadir un producto a la cesta, etcétera.

A diferencia de los eventos normales, los códigos de seguimiento de E-Commerce poseen un conjunto de parámetros bastante mayor. Estos se utilizan para representar los datos en informes especiales en el panel de Finteza:

Informe de e-Commerce en Finteza

Cómo enviar los eventos de E-Commerce #

Después de activar Finteza JavaScript Client, podrá enviar eventos de E-Commerce. Para ello, añada a la página de su sitio web el código JavaScript con el aspecto siguiente:

fz("ecommerce", {
  "event""{EVENT_NAME}"
  "{CART_PARAMETER1}""CART_VALUE1",
  "{CART_PARAMETER2}""CART_VALUE2",
  ...
  "items": [
    {
     "ITEM1_PARAMETER1""ITEM1_VALUE1",
     "ITEM1_PARAMETER2""ITEM1_VALUE2",
     ...
    },
    {
     "ITEM2_PARAMETER1""ITEM2_VALUE1",
     "ITEM2_PARAMETER2""ITEM2_VALUE2",
     ...
     },
     ...
  ]
} );

En lugar de {EVENT_NAME}, indique el nombre de un evento de la lista de disponibles, por ejemplo "View Item".

A continuación, añada la descripción del evento en formato JSON. Esta consta de parámetros predeterminados:

  • Priemero van los parámetros de la cesta, si el evento está asociado con ella.
  • A continuación, en el parámetro items, se transmite la matriz de descripciones de los productos.

La lista de parámetros se debe seleccionar partiendo del tipo de evento. Por ejemplo, para los eventos de visualización de un producto, no tiene sentido indicar los parámetros de envío.

En apartados por separado, se muestran la lista de eventos soportados y los ejemplos de envío de estos, así como la lista con todos los parámetros disponibles para los productos y cestas.

A continuación, analizaremos más de cerca cómo rellenar un código de seguimiento usando como ejemplo el evento principal del eCommerce: la finalización exitosa de una compra.

Ejemplo de envío del código de seguimiento Checkout Success #

Checkout Success es el evento de finalización exitosa de la compra. En él se puede transmitir una ingente cantidad de información: desde los datos de la transacción hasta los datos del envío.

La descripción del evento se transmite en forma de parámetros. Los parámetros de compra, tales como el número de transacción, el comprador, etcétera, se rellenan solo en el apartado de la cesta:

  • cart_id – identificador de la cesta.
  • transaction_id – identificador del pago.
  • seller, buyer – nombre o identificador del vendedor y el comprador. Pueden ser los logins de usuario en su sitio web. Estos parámetros son necesarios para crear los informes sobre los mejores compradores. Estos informes resultarán útiles si usted ofrece su sitio web para el trabajo de múltiples vendedores externos.
  • affiliation – tienda o filial en la que se ha realizado la transacción de pago.
  • detail – en caso necesario, aquí podrá indicar información adicional sobre la compra.
  • checkout_option – método de pago.
  • checkout_step – número del paso de la compra. Por ejemplo, si la compra en su sitio tiene tres pasos: ver la cesta, introducir los datos de envío y pagar, podrá numerarlos como 1, 2 y 3. Por consiguiente, en la etapa de compra exitosa, usted transmitirá el valor 3.

Además, en el apartado de la cesta, se pueden indicar los parámetros de pago totales (coste total, descuento, etcétera). Después de la descripción de la cesta, viene la descripción de cada producto que contiene.

Vamos a analizar por separado las particularidades relacionadas con el rellenado de los parámetros de pago: profit, value, price, transaction_fee, tax_value, discount_value, shipping_value.

  • Para la cesta: "price" no se rellena. El resto de los parámetros se completan como el valor total de los parámetros correspondientes de los productos de la cesta. Los valores se indican en términos monetarios.
  • Para un producto: en el parámetro "price" se indica el precio por un producto, incluso si se compran varias unidades del mismo (quantity > 1). El resto de valores se indican teniendo en cuenta el número de unidades del producto. Por ejemplo, si el precio de un producto es 300 USD (price = 300) y la cesta contiene 5 unidades del producto (quantity = 5), deberá transmitir el valor 1500 en el parámetro "value".

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,
      "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 del envío de este código de seguimiento, 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á.

Regístrese y consiga:

Registrándose, usted acepta los Términos del Acuerdo
¡Felicidades! Su cuenta ha sido creada
  • Visite
    finteza.com
  • Consiga
    una cuenta
  • Confirme
    su email
  • Instale
    el código

Hemos enviado un email al correo {email}, por favor, localícelo y active su cuenta.

Después de ello, solo necesitará autorizarse e instalar el código de seguimiento a su sitio web. Es sencillo: