Rastreie eventos de e-commerce

Além das page views, o script pode registrar quatro passos da compra. Eles mostram onde os visitantes desistem e dão mais informação para a atribuição. Na Shopify, o Clakta Script registra esses passos para você. Nas outras lojas, um desenvolvedor adiciona as chamadas abaixo.

Os quatro eventos

Todos vêm do mesmo pacote, e nenhum precisa do id do script de novo:

import clakta from "@clakta/javascript"

Visualização de produto

Chame na página do produto:

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

Adicionar ao carrinho

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

Início 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 },
  ],
})

Pagamento enviado

Envie quando o comprador enviar o pagamento, antes de saber se foi aprovado:

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

Campos que o Clakta lê

Produtos: id, name, price, currency, quantity

Pedidos e carrinhos: orderId, token, email, currency, value, lineItems

Qualquer outra coisa que você enviar fica guardada como informação extra. Os preços são números simples na unidade principal (29.99, não 2999), e a moeda usa o código de três letras, como BRL.

Em projetos amigáveis à privacidade, não envie o email: é um dado pessoal que esse modo não coleta.

Eventos personalizados

Para qualquer coisa fora dos passos da compra:

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

O primeiro valor é o seu próprio nome para o que você está rastreando (um botão, uma seção), o segundo é o tipo de evento, e o terceiro é uma informação extra opcional.

Onde colocar as chamadas

• Visualização de produto: quando a página do produto abre, inclusive quando o visitante passa de um produto a outro sem recarregar a página.
• Adicionar ao carrinho: depois que o produto foi mesmo adicionado, não no clique, senão as tentativas que falharam também contam.
• Início de checkout: quando a página de checkout aparece pela primeira vez.
• Pagamento enviado: quando o formulário de pagamento é enviado, logo antes de o visitante ir para o provedor de pagamento.

Você pode chamar antes de o script terminar de carregar: o Clakta guarda as chamadas e envia assim que estiver pronto.