Activa medidas opcionais
Estamos orgulhosos de ter um dos snippets 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 melhoradas como extensões de script opcionais adaptadas à forma como pretende utilizar o Histat. Esta abordagem garante que carrega apenas o código que será realmente utilizado no seu site.
Pode ativar estas medidas opcionais ao adicionar um novo site à sua conta Hisstat ou na área "Instalação do site" da secção "Geral" nas suas definições do site
Note que o snippet de rastreio que precisa de inserir no seu website muda dependendo da seleção de medições melhoradas. Ao fazer alterações nas suas medidas opcionais, certifique-se de que insere o snippet mais recente no seu website para que todo o rastreio funcione conforme o esperado
Aqui está a lista das nossas medidas opcionais:
| Medição Opcional | Explicação |
|--------------------------|---------------------- -------------------------------------------------- ----------------------------|
| Links externos | Rastrear cliques em links externos automaticamente |
| Downloads de ficheiros | Rastrear downloads de ficheiros automaticamente |
| 404 páginas de erro | Rastrear páginas de erro 404 automaticamente |
| Caminhos de página com hash | Rastrear automaticamente caminhos de páginas que utilizam um # no URL hash-based routing |
| Eventos personalizados | Permite rastrear eventos personalizados, como cliques em links, envios de formulários e quaisquer outros cliques em elementos HTML |
| Propriedades personalizadas | Permite anexar 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 atribuir valores monetários dinâmicos a eventos personalizados e acompanhar a atribuição de receitas |
Opções avançadas de rastreio
Para 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), temos também disponíveis algumas opções de rastreio mais avançadas. Note que não estão incluídos na lista de integração do website, pelo que terá de inseri-los manualmente no seu snippet de rastreio.
| Extensão | Explicação |
|--------------------------|---------------------- -------------------------------------------------- ----------------------------|
| script.compat.js | Modo de compatibilidade para rastrear utilizadores no Internet Explorer (≥IE11) |
| script.local.js | Permitir que as análises também sejam rastreadas no host local, o que é útil em aplicações híbridas |
| script.manual.js | Não acione as pré-visualizações de página automaticamente . Permite também especificar locais personalizados para editar URLs com identificadores. Também pode usá-lo para rastrear parâmetros de consulta personalizados|
Como alterar manualmente o snippet de rastreio
Por exemplo, o nome do script padrão no nosso snippet é script.js. Se o seu site estiver num host local e quiser acompanhar essas visitas, tem a opção de carregar o script com uma extensão diferente: script.local.js.
Neste caso, o snippet que precisa de inserir no seu site é o seguinte (certifique-se de que altera o atributo data-domain para o domínio que adicionou ao Hisstat):
<script defer data-domain="seudominio.com" src="https://histat.com/js/script.local.js"></script>
Pode misturar, combinar e combinar estas extensões da maneira que desejar. Por exemplo, se quiser utilizar o nosso encaminhamento baseado em hash e o nosso rastreio de cliques em links externos, pode combiná-los da seguinte forma: script.hash.outbound-links.js.
Neste caso, o snippet que precisa de inserir no seu site é o seguinte (certifique-se de que altera o atributo data-domain para o domínio que adicionou ao Hisstat):
<script defer data-domain="seudominio.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>
Ou digamos que pretende utilizar a nossa extensão script.revenue.js para rastrear receitas de comércio eletrónico e a nossa extensão script.local.js para rastrear o tráfego de host local, o seu snippet deve ficar assim:
<script defer data-domain="seudominio.com" src="https://histat.com/js/script.revenue.local.js"></script>
E só precisa de inserir aquele snippet no seu site, sem necessidade de mais nada.
script.compat.js
O script Histat padrão não funciona no Internet Explorer porque utiliza a API document.currentScript para ler as opções de configuração. Pode executar o Histat em modo de compatibilidade incluindo a extensão script.compat.js e definindo id="plausible" na tag do script para que este se possa encontrar. Note que isto funciona apenas em ≥ IE11. Veja como deve ser:
<script id="plausible" defer data-domain="seudominio.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
Por predefinição, o script Hist aciona uma visualização de página quando é carregado pela primeira vez. Também anexa ouvintes à API de histórico e acionará automaticamente as visualizações de página quando utilizar history.pushState. Isto é útil para a maioria dos sites, mas também oferecemos um modo manual, caso pretenda controlo total sobre quando as visualizações de página são acionadas no seu site.
Um dos casos de utilização para isto é quando se utiliza Turbo (anteriormente Turbolinks). Nesse caso, pretende acionar manualmente as visualizações de página do Hist no evento turbo:load ou turbolinks:load do browser, dependendo da biblioteca que utilizar. Veja como pode fazer:
<script defer data-domain="seudominio.com" src="https://histat.com/js/script.manual.js"></script>
<!-- defina a função `plausível` para acionar eventos manualmente -->
<script>janela.plausível = janela.plausível || function() { (window.plausible.q = window.plausible.q || []).push(argumentos) }</script>
<!-- desencadeia visualizações de página na navegação de turbolinks -->
<roteiro>
document.addEventListener("turbo:carga", function() {
plausível('visualização de página')
})
</script>
Ao utilizar turbolinks, deve certificar-se de que o script Histat não é carregado e executado durante a navegação turbo. Pode ser necessário mover o script para a secção <head> do seu site ou utilizar o atributo data-turbo-eval="false" para o fazer.
Ao utilizar o manual.js, cada chamada de script com 'pageview' resulta numa visualização de página separada a ser contada, mesmo que chamada na mesma página
Especifique localizações personalizadas para os URLs das suas páginas
Além disso, a extensão de script manual permite-lhe fornecer uma opção especial chamada u com os seus eventos. Isto permite especificar o URL da página e pode ser utilizado para especificar locais personalizados.
É especialmente útil redigir e agregar várias páginas cujos URLs contenham identificadores específicos dos utilizadores.
Rastrear parâmetros de consulta personalizados para URLs de páginas completas
Por defeito, o Hisstat remove todos os parâmetros de consulta para fins de privacidade ref, source, utm_source, utm_medium, utm_campaign, utm_content e utm_term.
Isto significa que páginas como seusite.com/blog/index.php?article=some_article&page=11 serão reportadas como seusite.com/blog/index.php no relatório "Páginas Principais" do seu Painel Hist .