Registra eventos de ecommerce

Además de las vistas de página, el script puede registrar cuatro pasos de la compra. Muestran dónde abandonan los visitantes y dan más información a la atribución. En Shopify, el Clakta Script registra estos pasos por ti. En otras tiendas, un desarrollador añade las llamadas de abajo.

Los cuatro eventos

Todos vienen del mismo paquete, y ninguno necesita de nuevo el id del script:

import clakta from "@clakta/javascript"

Vista de producto

Llámalo en la página del producto:

clakta.pageViewWithProduct({
  id: "sku-1042",
  name: "Blue shirt",
  price: 29.99,
  currency: "USD",
})

Añadir al carrito

clakta.addToCart({
  id: "sku-1042",
  name: "Blue shirt",
  price: 29.99,
  currency: "USD",
  quantity: 1,
})

Inicio de checkout

clakta.checkoutStarted({
  orderId: "1042",
  token: "checkout-token-abc",
  email: "customer@example.com",
  currency: "USD",
  value: 59.98,
  lineItems: [
    { id: "sku-1042", name: "Blue shirt", price: 29.99, quantity: 2 },
  ],
})

Pago enviado

Envíalo cuando el comprador envíe el pago, antes de saber si se aprobó:

clakta.paymentSubmitted({
  orderId: "1042",
  currency: "USD",
  value: 59.98,
})

Campos que lee Clakta

Productos: id, name, price, currency, quantity

Pedidos y carritos: orderId, token, email, currency, value, lineItems

Cualquier otra cosa que envíes se guarda como información extra. Los precios son números sencillos en la unidad principal (29.99, no 2999), y la moneda usa el código de tres letras, como EUR.

En los proyectos respetuosos con la privacidad, no envíes email: es un dato personal que ese modo no recoge.

Eventos personalizados

Para cualquier cosa fuera de los pasos de la compra:

clakta.trackEvent("hero-cta", "click", { variant: "A" })

El primer valor es tu propio nombre para lo que sigues (un botón, una sección), el segundo es el tipo de evento, y el tercero es información extra opcional.

Dónde poner las llamadas

• Vista de producto: cuando se abre la página del producto, también cuando el visitante pasa de un producto a otro sin recargar la página.
• Añadir al carrito: después de que el producto se añadió de verdad, no en el clic, o también se cuentan los intentos fallidos.
• Inicio de checkout: cuando la página de checkout aparece por primera vez.
• Pago enviado: cuando se envía el formulario de pago, justo antes de que el visitante vaya al proveedor de pagos.

Puedes llamarlos antes de que el script termine de cargar: Clakta los guarda y los envía en cuanto está listo.