Personyze in TYPO3 installieren

Die Personyze-Erweiterung für TYPO3 fügt das Personyze-Tag auf jeder Seite einer TYPO3-Website ein und wird über ein einziges Feld im TYPO3-Backend eingerichtet. Keine Template-Anpassungen, kein TypoScript, und nichts für einen Entwickler zu tun.

Unterstützt TYPO3 12.4 und 13.4 und benötigt PHP 8.1 oder neuer.

Installation

composer require personyze/personyze-typo3

Das ist die ganze Installation — TYPO3 aktiviert die Erweiterung automatisch.

Einrichtung

Öffnen Sie im TYPO3-Backend Admin Tools → Settings → Extension Configuration.
Öffnen Sie personyze.
Geben Sie Ihre Personyze-Konto-ID ein und speichern Sie.

Ihre Konto-ID finden Sie in Personyze unter Einstellungen → Tracking-Code: Es ist die Zahl im dortigen Snippet (siehe Personyze auf Ihrer Website aktivieren).

Das Tag ist ab dem nächsten Seitenaufruf aktiv. Sie müssen den TYPO3-Cache nicht leeren — auch nicht, wenn Sie die Konto-ID später ändern.

Warum kein Cache geleert werden muss. Der übliche Weg, in TYPO3 ein Script einzufügen, backt es in den Seitencache, wo eine geänderte Konto-ID erst erscheint, wenn jemand den Cache von Hand leert — das Speichern sähe dann aus, als hätte es nichts bewirkt. Diese Erweiterung fügt das Snippet ein, während die Antwort hinausgeht, bei jeder Anfrage, ob aus dem Cache oder nicht. Das Tag entspricht immer der aktuellen Einstellung.

Es gibt ein zweites Feld, Tracking domains. Lassen Sie es leer. Es wird nur gebraucht, wenn ein Personyze-Konto mehrere Domains erfasst, und nur mit dem Wert, den Ihnen der Personyze-Support nennt.

Was ein Tag bekommt und was nicht

Jede Frontend-Seite der Website.
Nicht das TYPO3-Backend. Die Erweiterung registriert sich nur im Frontend-Middleware-Stack von TYPO3, daher bekommt das Backend nie ein Tag, und die Klicks Ihrer eigenen Redakteure werden nie als Website-Traffic gezählt.
Keine Fehlerseiten. Nur eine normale, erfolgreiche HTML-Seite bekommt das Tag; eine 404- oder Fehlerantwort bleibt genau so, wie sie war.
Überhaupt nichts, solange keine Konto-ID gesetzt ist. Eine leere Einstellung bedeutet kein Tag, statt eines Tags, das an Konto 0 meldet.

Überprüfen

Öffnen Sie eine beliebige Frontend-Seite und sehen Sie sich den Quelltext an. Gesucht ist ein Script-Block mit stat-track-lib.js und einem Aufruf von _S_T.setup( mit Ihrer Konto-ID. Prüfen Sie dann Personyze: Die Website sollte innerhalb weniger Minuten Traffic melden.

Fehlerbehebung

Ich habe die Konto-ID gespeichert, und die Seiten haben immer noch kein Tag. Das sollte nicht passieren: Die Einstellung wirkt ab der nächsten Anfrage, ohne Cache-Leerung. Falls doch, prüfen Sie, ob die Erweiterung unter Admin Tools → Extensions aktiv ist, und denken Sie daran, dass ein CDN, Reverse Proxy oder Varnish vor TYPO3 einen eigenen Cache hat, den TYPO3 nicht leeren kann.

Kein Tag im TYPO3-Backend. So gewollt, siehe oben.

Das Tag ist da, aber Personyze meldet keinen Traffic. Prüfen Sie, ob die Konto-ID mit der unter Einstellungen → Tracking-Code übereinstimmt und ob Sie in Personyze dasselbe Konto ansehen.

Personyze in Drupal installieren
Personyze in Joomla installieren
WordPress-Plugin: eine WordPress-Website verbinden, befüllen und personalisieren
Personyze auf Ihrer Website aktivieren: der Tracking-Code, und woran Sie erkennen, dass er funktioniert