Die Messung auf Ihrer Website einrichten

Das Setzen des Skripts ist der einzige technische Schritt in Pulsar. Hier ist das genaue Vorgehen für jede Umgebung, auch für die mit Überraschungen.

Kurz gesagt

Kopieren Sie die beiden Skriptzeilen aus Ihren Einstellungen, fügen Sie sie in den Kopfbereich Ihrer Seiten ein, und die Messung beginnt beim ersten Besuch. Dasselbe Zeilenpaar funktioniert sowohl beim direkten Einbau als auch über einen Tag-Manager.

Die beiden zu kopierenden Zeilen

Öffnen Sie Ihre Website in Pulsar und gehen Sie zu Einstellungen, Installation. Der schwarze Kasten enthält genau das, was gesetzt werden muss. Kopieren Sie ihn vollständig: jede Zeile hat ihre Aufgabe, und eine wegzulassen zerstört bestimmte Installationen.

Die erste Zeile legt die Konfiguration in einer globalen Variablen ab und bereitet die Warteschlange für eigene Ereignisse vor. Sie lädt nichts.
Die zweite Zeile lädt das Messskript, asynchron, mit derselben Konfiguration, wiederholt als data-*-Attribute.

Die Konfiguration steht absichtlich zweimal da, in der globalen Variablen und in den Attributen. Genau das macht dasselbe Zeilenpaar überall gültig, auch unter einem Tag-Manager, der Attribute entfernt. Löschen Sie also nicht die Zeile, die Ihnen überflüssig erscheint.

Direkter Einbau im HTML

Das ist die zuverlässigste Methode und diejenige, die immer vorzuziehen ist, wenn sie möglich ist. Das Skript hängt von keinem Zwischenglied ab, und nichts kann es verzögern oder entfernen.

1 Öffnen Sie die Vorlage, die den <head> aller Ihrer Seiten erzeugt.
2 Fügen Sie die beiden Zeilen unmittelbar vor </head> ein.
3 Veröffentlichen Sie und laden Sie danach eine Seite Ihrer Website.
4 Kehren Sie zu Einstellungen, Installation zurück und klicken Sie auf Testen: Pulsar sagt Ihnen, ob etwas angekommen ist.

WordPress

Drei Wege, vom dauerhaftesten zum schnellsten. Der erste übersteht Theme-Aktualisierungen, die anderen nicht.

Über ein Plug-in zum Einfügen von Code. WPCode, Header Footer Code Manager oder Vergleichbares. Fügen Sie die beiden Zeilen in den Kopfbereich ein, website-weit. Das ist der empfohlene Weg: bei einer Theme-Aktualisierung geht nichts verloren.
Über die Theme-Einstellungen. Viele Themes bieten im Customizer ein Feld « Kopfzeilen-Skripte ». Bequem, aber der Inhalt gehört zum Theme: ein Theme-Wechsel löscht das Skript.
Über die Datei header.php. Nur in einem Child-Theme. In einem Parent-Theme überschreibt die nächste Aktualisierung Ihre Änderung ohne Vorwarnung.

Nutzt Ihre Website einen Cache, leeren Sie ihn nach dem Einbau. Eine aus dem Cache ausgelieferte Seite behält ihr altes HTML, ohne das Skript, und Sie würden fälschlich schließen, der Einbau sei fehlgeschlagen.

Google Tag Manager, im Detail

GTM funktioniert, verlangt aber eine Vorsichtsmaßnahme, auf die nichts hinweist. Der Container bindet externe Skripte ohne ihre data-*-Attribute ein und setzt document.currentScript auf null. Ein Skript, das seine Konfiguration aus seinen Attributen läse, fände also nichts und bliebe stumm, ohne jede Fehlermeldung.

Genau dafür gibt es die erste Zeile. Fügt man beide Zeilen gemeinsam ein, läuft die Konfiguration über die globale Variable und der Einbau funktioniert.

1 Öffnen Sie in GTM Tags und dann Neu.
2 Wählen Sie den Typ Benutzerdefiniertes HTML.
3 Fügen Sie beide aus Ihren Einstellungen kopierten Zeilen unverändert ein.
4 Lassen Sie document.write unterstützen deaktiviert: das Skript braucht es nicht.
5 Trigger: Alle Seiten, vom Typ Seitenaufruf. Wählen Sie die früheste verfügbare Initialisierung, um Besucher nicht zu verlieren, die sofort wieder gehen.
6 Benennen Sie den Tag, speichern Sie und veröffentlichen Sie den Container. Ein gespeicherter, aber nicht veröffentlichter Tag bewirkt nichts.
7 Prüfen Sie im Vorschaumodus: der Tag muss als ausgelöst erscheinen, und der Netzwerk-Tab muss einen Aufruf an die Erfassungsdomain zeigen.

