Habilitar medições opcionais
Temos orgulho de ter um dos snippets de JavaScript mais leves do setor de análise.
Conseguimos isso limitando radicalmente o número de opções no script padrão. Em vez disso, oferecemos medições aprimoradas como extensões de script opcionais adaptadas à forma como você deseja usar o Histat. Essa abordagem garante que você carregue apenas o código que realmente será usado no seu site.
Você pode habilitar essas medições opcionais ao adicionar um novo site à sua conta Histat ou na área "Instalação do site" da seção "Geral" nas suas configurações do site
Observe que o snippet de rastreamento que você precisa inserir no seu site muda dependendo da sua seleção de medições aprimoradas. Ao fazer alterações nas suas medições opcionais, certifique-se de inserir o snippet mais recente no seu site para que todo o rastreamento funcione conforme o esperado
Aqui está a lista das nossas medições opcionais:
| Medição opcional | Explicação |
|---|---|
| Links de saída | Rastrear cliques em links de saída automaticamente |
| Downloads de arquivo | Rastrear downloads de arquivo automaticamente |
| Páginas de erro 404 | Rastrear automaticamente páginas de erro 404 |
| Caminhos de página com hash | Rastrear automaticamente caminhos de página que usam um # no roteamento baseado em hash da URL |
| Eventos personalizados | Permite que você rastreie eventos personalizados, como cliques em links, envios de formulários e quaisquer outros cliques em elementos HTML |
| Propriedades personalizadas | Permite que você anexe propriedades personalizadas (também conhecidas como dimensões personalizadas no Google Analytics) ao enviar uma visualização de página ou evento personalizado para criar métricas personalizadas |
| Receita de comércio eletrônico | Permite que você atribua valores monetários dinâmicos a eventos personalizados e rastreie a atribuição de receita |
Opções avançadas de rastreamento
Além da lista acima (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js e script.revenue.js), também temos algumas opções de rastreamento mais avançadas disponíveis. Observe que elas não estão incluídas na lista de integração do site, então você precisará inseri-las no seu snippet de rastreamento manualmente.
| Extensão | Explicação |
|---|---|
| script.compat.js | Modo de compatibilidade para rastrear usuários no Internet Explorer (≥IE11) |
| script.local.js | Permitir que o analytics rastreie no localhost também, o que é útil em aplicativos híbridos |
| script.manual.js | Não acione visualizações de página automaticamente. Também permite que você especificar locais personalizados para redigir URLs com identificadores. Você também pode usá-lo para rastrear parâmetros de consulta personalizados |
Como alterar manualmente o snippet de rastreamento
Por exemplo, o nome do script padrão em nosso snippet é script.js. Se seu site estiver em um host local e você quiser rastrear essas visitas, você tem a opção de carregar o script com uma extensão diferente: script.local.js.
Neste caso, o snippet que você precisa inserir em seu site é o seguinte (certifique-se de alterar o atributo data-domain para o domínio que você adicionou ao Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>
Você pode misturar e combinar essas extensões da maneira que desejar. Por exemplo, se você quiser usar nosso roteamento baseado em hash e nosso rastreamento de cliques em links de saída, você pode combiná-los da seguinte forma: script.hash.outbound-links.js.
Neste caso, o snippet que você precisa inserir no seu site é o seguinte (certifique-se de alterar o atributo data-domain para o domínio que você adicionou ao Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>
Ou digamos que você queira usar nossa extensão script.revenue.js para rastrear a receita do e-commerce e nossa extensão script.local.js para rastrear o tráfego do localhost, seu snippet deve ficar assim:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>
E você só precisa inserir esse snippet no seu site, não precisa de mais nada.
script.compat.js
O script Histat padrão não funcionará no Internet Explorer porque ele usa a API document.currentScript para ler opções de configuração. Você pode executar o Histat no modo de compatibilidade incluindo a extensão script.compat.js e definindo id="plausible" na tag script para que ele possa se encontrar. Observe que isso funciona apenas no IE11 ≥. Veja como deve ficar:
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
Por padrão, o script Histat aciona uma visualização de página quando é carregado pela primeira vez. Ele também anexa ouvintes à API History e acionará automaticamente visualizações de página quando você usar history.pushState. Isso é útil para a maioria dos sites, mas também oferecemos um modo manual caso você queira controle total sobre quando as visualizações de página são acionadas em seu site.
Um dos casos de uso para isso é quando você usa Turbo (anteriormente Turbolinks). Nesse caso, você deseja acionar manualmente as visualizações de página Histat no evento do navegador turbo:load ou turbolinks:load, dependendo da biblioteca usada. Veja como fazer isso:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- defina a função `plausible` para acionar eventos manualmente -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- trigger pageviews on turbolinks navigation -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>
Ao usar turbolinks, você deve certificar-se de que o script Histat não seja carregado e executado durante a navegação turbo. Pode ser necessário mover o script para a seção <head> do seu site ou usar o atributo data-turbo-eval="false" para fazer isso.
Ao usar manual.js, cada chamada de script com 'pageview' resulta em uma visualização de página separada sendo contada, mesmo se chamada na mesma página
Especifique locais personalizados para os URLs da sua página
Além disso, a extensão do script manual permite que você forneça uma opção especial chamada u com seus eventos. Isso permite que você especifique a URL da página e pode ser usado para especificar locais personalizados.
É especialmente útil para redigir e agregar várias páginas cujos URLs contêm identificadores específicos para usuários.
Rastreie parâmetros de consulta personalizados para URLs de página completas
Por padrão, o Histat remove todos os parâmetros de consulta para fins de privacidade ref, source, utm_source, utm_medium, utm_campaign, utm_content e utm_term.
Isso significa que páginas como yoursite.com/blog/index.php?article=some_article&page=11 serão relatadas como yoursite.com/blog/index.php no relatório "Principais páginas" do seu painel do Histat.