Tracking-Code einbauen

Öffne dein Projekt im Projekt Manager und wähle im Projektmenü Einbauanleitung. Die angezeigten Schritte passen zu Trackingmodus, Bannerauswahl und Crawler-Einstellung dieses Projekts.

Tracking-Code übernehmen

1. Kopiere den Code unter Tracking-Code für die Besuchererfassung einbauen mit Code kopieren.
2. Füge ihn auf allen zu erfassenden Seiten in den <head> ein, direkt vor </head>. Bei einem gemeinsamen Website-Template genügt der Einbau an der Stelle, die diesen Kopf für alle betroffenen Seiten erzeugt.
3. Speichere bzw. veröffentliche die Änderung in deinem Website-System und rufe eine betroffene Seite neu auf.

Der Loader enthält die Projekt-ID im Attribut data-ti-id. Verwende den Code deines Projekts und binde ihn je Seite einmal ein. Eine zweite Einbindung über ein Plugin oder ein weiteres Template ist nicht erforderlich.

Eine Einbindung erst im Footer kann dazu führen, dass sehr kurze Besuche oder schnelle Seitenwechsel nicht vollständig erfasst werden.

Zusätzliche Dateien installieren

Wenn Notwendige Dateien installieren angezeigt wird, lade das dort angebotene Paket herunter. Es enthält abhängig von deiner Einstellung den TrafficInsight-Banner, die Crawler-Erfassung oder beides.

Entpacke das Paket und übernimm das vollständige Verzeichnis trafficinsight in das Root-Verzeichnis deiner Website. Die im Manager gezeigten Pfade setzen voraus, dass die Dateien dort erreichbar sind. Fehlt dieser Downloadschritt, benötigt deine aktuelle Variante diese zusätzlichen Dateien nicht.

Cookie-Banner anbinden

TrafficInsight Cookie-Banner

Bei dieser Variante zeigt der Manager CSS und JavaScript zur Initialisierung des Banners. Übernimm auch diese Codes an die angegebenen Stellen. Passe insbesondere den Link zur Datenschutzerklärung an deine Website an.

Vorhandener Cookie-Banner

Verbinde dessen gespeicherte und neu getroffene Entscheidungen mit den beiden Signalen aus Anonymous & Consent Mode.

Ein Consent-Projekt ohne bekannte Entscheidung wartet mit dem regulären Tracking. Bei einem Anonymous-Projekt startet die anonyme Erfassung direkt. Die Bannerauswahl im Manager allein stellt keine Verbindung zu einem fremden Banner her.

Crawler-Erfassung einbauen

Ist die Crawler-Erfassung aktiviert, zeigt der Manager zusätzlich Tracking-Code für die Erfassung von Crawlern und Suchmaschinenbots einbauen.

Übernimm die angebotenen Dateien und den angezeigten PHP-Code auf die zu erfassenden PHP-Seiten, idealerweise an die im Manager genannte Stelle am Dateiende. Der Code verwendet das Verzeichnis trafficinsight im Root deiner Website und funktioniert damit auch in PHP-Dateien in Unterverzeichnissen.

Dieser Schritt setzt voraus, dass dein Webserver PHP für diese Seiten ausführt. Allein das Einfügen des JavaScript-Trackers oder das Hochladen der PHP-Datei aktiviert noch keine Crawler-Erfassung auf den übrigen Seiten.

Installation überprüfen

Einen Besucherzugriff testen

1. Prüfe, dass das Projekt aktiv ist. Unter Noch nicht aktiviert, Tracking pausiert oder Offline werden keine neuen Zugriffe erfasst.
2. Rufe eine normale Seite deiner Website auf, auf der das Tracking eingebaut ist.
3. Bei einem Consent-Projekt: Akzeptiere die Einwilligung im Banner und rufe anschließend eine weitere Seite auf. Die gespeicherte Entscheidung muss dort wieder bereitstehen.
4. Kehre zu Einbauanleitung → Funktion testen zurück und wähle Einbau prüfen bzw. Einbau erneut prüfen.
5. Öffne die App für dasselbe Projekt, wähle Heute in der Projekt-Zeitzone und kontrolliere unter Inhalte die Seitenaufrufe. Lade die Werte mit dem Aktualisieren-Button neu.

Eine Erfolgsmeldung im Manager bestätigt, dass bereits Zugriffe erfasst wurden. Sie ist kein vollständiger Test aller Seiten, des Banners oder einzelner Zielvorhaben. Kontrolliere daher die konkrete Seite zusätzlich in der App. Ein erneuter Aufruf innerhalb derselben Sitzung erzeugt nicht zwingend einen neuen Sitzungsstart.

Crawler getrennt testen

Wenn du die Crawler-Erfassung verwendest, wähle außerdem Bot-Erkennung starten. Der Manager führt einen kontrollierten Abruf aus und prüft auf einen Crawl-Eintrag in den letzten fünf Minuten. Bei einer Fehlermeldung prüfe zuerst Dateien, PHP-Einbau und Erreichbarkeit der Website. Ein erfolgreicher Besuchertest ersetzt diesen Test nicht.

Fehlerseiten berücksichtigen

Erkannte 404-Seiten werden nicht erfasst. Falls der Browser den HTTP-Status nicht zuverlässig bereitstellt, lasse den Tracker im Fehlerseiten-Template weg oder setze dort vor dem Tracker diesen Marker:

<meta name="trafficinsight-status" content="404">

Der Marker gehört ausschließlich auf die Fehlerseite. In einem gemeinsamen Kopf für normale Seiten würde er deren Erfassung ebenfalls verhindern. Der PHP-Crawler-Einbau wertet den serverseitigen HTTP-Status aus; er liest diesen HTML-Marker nicht.

Wenn erwartete Daten fehlen, folge der Fehlersuche.