Activer les mesures facultatives

Nous sommes fiers d'avoir l'un des extraits JavaScript les plus légers du secteur de l'analyse.

Nous y parvenons en limitant radicalement le nombre d'options dans le script par défaut. Au lieu de cela, nous proposons des mesures améliorées sous forme d'extensions de script facultatives adaptées à la façon dont vous souhaitez utiliser Histat. Cette approche garantit que vous ne chargez que le code qui sera réellement utilisé sur votre site Web.

Vous pouvez activer ces mesures facultatives lors de l'ajout d'un nouveau site à votre compte Histat ou dans la zone « Installation du site » de la section « Général » de vos « paramètres du site »

L'extrait change en fonction de votre sélection de mesures

Notez que l'extrait de suivi que vous devez insérer dans votre site change en fonction de votre sélection de mesures améliorées. Lorsque vous apportez des modifications à vos mesures facultatives, assurez-vous d'insérer l'extrait le plus récent dans votre site pour que tout le suivi fonctionne comme prévu

Voici la liste de nos mesures facultatives :

Mesure facultative	Explication
Liens sortants	Suivi automatique des clics sur les liens sortants
Téléchargements de fichiers	Suivre automatiquement les téléchargements de fichiers
Pages d'erreur 404	Suivre automatiquement les pages d'erreur 404
Chemins de page hachés	Suivre automatiquement les chemins de page qui utilisent un # dans le routage basé sur le hachage de l'URL
Événements personnalisés	Vous permet de suivre les événements personnalisés tels que les clics sur les liens, les envois de formulaires et tout autre clic sur les éléments HTML
Propriétés personnalisées	Vous permet de joindre des propriétés personnalisées (également appelées dimensions personnalisées dans Google Analytics) lors de l'envoi d'une page vue ou d'un événement personnalisé pour créer des métriques personnalisées
Revenus du commerce électronique	Vous permet d'attribuer des valeurs monétaires dynamiques aux événements personnalisés et de suivre l'attribution des revenus

Options de suivi avancées

En plus de la liste ci-dessus (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js et script.revenue.js), nous avons également des options de suivi plus avancées disponibles. Notez que celles-ci ne sont pas incluses dans la liste d'intégration du site, vous devrez donc les insérer manuellement dans votre extrait de suivi.

Extension	Explication
script.compat.js	Mode de compatibilité pour le suivi des utilisateurs sur Internet Explorer (≥IE11)
script.local.js	Autoriser Analytics à effectuer également le suivi sur l'hôte local, ce qui est utile dans les applications hybrides
script.manual.js	Ne pas déclencher automatiquement les pages vues. Vous permet également de spécifier des emplacements personnalisés pour rédiger des URL avec des identifiants. Vous pouvez également l'utiliser pour suivre les paramètres de requête personnalisés

Comment modifier manuellement l'extrait de suivi

Par exemple, le nom de script par défaut dans notre extrait est script.js. Si votre site Web est sur un hôte local et que vous souhaitez suivre ces visites, vous avez la possibilité de charger le script avec une extension différente : script.local.js.

Dans ce cas, l'extrait que vous devez insérer dans votre site est le suivant (assurez-vous de modifier l'attribut data-domain en fonction du domaine que vous avez ajouté à Histat) :

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>

Vous pouvez mélanger et assortir ces extensions comme vous le souhaitez. Par exemple, si vous souhaitez utiliser à la fois notre routage basé sur le hachage et notre suivi des clics sur les liens sortants, vous pouvez les combiner comme suit : script.hash.outbound-links.js.

Dans ce cas, l'extrait que vous devez insérer dans votre site est le suivant (assurez-vous de modifier l'attribut data-domain pour le domaine que vous avez ajouté à Histat) :

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>

Ou disons que vous souhaitez utiliser notre extension script.revenue.js pour suivre les revenus du commerce électronique et notre extension script.local.js pour suivre le trafic local, votre extrait devrait ressembler à ceci :

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>

Et vous n'avez besoin d'insérer que cet extrait dans votre site, rien d'autre n'est nécessaire.

script.compat.js

Le script Histat par défaut ne fonctionnera pas sur Internet Explorer car il utilise l'API document.currentScript pour lire les options de configuration. Vous pouvez exécuter Histat en mode de compatibilité en incluant l'extension script.compat.js et en définissant id="plausible" sur la balise script afin qu'il puisse se trouver. Notez que cela ne fonctionne que sur ≥ IE11. Voici à quoi cela devrait ressembler :

<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>

script.manual.js

Par défaut, le script Histat déclenche une consultation de page lors de son premier chargement. Il attache également des écouteurs à l'API History et déclenche automatiquement des consultations de page lorsque vous utilisez history.pushState. Cela est utile pour la plupart des sites Web, mais nous proposons également un mode manuel au cas où vous souhaiteriez avoir un contrôle total sur le moment où les pages vues sont déclenchées sur votre site Web.

L'un des cas d'utilisation de ceci est lorsque vous utilisez Turbo (anciennement Turbolinks). Dans ce cas, vous souhaitez déclencher manuellement les pages vues Histat sur l'événement de navigateur turbo:load ou turbolinks:load selon la bibliothèque que vous utilisez. Voici comment vous pouvez le faire :

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- définir la fonction `plausible` pour déclencher manuellement les événements -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- déclencher des pages vues sur la navigation turbolinks -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>

Lorsque vous utilisez turbolinks, vous devez vous assurer que le script Histat n'est pas chargé et exécuté pendant la navigation turbo. Vous devrez peut-être déplacer le script vers la section <head> de votre site Web ou utiliser l'attribut data-turbo-eval="false" pour le faire.

remarque

Lorsque vous utilisez manual.js, chaque appel de script avec 'pageview' entraîne le comptage d'une page vue distincte même si elle est appelée sur la même page

Spécifiez des emplacements personnalisés pour les URL de vos pages

De plus, l'extension de script manuel vous permet de fournir une option spéciale nommée u avec vos événements. Cela vous permet de spécifier l'URL de la page et peut être utilisé pour spécifier des emplacements personnalisés.

Il est particulièrement utile de rédiger et d'agréger plusieurs pages dont les URL contiennent des identifiants spécifiques aux utilisateurs.

Suivi des paramètres de requête personnalisés pour les URL de page complètes

Par défaut, Histat supprime tous les paramètres de requête à des fins de confidentialité ref, source, utm_source, utm_medium, utm_campaign, utm_content et utm_term.

Cela signifie que les pages telles que yoursite.com/blog/index.php?article=some_article&page=11 seront signalées comme yoursite.com/blog/index.php dans le rapport « Top Pages » de votre tableau de bord Histat.