Optionale Messungen aktivieren

Wir sind stolz darauf, eines der leichtesten JavaScript-Snippets in der Analysebranche zu haben.

Dies erreichen wir, indem wir die Anzahl der Optionen im Standardskript radikal einschränken. Stattdessen bieten wir erweiterte Messungen als optionale Skripterweiterungen an, die auf Ihre gewünschte Verwendung von Histat zugeschnitten sind. Dieser Ansatz stellt sicher, dass Sie nur den Code laden, der tatsächlich auf Ihrer Website verwendet wird.

Sie können diese optionalen Messungen aktivieren, wenn Sie Ihrem Histat-Konto eine neue Site hinzufügen oder im Bereich „Site-Installation“ des Abschnitts „Allgemein“ in Ihren „Site-Einstellungen“

Das Snippet ändert sich je nach Ihrer Auswahl der Messungen

Beachten Sie, dass sich das Tracking-Snippet, das Sie in Ihre Site einfügen müssen, je nach Ihrer Auswahl der erweiterten Messungen ändert. Wenn Sie Änderungen an Ihren optionalen Messungen vornehmen, stellen Sie sicher, dass Sie das neueste Snippet in Ihre Site einfügen, damit das gesamte Tracking wie erwartet funktioniert

Hier ist die Liste unserer optionalen Messungen:

Optionale Messung	Erklärung
Ausgehende Links	„Klicks auf ausgehende Links automatisch verfolgen“
Dateidownloads	„Dateidownloads automatisch verfolgen“
404-Fehlerseiten	Automatisches „Verfolgen von 404-Fehlerseiten“
Gehashte Seitenpfade	Automatisches Verfolgen von Seitenpfaden, die ein „#“ in der URL verwenden, „hash-basiertes Routing“
Benutzerdefinierte Ereignisse	Ermöglicht Ihnen, „benutzerdefinierte Ereignisse“ wie Linkklicks, Formularübermittlungen und Klicks auf andere HTML-Elemente zu „verfolgen“
Benutzerdefinierte Eigenschaften	Ermöglicht Ihnen, „benutzerdefinierte Eigenschaften“ (in Google Analytics auch als benutzerdefinierte Dimensionen bezeichnet) anzuhängen, wenn Sie einen Seitenaufruf oder ein benutzerdefiniertes Ereignis senden, um benutzerdefinierte Messwerte zu erstellen
E-Commerce-Umsatz	Ermöglicht Ihnen, benutzerdefinierten Ereignissen dynamische „Geldwerte“ zuzuweisen und die Umsatzzuordnung zu verfolgen

Erweiterte Tracking-Optionen

Zusätzlich zur obigen Liste (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js und script.revenue.js) haben wir auch einige erweiterte Tracking-Optionen verfügbar. Beachten Sie, dass diese nicht in der Site-Onboarding-Liste enthalten sind, Sie müssen sie also manuell in Ihr Tracking-Snippet einfügen.

Erweiterung	Erklärung
script.compat.js	Kompatibilitätsmodus für „Tracking von Benutzern in Internet Explorer“ (≥IE11)
script.local.js	Erlaubt Analytics auch das Tracking auf dem lokalen Host, was in Hybrid-Apps nützlich ist
script.manual.js	Seitenaufrufe nicht automatisch auslösen. Ermöglicht Ihnen auch, benutzerdefinierte Standorte anzugeben, um URLs mit Kennungen zu redigieren. Sie können es auch verwenden, um benutzerdefinierte Abfrageparameter zu verfolgen

So ändern Sie das Tracking-Snippet manuell

Beispielsweise lautet der Standardskriptname in unserem Snippet script.js. Wenn sich Ihre Website auf einem lokalen Host befindet und Sie diese Besuche verfolgen möchten, haben Sie die Möglichkeit, das Skript mit einer anderen Erweiterung zu laden: script.local.js.

