Das Leadfeeder Tracking-Skript kann Änderungen der Seiten-URL automatisch tracken, um Seitenaufrufe in der Web Visitors App zu erkennen. Das funktioniert in den meisten Fällen, sowohl bei klassischen Webanwendungen als auch bei Single-Page-Applications. Wenn Du ein erweitertes Tracking einrichten möchtest, kannst Du mit der Leadfeeder JavaScript-API eigene Events an das Tracking-Skript senden.
Beispiele für den Einsatz der JavaScript-API:
Übergänge bzw. virtuelle Seitenaufrufe tracken
Events tracken, die keine Seitenaufrufe sind, zum Beispiel Dialoge auf der Seite oder die Wiedergabe von Videos und Medien
Wenn Du das Leadfeeder Tracking-Skript mit dem Google Tag Manager installierst, füge <script> vor dem Skript und </script> am Ende des Skripts hinzu.
Nutzung der API
Das Leadfeeder Tracking-Skript stellt eine Reihe von Methoden bereit, die die Webseite bei Bedarf aufrufen kann. Alle diese Methoden befinden sich im Objekt window.ldfdr auf der Seite.
Beachte bei der Nutzung der Leadfeeder JavaScript-API, dass das Leadfeeder Tracking-Skript mehrere Tracker auf einer Seite unterstützt. Die Methoden der JavaScript-API gelten standardmäßig für alle Tracker. Du kannst sie aber auch nur für bestimmte Tracker-Instanzen aufrufen. Wenn Du zum Beispiel zwei verschiedene Leadfeeder Tracking-Skripte auf der Webseite hast, sendet der Aufruf von window.ldfdr.track() ein Tracking-Event an beide.
pageview()
Sendet ein Seitenaufruf-Event. Argumente werden als Objekt unterstützt.
window.ldfdr.pageview({ pageUrl: "https://www.example.com", pageTitle: "Example page" });Wenn keine Argumente angegeben sind, wird für pageUrl standardmäßig window.location.href und für pageTitle document.title verwendet.
getAll()
Gibt ein Array aller Tracker-Instanzen auf der Seite zurück. Wie Du mit den Tracker-Instanzen arbeitest, erfährst Du unter getTracker() unten.
getTracker(trackerId)
Ruft eine Tracker-Instanz anhand der trackerId ab. Für die Tracker-Instanz werden folgende Methoden unterstützt:
var tracker = window.ldfdr.getTracker("abcdef"); // Sends a pageview to specific tracker, supports //same arguments as pageview() above tracker.pageview();getClientId()
Mit folgendem Aufruf erhältst Du die clientId:
window.ldfdr.getTracker("abcdef").getClientId()Die ClientID ist die Besucher-ID, die im Leadfeeder-Cookie gespeichert ist. Sie entspricht dem Feld lf_client_id, das der Visits-Endpunkt der Web Visitors API zurückgibt.
identify()
identify() ist eine der Methoden, die die Leadfeeder JavaScript-API für die Webseite bereitstellt. Mit identify() kannst Du Deine bestehenden Methoden zur Identifizierung von Website-Besuchern in Web Visitors nutzen. Siehe So trackst Du eingeloggte User auf Deiner Website.
Prüfen, ob das Tracking-Skript bereit ist
So erkennst Du, wann Du window.ldfdr.getTracker() bei Nutzung der JS-API sicher aufrufen kannst:
Nutze diesen Event-Listener, um Code auszuführen, sobald das Tracking-Skript bereit ist:
document.addEventListener('ldfdr.trackerReady', function(event) { // do stuff });Um die Besucher-ID (lfClientId) zu nutzen, verwende:
document.addEventListener('ldfdr.trackerReady', function(event) { var id = event.tracker.getClientId(); // do stuff });Ablauf des Leadfeeder-Cookies
Standardmäßig läuft das Leadfeeder-Cookie nach einem Jahr (365 Tagen) ab. Wenn Du möchtest, kannst Du das Cookie mit folgendem Code früher ablaufen lassen:
window.ldfdr('cfg','trackingCookieDurationDays',<numDays>,ss);Wenn Du die Google Tag Manager Vorlage von Leadfeeder nutzt, kannst Du alternativ die Option ‘Number of days until the Leadfeeder cookie expires’ anpassen. Das gilt nur, wenn das Leadfeeder-Cookie aktiviert ist.
Eine geänderte Ablaufzeit des Cookies wird nur berücksichtigt, wenn Du Cookies im Tab Cookie-Einstellungen aktiviert hast. Wenn Du den GTM nutzt, brauchst Du außerdem die neueste Version des Leadfeeder Tracking-Skripts im GTM. Prüfe die Vorlage im GTM auf mögliche Updates.
--
Fragen, Kommentare oder Feedback? Kontaktiere unser Support-Team über den Chat oder per E-Mail an support@leadfeeder.com.