IntegraçãoFinteza JavaScript ClientConectando

Como inserir um script de acompanhamento

Para adicionar um script de acompanhamento, basta inserir um pequeno código nas páginas do seu site. Abra seu site no painel do Finteza e vá para Configurações:

Obtenha um código de rastreamento para seu site

Copie o código de rastreamento e cole-o em todas as páginas do site dentro das tags <head></head> .

Se você ainda não registrou seu site no Finteza, clique em Adicionar na seção Sites. Especifique o nome e o endereço do site, para receber imediatamente o código de rastreamento.


Certifique-se de inserir o código de acompanhamento em todas as páginas de seu site. Caso contrário, as estatísticas das visitas ficarão incompletas.


Exemplo de código #

O código de inserção é o seguinte:

<script type="text/javascript">
  (function(a,e,f,g,b,c,d){a[b]||(a.FintezaCoreObject=b,a[b]=a[b]||function(){(a[b].q=a[b].q||[]).push(arguments)},a[b].l=1*new Date,c=e.createElement(f),d=e.getElementsByTagName(f)[0],
   c.async=!0,c.defer=!0,c.src=g,d&&d.parentNode&&d.parentNode.insertBefore(c,d))})
  (window,document,"script","{SCRIPT_URL}","fz");
  fz("register","website","{WEBSITE_ID}");
</script>

No código copiado, {SCRIPT_URL} deve ser substituído pela URL do script principal de rastreamento baixado do servidor do Finteza. {WEBSITE_ID} deve ser substituído por ID de seu site no painel do Finteza.

Depois de inserir o código, a função fz() aparece na janela de contexto principal da página. Para verificar sua disponibilidade, execute window.fz no console. Essa função chama os métodos para interagir com o Finteza. Exemplo de registro de site:

fz("register","website","{WEBSITE_ID}");

Se o nome da função fz já estiver ocupado, use outro. Para fazer isso, altere a declaração do método e chame dois locais no código de rastreamento:

(window,document,"script","{SCRIPT_URL}","fz-your-name");
fz-your-name("register","website","{WEBSITE_ID}");

O script de rastreamento principal (baixado do servidor do Finteza) é inserido na página de forma assíncrona – independentemente de outros elementos. Assim, não diminui o carregamento da página principal.

Parâmetros de registro de site #

O código de inserção inclui chamar a função fz("register", ...), que envia eventos de visita ao site para o Finteza. Essa função suporta vários parâmetros adicionais:

Parâmetros

Tipo

Descrição

trackHash

boolean

Habilita o rastreamento de alterações de hash (de âncora) da página.
 
Por padrão, as transições através de links de âncora na página não são rastreados. Apenas a primeira entrada à página é considerada como visualização de página. Essa abordagem pode ser inaceitável para sites onde todo o conteúdo está localizado em uma única página longa (aplicativo de página única/single page application).

 

Ative esse parâmetro para permitir que o Finteza rastreie mudanças de hash no URL da página da web. Um novo evento de visita à página da Web será enviado ao sistema toda vez que o hash for alterado.

trackLinks

boolean

Habilita o rastreamento de cliques em links externos localizados nas páginas de seu website.

 

Se você usa vários links externos no site (por exemplo, ao colaborar com uma rede de publicidade), esse parâmetro permite determinar exatamente como os usuários deixam o site.

 

Cada vez que um link externo é clicado, um evento especial é enviado para o Finteza. O relatório sobre esses eventos está disponível na seção 'Páginas – Saídas' do seu site no painel do Finteza.

timeOnPage

boolean

Ativa o cálculo preciso do tempo gasto por um usuário na página.

 

Por padrão, o parâmetro é calculado como uma diferença entre a entrada e a hora da transição para uma outra página do site. No entanto, tal cálculo é impossível para a última página visitada, já que não há transição para outra a partir dela.

 

Se ativado, a cada 15 segundos o JavaScript Client envia um evento especial para o Finteza informando que o usuário ainda está na página. Assim, você pode acompanhar com mais precisão o tempo gasto, mesmo para visualizações únicas.

 

Os eventos são enviados apenas nos dois primeiros minutos que o usuário passa na página.

Exemplo de ativação de parâmetros adicionais:

fz( "register""website", {
    "id":"cacgfaknbbubiozaeidyvhoisrajbdvjqg",
    "trackHash"true,
    "trackLinks"true,
    "accurateBounceRate"true,
    "timeOnPage"true
} );

Se você usa Política de Segurança de Conteúdo #

O padrão da Política de Segurança de Conteúdo foi projetado para evitar ataques no site associados à introdução de códigos maliciosos em suas páginas. Se você usar essa política de segurança, na linha com a declaração correspondente - no cabeçalho de cada página - adicione uma exceção para o site do qual o script de acompanhamento do Finteza é baixado, por exemplo:

Política de Segurança de Conteúdo: script-src 'self' content.mql5.com;

Caso contrário, os navegadores bloquearão o carregamento de core.js e as estatísticas do site não serão coletadas.

Acelerando o download via X-DNS-Prefetch-Control #

Para acelerar o download do script de acompanhamento, é recomendável adicionar a instrução X-DNS-Prefetch-Control ao cabeçalho de todas as páginas do site:

<meta http-equiv='x-dns-prefetch-control' content='on'>
<link rel='dns-prefetch' href='https://content.mql5.com'>

Ele indica ao navegador a localização do script para que ele possa reconfigurar o endereço imediatamente (ao carregar a página) sem gastar tempo com isso durante o download do script em si.

Intermediando por proxy o download do script através de seu site #

Para evitar o bloqueio do download do script do Finteza, recomendamos intermediá-lo por proxy através de seus sites.