In diesem Fall lautet das Snippet, das Sie in Ihre Site einfügen müssen, wie folgt (achten Sie darauf, das data-domain-Attribut in die Domäne zu ändern, die Sie zu Histat hinzugefügt haben):

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

Sie können diese Erweiterungen beliebig mischen und kombinieren. Wenn Sie beispielsweise sowohl unser Hash-basiertes Routing als auch unser Outbound-Link-Klick-Tracking verwenden möchten, können Sie sie wie folgt kombinieren: script.hash.outbound-links.js.

In diesem Fall lautet das Snippet, das Sie in Ihre Site einfügen müssen, wie folgt (achten Sie darauf, das data-domain-Attribut in die Domain zu ändern, die Sie zu Histat hinzugefügt haben):

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

Oder sagen wir, Sie möchten unsere script.revenue.js-Erweiterung verwenden, um E-Commerce-Umsätze zu verfolgen, und unsere script.local.js-Erweiterung, um Localhost-Verkehr zu verfolgen. Ihr Snippet sollte dann folgendermaßen aussehen:

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

Und Sie müssen nur dieses eine Snippet in Ihre Site einfügen, sonst ist nichts nötig.

script.compat.js

Das standardmäßige Histat-Skript funktioniert nicht im Internet Explorer, da es die API document.currentScript zum Lesen von Konfigurationsoptionen verwendet. Sie können Histat im Kompatibilitätsmodus ausführen, indem Sie die Erweiterung script.compat.js einbinden und id="plausible" im Skript-Tag definieren, damit es sich selbst finden kann. Beachten Sie, dass dies nur auf ≥ IE11 funktioniert. So sollte es aussehen:

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

script.manual.js

Standardmäßig löst das Histat-Skript beim ersten Laden eine Seitenansicht aus. Es fügt auch Listener an die History-API an und löst automatisch Seitenansichten aus, wenn Sie history.pushState verwenden. Dies ist für die meisten Websites nützlich, aber wir bieten auch einen manuellen Modus an, falls Sie die volle Kontrolle darüber haben möchten, wann Seitenaufrufe auf Ihrer Website ausgelöst werden.

Einer der Anwendungsfälle hierfür ist die Verwendung von Turbo (früher Turbolinks). In diesem Fall möchten Sie Histat-Seitenaufrufe manuell beim Browserereignis turbo:load oder turbolinks:load auslösen, je nachdem, welche Bibliothek Sie verwenden. So können Sie das tun:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- define the `plausible` function to manual trigger events -->
<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>

Wenn Sie Turbolinks verwenden, sollten Sie sicherstellen, dass das Histat-Skript während der Turbo-Navigation nicht geladen und ausgeführt wird. Möglicherweise müssen Sie das Skript in den Abschnitt <head> Ihrer Website verschieben oder dazu das Attribut data-turbo-eval="false" verwenden.

hinweis

Wenn Sie manual.js verwenden, führt jeder Skriptaufruf mit 'pageview' dazu, dass ein separater Seitenaufruf gezählt wird, auch wenn er auf derselben Seite aufgerufen wird

Geben Sie benutzerdefinierte Speicherorte für Ihre Seiten-URLs an

Zusätzlich können Sie mit der manuellen Skripterweiterung eine spezielle Option namens u mit Ihren Ereignissen bereitstellen. Damit können Sie die URL der Seite angeben und benutzerdefinierte Standorte angeben.

Es ist besonders hilfreich, mehrere Seiten zu redigieren und zu aggregieren, deren URLs benutzerspezifische Kennungen enthalten.

Benutzerdefinierte Abfrageparameter für vollständige Seiten-URLs verfolgen

Standardmäßig entfernt Histat aus Datenschutzgründen alle Abfrageparameter ref, source, utm_source, utm_medium, utm_campaign, utm_content und utm_term.

Das bedeutet, dass Seiten wie yoursite.com/blog/index.php?article=some_article&page=11 im Bericht „Top-Seiten“ Ihres Histat-Dashboards als yoursite.com/blog/index.php gemeldet werden.