Zum Inhalt springen
LeadsPilot

Integration

LeadsPilot in TYPO3 einbauen

In TYPO3 gibt es kein Eingabefeld «Code im Head» für Redaktoren. Die LeadsPilot-Zeile wird stattdessen per TypoScript über page.headerData oder direkt im Template des Sitepackage ausgegeben. Das ist eine Sache von wenigen Zeilen, gehört aber in die Hände der Person, die das TYPO3-Setup betreut.

Wer macht das bei euch?

TYPO3 läuft selten bei Kleinstbetrieben. Typisch sind Industrieunternehmen, Verbände, Hochschulen, Gemeinden und grössere KMU, oft mit einer Agentur im Hintergrund. Redaktoren haben in der Regel keine Rechte für TypoScript. Die schnellste Lösung ist deshalb meist eine kurze Nachricht an die Agentur mit dem Verweis auf diese Seite und deinem Schlüssel aus LeadsPilot. Der Aufwand liegt im Bereich weniger Minuten plus Deployment.

Variante A: TypoScript mit page.headerData

Dies ist der übliche Weg. Im TypoScript-Setup wird ein Eintrag in page.headerData ergänzt:

page.headerData.9876 = TEXT
page.headerData.9876.value = <script async src="https://www.blogpilot.ch/b.js" data-k="DEIN-SCHLUESSEL"></script>

Die Zeile selbst ist dieselbe wie überall:

<script async src="https://www.blogpilot.ch/b.js" data-k="DEIN-SCHLUESSEL"></script>

Hinweise dazu:

  • Die Zahl 9876 ist frei gewählt. Sie darf nur nicht schon von einem anderen Eintrag in page.headerData belegt sein.
  • page ist der übliche Name des PAGE-Objekts. Heisst es in eurem Setup anders, passt du den Namen an.
  • Im Sitepackage steht das Setup meist in einer Datei unter Configuration/TypoScript/. Der genaue Pfad hängt vom Aufbau des Sitepackage ab.
  • Für einen Test im Backend: Modul für TypoScript öffnen, das Root-Template der Site bearbeiten und die zwei Zeilen im Feld «Setup» ergänzen. Das Modul heisst je nach TYPO3-Version «Template» oder «TypoScript».

Variante B: direkt im Fluid-Layout

Wenn euer Sitepackage den Kopfbereich in einem eigenen Template oder über einen ViewHelper für Header-Daten pflegt, kann die Zeile auch dort stehen. Das ist gleichwertig. Wichtig ist nur, dass sie auf jeder Seite ausgegeben wird, auch auf Seiten mit abweichendem Backend-Layout, auf Landingpages und auf Detailseiten von Extensions wie News.

Danach: Caches leeren

TYPO3 speichert Seiten und TypoScript zwischen. Nach der Änderung:

  1. Im Backend oben auf das Blitz-Symbol klicken.
  2. Die Frontend-Caches leeren. Bei Änderungen im Sitepackage zusätzlich alle Caches leeren.
  3. Liegt ein Reverse Proxy oder ein CDN vor der Website, auch dort den Cache leeren.

Die drei TYPO3-typischen Stolpersteine

Content Security Policy. Neuere TYPO3-Versionen können eine Content Security Policy für das Frontend ausliefern, und viele Betreiber setzen zusätzlich Header auf dem Webserver. Ist eine solche Richtlinie aktiv, muss https://www.blogpilot.ch als erlaubte Quelle für Scripts eingetragen werden. Weil das Script Messdaten überträgt, lohnt sich nach der Freigabe ein Blick in die Browser-Konsole, ob weitere Meldungen zur Richtlinie erscheinen.

Bedingungen im TypoScript. Steht der Eintrag versehentlich innerhalb einer Bedingung, etwa nur für eine Sprache oder nur für die Produktivumgebung, fehlt er an anderer Stelle. Für Testumgebungen ist eine solche Bedingung allerdings sinnvoll, damit interne Aufrufe auf dem Staging-System nicht mitgezählt werden.

