IntegraçãoEnviando eventos

Como enviar eventos

Depois de inserir o Finteza JavaScript Client você pode enviar eventos sobre as ações dos usuário no site para o Finteza Para fazer isso, adicione o seguinte código JavaScript à página do site:

fz( "event""{EVENT_NAME}" );

Em vez de {EVENT_NAME}, especifique o nome do evento, por exemplo, Registration.

Teste o código executando-o no console do navegador. Se tiver sucesso, você verá a entrada correspondente no relatório Eventos em seu site no painel Finteza.

Evento registrado com sucesso no painel do Finteza

Dados adicionais nos parâmetros do evento #

Nos eventos enviados para o Finteza, você pode especificar informações adicionais na forma de parâmetros. Por exemplo, o tipo de mercadoria comprada, o valor da compra, a moeda, etc.

fz( "event", {
  name:  "{EVENT_NAME}",
  unit:  "{UNIT}",
  value: {VALUE}
});

Especifique o nome do evento em {EVENT_NAME}. A seguir são definidos os parâmetros:

Parâmetros

Tipo

Descrição

unit

string

Unidades do parâmetro. Por exemplo, USD, peças, etc. Comprimento máximo de 32 caracteres.

value

number

Valor do parâmetro Comprimento máximo de 64 caracteres.

Exemplo:

fz( "event", {
  name:  "Purchase",
  unit:  "USD",
  value: 100
});

Opções para enviar eventos a partir da página #

Dependendo do evento que você está acompanhando, o código de rastreamento deve ser inserido em determinadas tags de página.

Envio de evento ao preencher formulários:

<form action="" method="get" onsubmit="fz('event', 'Form+Order+Submit'); return true;">
    ...
</form>

Envio de evento ao pressionar um botão:

<form action="">
    ...
    <input type="button" onclick="fz('event', 'Form+Order+Submit'); return true;" value="Order" />
</form>

Envio de evento ao clicar em um link:

<a href="https://www.example.com/" onclick="fz('event', 'Click+Link'); return true;">www.example.com</a>

Envio de evento ao carregar uma página:

<body>
...
<script type="text/javascript">
  fz("event","Page+Order+Load");
</script>
...
</body>

Processamento automático de cliques de links #

Adicione aos links em seu site os atributos data-fz-event e especifique neles os nomes dos eventos que precisam ser enviados para o Finteza quando clicados. O Finteza JavaScript Client detecta e processa automaticamente cliques em todos os links deste tipo na página.

<a data-fz-event="Click+Link" href="https://www.example.com/">www.example.com</a>

Essa opção pode ser usada em vez de adicionar aos links os atributos onclick com uma descrição completa da chamada fz(). É mais fácil e mais conveniente.

Retorno de chamada #

Se você precisar manipular um evento de envio, especifique a função de retorno de chamada no código do evento. Altere o segundo argumento de chamada da seguinte forma:

fz( "event", {
  name:  "Your Event Name",
  unit:  "USD",
  value: 100,
  callback: function() {
...
    // event sending completed
  }
} );

Ele será um objeto contendo o nome do evento e um link para a função manipulador.