Ein Einbau über GTM fügt eine Abhängigkeit hinzu: blockiert ein Besucher den Container, blockiert er auch Ihre Messung. Blocker zielen weit häufiger auf GTM als auf Pulsar. Bei einem technischen Publikum erreicht der Abstand zum direkten Einbau häufig fünfzehn Prozent.

Shopify

1 Öffnen Sie in der Verwaltung Onlineshop, Themes und dann Code bearbeiten beim aktiven Theme.
2 Öffnen Sie layout/theme.liquid.
3 Fügen Sie die beiden Zeilen unmittelbar vor </head> ein.
4 Speichern Sie: Shopify veröffentlicht sofort.

Der Bezahlvorgang von Shopify wird von eigenen Seiten ausgeliefert, auf die diese Datei nicht wirkt. Die Bezahlseiten werden daher nicht gemessen, außer bei Tarifen, die Skripte im Bezahlvorgang erlauben.

Webflow, Wix, Squarespace

Webflow: Projekteinstellungen, Reiter Custom code, Feld Head code. Veröffentlichen Sie die Website erneut, eigener Code ist in der Vorschau nicht aktiv.
Wix: Einstellungen, Tracking und Analyse, ein eigenes Werkzeug hinzufügen, Geltungsbereich Alle Seiten, Platzierung Head.
Squarespace: Einstellungen, Code-Injektion, Feld Header. Ab den Business-Tarifen verfügbar.

Single-Page-Anwendungen: React, Vue, Next, Nuxt

Nichts Besonderes zu tun. Das Skript verfolgt den Navigationsverlauf, einschließlich pushState, replaceState und der Zurück-Schaltfläche: jeder Ansichtswechsel zählt als Seitenaufruf, ohne Aufruf von Ihrer Seite.

Setzen Sie die beiden Zeilen in das HTML-Grunddokument: index.html bei Vite, app/layout.tsx bei Next mit der Script-Komponente in der Strategie afterInteractive, app.html bei SvelteKit.

Rufen Sie das Pixel bei jedem Routenwechsel nicht von Hand auf: Sie würden jede Ansicht doppelt zählen. Die Verlaufsverfolgung ist bereits vorhanden.

Das Skript von Ihrer eigenen Domain ausliefern

Standardmäßig kommt das Skript von der Erfassungsdomain von Pulsar. Sie können es von einer Subdomain Ihrer eigenen ausliefern, etwa stats.ihreseite.de. Es ist dann keine Drittressource mehr.

Der Vorteil ist doppelt: es entgeht den Sperrlisten, die auf Analysedomains zielen, und es nutzt eine bereits offene Verbindung, was die bei schnellen Navigationen verlorenen Seitenaufrufe zurückholt. Je nach Publikum sind das fünf bis zwanzig Prozent der Besuche.

Die Einstellung liegt in Einstellungen, Installation. Das Skript leitet seine Erfassungsadresse dann aus seiner eigenen Herkunft ab: die beiden angezeigten Zeilen werden automatisch aktualisiert, Sie müssen sie nur erneut kopieren.

Prüfen, ob alles funktioniert

Die Schaltfläche Testen in den Einstellungen fragt die Erfassung ab und sagt Ihnen, ob Daten eingehen. Das ist die schnellste Prüfung.

Im Zweifel öffnen Sie die Konsole Ihres Browsers, Reiter Netzwerk, und laden eine Seite Ihrer Website neu. Sie müssen dort eine Anfrage an die Erfassungsdomain sehen, die auf /e endet.

Gar keine Anfrage. Das Skript ist nicht geladen: prüfen Sie, ob es wirklich im ausgelieferten HTML steht und nicht nur in Ihrer Vorlage.
Anfrage blockiert. Eine Browsererweiterung filtert sie. Testen Sie im privaten Modus mit deaktivierten Erweiterungen.
Anfrage gesendet, keine Zahlen. Ihre IP-Adresse steht wahrscheinlich in den Ausschlüssen des Kontos. Das ist die häufigste Ursache für ein « es funktioniert nicht », obwohl alles funktioniert.

Eine bestimmte Aktion messen

Sobald das Skript sitzt, können Sie aus Ihrem Code ein Ereignis melden, etwa beim Absenden eines Formulars:

pulsar('angebot_gesendet', { tarif: 'pro' })

Der Aufruf funktioniert auch, bevor das Skript vollständig geladen ist: die erste Zeile des Schnipsels stellt die Aufrufe in eine Warteschlange, und das Skript arbeitet sie bei seinem Eintreffen ab. Sie können ihn also ohne Rücksicht auf die Reihenfolge verwenden.

Ein Ereignis wird zur verfolgten Conversion, sobald Sie es als Ziel markieren, mit einem Klick auf den Stern im Dashboard.

Fehlt Ihnen eine Antwort? Schreiben Sie uns. Wir antworten selbst und ergänzen diesen Leitfaden.

Eine Frage stellen