Consent-Extension. Viele TYPO3-Seiten setzen eine Extension oder ein externes Werkzeug für Cookie-Einwilligungen ein, das Scripts verwaltet. LeadsPilot ist so gebaut, dass kein Cookie gesetzt und kein localStorage genutzt wird. Ob das Script deshalb ohne Einwilligung laufen darf, beurteilt bei Organisationen dieser Grösse üblicherweise die zuständige Fachperson für Datenschutz. Die Grundlagen dafür stehen unter Datenschutz und Sicherheit, eine AVV-Vorlage und ein Textbaustein für die Datenschutzerklärung werden mitgeliefert.

Abnahme durch den Fachbereich

Diese Punkte kannst du selbst prüfen, ohne ins Backend zu müssen:

  • Startseite im privaten Fenster öffnen, Quelltext anzeigen, b.js suchen.
  • Dasselbe auf einer Produktseite, einer News-Detailseite und der Kontaktseite.
  • Bei mehrsprachigen Seiten jede Sprachversion kontrollieren.
  • In LeadsPilot nachsehen, ob die automatische Prüfung den Code gefunden hat.

Was TYPO3-Betreiber mit den Daten anfangen

Websites auf TYPO3 sind oft umfangreich: Produktkataloge, Downloads, Stellen, Medienmitteilungen. Entsprechend gemischt ist das Publikum. Im Dashboard filterst du nach Score und Ort und siehst pro Firma, welche Seiten angesehen wurden. Für den Vertrieb sind Firmen interessant, die Produktseiten, Datenblätter und danach die Kontakt- oder Offertseite aufrufen. Besuche auf der Stellenseite zeigen dagegen eher Bewerber oder Personalvermittler.

Weil das Publikum solcher Websites zu einem guten Teil aus grösseren Firmen, Verwaltungen und Hochschulen besteht, also aus Organisationen mit eigenem Netz, fällt die Erkennung hier tendenziell besser aus als bei Seiten für Kleinstbetriebe. Eine Quote versprechen wir nicht, sie zeigt sich im Test. Wie Industriefirmen damit arbeiten, liest du zum Beispiel auf der Seite für den Maschinenbau. Sollen die Firmen ins CRM fliessen, hilft die Übersicht der Integrationen.

Der Test dauert 5 Tage und umfasst alle Funktionen für eine Website: kostenlos testen.

Häufige Fragen

Brauche ich für LeadsPilot eine TYPO3-Extension?

Nein. Die Zeile wird per TypoScript oder im Template des Sitepackage ausgegeben. Eine Extension würde nur zusätzlichen Wartungsaufwand bei TYPO3-Upgrades bedeuten.

Wo füge ich das TypoScript ein, im Backend oder im Sitepackage?

Wenn eure Website ein versioniertes Sitepackage hat, gehört die Änderung dorthin, damit sie nachvollziehbar bleibt und ein Deployment sie nicht überschreibt. Für einen schnellen Test geht auch das Setup-Feld des Root-Templates im Backend. Besprich das mit der Agentur oder dem internen Entwickler.

Warum blockiert der Browser das Script nach dem Einbau?

Vermutlich ist eine Content Security Policy aktiv, entweder über TYPO3 selbst oder über den Webserver. Dann muss die Quelle www.blogpilot.ch für Scripts freigegeben werden. In der Browser-Konsole steht in diesem Fall eine entsprechende Meldung.

Funktioniert das bei mehreren Sites in einer TYPO3-Instanz?

Ja. Jede Site bekommt in LeadsPilot einen eigenen Schlüssel, und das TypoScript wird pro Seitenbaum gesetzt. Wie viele Websites dein Paket abdeckt, hängt vom gewählten Paket ab.

Finde heraus, wer sich gerade für dich interessiert

Eine Zeile Code einbauen, fünf Tage kostenlos testen. In wenigen Minuten siehst du die ersten Firmen.