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.

Para as páginas de instantâneas do Google AMP, que usam sua própria versão do código de rastreamento, há um requisito adicional para nomear atributos, isto é, eles devem começar com o prefixo "data-vars". Portanto, para processar automaticamente os cliques nos links dessas páginas, adicione a eles os atributos data-vars-fz:

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

Para evitar confusão na nomeação, você pode usar atributos data-vars-fz em qualquer lugar. Eles são suportados não apenas nas páginas do Google AMP, mas também em páginas regulares, em que instalado o código de rastreamento padrão.


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.