jumpurl for TYPO3

jumpurl ist seit TYPO3 v9 aus dem Core entfernt und sollte nicht mehr eingesetzt werden

jumpurl war jahrelang fester Bestandteil des TYPO3-Cores und tat eine simple Sache: Downloads und externe Links über eine Redirect-URL leiten, um Klicks zählbar zu machen. Ein PDF-Download ging nicht direkt an den Browser, sondern über eine jumpurl-Adresse, die den Klick in der Datenbank protokollierte und dann zum eigentlichen Download weiterleitete. In der Hochzeit der Extension nutzten geschätzt 40% aller TYPO3-Installationen jumpurl für Download-Tracking. Seit TYPO3 v9 ist jumpurl nicht mehr im Core enthalten. Als eigenständige Extension existiert sie zwar weiter, aber die Architektur ist veraltet und moderne Alternativen sind in jeder Hinsicht überlegen.

Wer jumpurl noch im Einsatz hat, arbeitet mit einer Technik aus der TYPO3-v4-Ära. Die Extension erzeugt kryptische URLs mit Hash-Parametern, die weder menschenlesbar noch SEO-freundlich sind. Das Tracking basiert auf Datenbank-Einträgen, die kein modernes Analytics-Tool nativ auswerten kann. Für ein Feature, das heute jedes Standard-Analytics-Setup über Events abbildet, ist eine eigene Extension mit Datenbank-Overhead nicht mehr zeitgemäss.

Typical use cases waren Download-Tracking und Link-Monitoring

Das Hauptszenario war und ist Download-Tracking: Wie oft wurde das Whitepaper heruntergeladen, wie oft die Preisliste, wie oft der Produktkatalog? jumpurl protokolliert jeden Klick in einer Datenbanktabelle mit Zeitstempel, IP-Adresse und Referrer. Unternehmen mit 50 bis 200 Downloads pro Tag nutzen diese Daten für Content-Strategie und Lead-Qualifizierung.

Zweites Szenario: Tracking externer Links. Wenn eine Unternehmenswebsite auf Partner, Lieferanten oder Ressourcen verlinkt, zeigt jumpurl, welche externen Ziele die meisten Klicks erhalten. Das ist relevant für Affiliate-Programme, Partner-Reporting und die Analyse des Nutzerverhaltens.

Drittes Szenario: Secure Downloads mit Zugriffskontrolle. jumpurl kann Downloads an eine Benutzeranmeldung koppeln, sodass nur eingeloggte Nutzer Dateien herunterladen können. Das Token-System stellt sicher, dass direkte URLs zu geschützten Dateien nicht funktionieren. Für Unternehmen, die Whitepapers, technische Dokumentationen oder Preislisten nur nach Login bereitstellen wollen, war das in der TYPO3-v6- und v7-Ära die Standardlösung.

Technical architecture is based on URL-Rewriting und Datenbank-Logging

jumpurl registriert einen eID-Handler im TYPO3-Core, der eingehende Requests mit einem jumpurl-Parameter abfängt. Der Parameter enthält einen Hash, der auf die Ziel-URL oder den Dateipfad verweist. Der Handler loggt den Zugriff in eine Datenbanktabelle (tx_jumpurl_tracking), validiert den Hash und leitet den Browser per 302-Redirect an das eigentliche Ziel weiter.

Die Konfiguration erfolgt über TypoScript-Konstanten: Welche Dateitypen getrackt werden (typisch: PDF, DOCX, XLSX, ZIP), ob externe Links erfasst werden und ob das Tracking aktiviert ist. Die Extension modifiziert automatisch die generierten Links im Frontend, sodass Redakteure nichts manuell anpassen müssen. Die Integration ist transparent: Redakteure verlinken Dateien wie gewohnt, und jumpurl schiebt die Tracking-Ebene automatisch dazwischen.

Das Tracking-Log enthält: Zeitstempel, IP-Adresse (GDPR (UK: UK GDPR)-relevant), Ziel-URL, HTTP-Referrer und User-Agent. Für die Auswertung gibt es ein minimales Backend-Modul, das Klickzahlen pro URL anzeigt. Komplexere Analysen erfordern direkten Datenbankzugriff oder einen Export.

Common problems involve SEO, GDPR und Kompatibilität mit URL-Rewriting

Problem eins: SEO-Schaden durch Redirect-Ketten. jumpurl-URLs sind keine echten Seiten-URLs, sondern Redirect-Intermediäre. Wenn Google einen jumpurl-Link indexiert (was bei falscher Konfiguration passiert), entsteht eine Redirect-Kette, die Crawl-Budget verschwendet und Link-Juice verdünnt. Die Lösung: Sicherstellen, dass jumpurl-URLs ein noindex-Tag oder ein robots-Disallow haben.

Problem zwei: GDPR compliance. jumpurl speichert IP-Adressen im Klartext. Ohne Pseudonymisierung oder Löschkonzept ist das ein Verstoss gegen die GDPR. Die Datenbanktabelle muss regelmässig bereinigt oder die IP-Adressen vor dem Speichern anonymisiert werden.

Problem drei: Kompatibilität mit modernem URL-Routing. TYPO3 v12 nutzt Site-Handling und Symfony-basiertes Routing. Die eID-basierte jumpurl-Architektur kollidiert in manchen Konfigurationen mit dem neuen Routing und produziert 404-Fehler. Die Lösung ist die Migration auf eine moderne Alternative. Zusätzlich stören die kryptischen jumpurl-Parameter in der Browser-Adresszeile die User Experience: Nutzer sehen eine URL mit Hash-Werten statt eines lesbaren Dateipfads, was Misstrauen erzeugen kann.

Migration auf eventbasiertes Tracking ist bei jedem TYPO3-Upgrade der empfohlene Weg

jumpurl hat keine offizielle Unterstützung für TYPO3 v12 oder v13. Bei einer Migration empfiehlt Gosign den Wechsel auf eventbasiertes Download-Tracking. Konkret bedeutet das: Ein data-Attribut auf Download-Links (z.B. data-track=“download”) und ein JavaScript-Event-Listener, der Klicks an Matomo, Google Analytics 4 oder ein Custom-Endpoint sendet. Für Secure Downloads ist die Kombination aus FAL-basiertem Dateizugriff und einem Token-System die moderne Alternative.

Der Migrationsaufwand hängt von der Menge der bestehenden jumpurl-Links ab. Wenn externe Quellen (Newsletter, Social Media, Print) auf jumpurl-URLs verweisen, müssen Redirects eingerichtet werden. Gosign analysiert die bestehenden jumpurl-Tracking-Daten, identifiziert die meistgenutzten Downloads und konfiguriert die neue Tracking-Lösung so, dass historische Vergleichbarkeit gewährleistet bleibt. Typischerweise sind 80% der bestehenden jumpurl-Links interne Verlinkungen, die automatisiert umgeschrieben werden können. Die verbleibenden 20% sind externe Referenzen, für die permanente 301-Redirects eingerichtet werden müssen, damit kein Link-Juice verloren geht.