IntegraçãoFinteza JavaScript ClientE-Commerce

E-Commerce

Se você tem uma loja online, o Finteza o ajudará a gerar análises detalhadas, graças ao suporte para eventos E-Commerce. Ao configurar o envio para seu site, você pode:

  • Descobrir que itens e marcas são populares
  • Determinar o volume real de vendas
  • Estimar a perda de lucros quando um potencial comprador, por algum motivo, não finaliza uma compra

E isso não é toda a lista de informações que você pode obter. Mais detalhes podem ser encontrados no artigo "O Finteza apresenta e-Commerce".

Como isso funciona #

E-Commerce funciona de maneira semelhante aos eventos. Você também define o código de rastreamento no seu site e, em seguida, adiciona às páginas as funções para enviar eventos, por exemplo, ao passar para a próxima etapa de uma compra, ao adicionar um item ao carrinho, etc.

Ao contrário dos eventos comuns, o rastreamento do E-Commerce têm uma gama muito mais ampla de parâmetros. Eles são usados para exibir dados em relatórios especiais que aparecem no painel do Finteza:

Relatório e-Commerce no Finteza

Como enviar eventos E-Commerce #

Após anexar Finteza JavaScript Client você pode enviar eventos E-Commerce. Para fazer isso, adicione o seguinte código JavaScript à página do site:

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

Em vez de {EVENT_NAME}, especifique o nome do evento a partir da lista de disponíveis, por exemplo "View Item".

Em seguida adicione a descrição do evento no formato JSON. Ele é composto por parâmetros predefinidos:

  • Os parâmetros do carrinho estão primeiro, se o evento estiver associado a ele.
  • Em seguida, no parâmetro items é passado o array de descrição de itens.

A lista de parâmetros deve ser selecionada com base no tipo de evento. Por exemplo, para eventos de visualização de item não faz sentido especificar parâmetros de entrega.

Nas diferentes seções há uma lista de eventos suportados e exemplos de envio, bem como outra de parâmetros de itens e carrinhos disponíveis.

A seguir, examinaremos mais de perto o preenchimento do rastreamento usando o exemplo do principal evento eCommerce, a conclusão bem-sucedida de uma compra.

Exemplo de envio de rastreamento para o evento Checkout Success #

Checkout Success é um evento de conclusão bem-sucedida de uma compra. A ele pode ser transferida a quantidade máxima de informações: desde dados da transação a dados de entrega.

A descrição do evento é passada como parâmetros. Os parâmetros gerais de compra, como número da transação, cliente, etc., são preenchidos apenas na seção do carrinho de compras:

  • cart_id é o identificador do carrinho.
  • transaction_id é o identificador do pagamento.
  • seller, buyer é o nome ou identificador do vendedor e do comprador. Podem ser logins de usuários em seu site. Esses parâmetros são necessários para gerar relatórios sobre os principais compradores. Esses relatórios são úteis se você fornecer uma plataforma para a venda de produtos a vendedores terceirizados.
  • affiliation é a loja ou filial onde foi efetuada a operação de pagamento.
  • detail é aqui que, se necessário, você pode especificar informações adicionais sobre a compra.
  • checkout_option é a forma de pagamento.
  • checkout_step é o número da etapa de compra. Por exemplo, se uma compra em seu site tiver três etapas: visualizar carrinho, inserir detalhes de entrega e pagar; você pode numerá-los como 1, 2 e 3. Assim, na etapa de compra bem-sucedida, você passa o valor 3.

Além disso, a seção do carrinho de compras pode indicar os parâmetros de pagamento total (custo total, desconto, etc.). Depois que o carrinho é descrito, há uma descrição de cada item.

Vamos considerar separadamente as peculiaridades do preenchimento dos parâmetros monetários: profit, value, price, transaction_fee, tax_value, discount_value, shipping_value.

  • Para o carrinho price não é preenchido. O resto dos parâmetros são preenchidos como os valores totais dos parâmetros correspondentes dos itens no carrinho. Os valores são indicados em dinheiro.
  • Para um produto, o parâmetro price especifica o preço de um item, mesmo se várias unidades forem compradas (quantity > 1). Os demais valores são indicados levando em consideração a quantidade de unidades do item. Por exemplo, se o preço de um item é de 300 USD (price = 300), e o carrinho terá 5 unidades do produto (quantity = 5), logo, ao parâmetro value deve ser passado o valor 1500.

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 do envio desta faixa para Finteza, 3 eventos serão criados:

  • Evento "Checkout Success" para cada um dos itens. Neles são especificadostransaction_id, affiliation, cart_id, checkout_step, checkout_option, retirados da descrição do carrinho.
  • Evento "Checkout Success" para o carrinho. Se cart_id não far especificado, o evento não será gerado.

Aumente a receita do seu site usando:

Registre-se agora e tenha acesso gratuito por 30 dias.

Ao se registrar, você concorda com os Termos do Acordo
Parabéns, conta criada com sucesso!
  • Visite
    finteza.com
  • Obter
    conta
  • Confirmar
    e-mail
  • Instalar
    código

Enviamos um e-mail de ativação de conta para {email}.

Depois disso, você pode fazer login e tudo o que resta é instalar o código de rastreamento no site, é simples: