jumpurl dla TYPO3

jumpurl od TYPO3 7.6 został usunięty z Core i nie powinien być już używany

jumpurl był przez lata stałym elementem Core TYPO3 i wykonywał prostą rzecz: kierował pobierania i linki zewnętrzne przez URL przekierowujący, aby umożliwić zliczanie kliknięć. Pobieranie PDF nie szło bezpośrednio do przeglądarki, lecz przez adres jumpurl, który TYPO3 obsługiwało jako osobne żądanie i następnie przekierowywało do właściwego pobierania. W okresie szczytowym jumpurl było popularnym rozwiązaniem do śledzenia pobrań. Od TYPO3 7.6 jumpurl nie jest już częścią Core. Jako samodzielne rozszerzenie wprawdzie istnieje dalej, ale architektura jest przestarzała, a nowoczesne alternatywy są pod każdym względem lepsze.

Kto nadal używa jumpurl, pracuje z techniką z ery TYPO3 v4. Rozszerzenie generuje kryptyczne URL-e z parametrami hash, które nie są ani czytelne dla ludzi, ani przyjazne SEO. Własnych liczników kliknięć rozszerzenie nie dostarcza, tylko przekierowuje. Dla funkcji, którą dziś każdy standardowy setup analityki odwzorowuje przez zdarzenia, dodatkowe przekierowanie przy każdym kliknięciu nie jest już adekwatne do czasów.

Typowe scenariusze zastosowań to śledzenie pobrań i monitoring linków

Głównym scenariuszem było i jest śledzenie pobrań: ile razy pobrano whitepaper, cennik, katalog produktów? Samo jumpurl niczego przy tym nie protokołuje; liczy się żądania przekierowań, na przykład w logach serwera. Firmy z 50 do 200 pobraniami dziennie używają tych danych do strategii treści i kwalifikacji leadów.

Drugi scenariusz: śledzenie linków zewnętrznych. Gdy firmowa strona linkuje do partnerów, dostawców lub zasobów, przekierowania jumpurl w logach serwera pokazują, które cele zewnętrzne otrzymują najwięcej kliknięć. Jest to istotne dla programów afiliacyjnych, raportowania partnerów i analizy zachowania użytkowników.

Trzeci scenariusz: bezpieczne pobierania z kontrolą dostępu. jumpurl może powiązać pobieranie z logowaniem użytkownika, dzięki czemu tylko zalogowani użytkownicy mogą pobierać pliki. System tokenów zapewnia, że bezpośrednie URL-e do chronionych plików nie działają. Dla firm, które chcą udostępniać whitepapers, dokumentacje techniczne lub cenniki tylko po logowaniu, było to w erze TYPO3 v6 i v7 standardowym rozwiązaniem.

Architektura techniczna opiera się na przepisywaniu URL i przekierowaniu przez TYPO3

Od wersji 8 jumpurl rejestruje middleware PSR-15 we frontendzie TYPO3, który przechwytuje przychodzące żądania z parametrem jumpurl. Parametr zawiera docelowy URL lub ścieżkę pliku, a drugi parametr (juHash) hash, który chroni adres przed manipulacją. Middleware waliduje hash i kieruje przeglądarkę przez przekierowanie do właściwego celu, domyślnie z kodem statusu 303. Własnej tabeli na dane o dostępach rozszerzenie nie zakłada.

Konfiguracja odbywa się przez TypoScript: globalnie przez config.jumpurl_enable, dla pojedynczego linku lub linku do pliku przez opcję typolink jumpurl, a dla linków e-mail można ją wyłączyć przez config.jumpurl_mailto_disable. Rozszerzenie automatycznie modyfikuje generowane linki w frontendzie, dzięki czemu redaktorzy niczego nie muszą ręcznie dostosowywać. Integracja jest przezroczysta: redaktorzy linkują pliki jak zwykle, a jumpurl automatycznie wsuwa przekierowanie.

Własnego logu śledzenia ani modułu backendu rozszerzenie nie ma. Analizuje się to, co serwer WWW i tak zapisuje: znacznik czasu, adres IP (istotne dla RODO), wywołany adres jumpurl z celem, referrer HTTP i User-Agent.

Częste problemy dotyczą SEO, RODO i kompatybilności z przepisywaniem URL

Problem pierwszy: szkody SEO przez łańcuchy przekierowań. URL-e jumpurl nie są prawdziwymi URL-ami stron, lecz pośrednikami przekierowania. Gdy Google indeksuje link jumpurl (co przy błędnej konfiguracji się zdarza), powstaje łańcuch przekierowań, który marnuje crawl-budget i rozcieńcza link juice. Rozwiązanie: zapewnić, że URL-e jumpurl mają tag noindex lub robots-disallow.

Problem drugi: zgodność z RODO. Samo jumpurl niczego nie zapisuje, ale każde kliknięcie trafia z adresem IP do logu serwera WWW. Bez pseudonimizacji lub koncepcji usuwania to naruszenie RODO. W Polsce UODO traktuje to tak samo restrykcyjnie. Logi serwera muszą więc być regularnie czyszczone lub adresy IP muszą być anonimizowane przed zapisem.

Problem trzeci: kompatybilność z nowoczesnym routingiem URL. TYPO3 v12 używa Site-Handling i routingu opartego na Symfony. Jako middleware jumpurl wprawdzie działa pod v12, ale dopisuje swoje parametry jako query string do URL strony, przez co przyjazne adresy routingu znów dostają kryptyczne dodatki. Rozwiązaniem jest migracja na nowoczesną alternatywę. Dodatkowo kryptyczne parametry jumpurl w pasku adresu przeglądarki przeszkadzają w doświadczeniu użytkownika: użytkownicy widzą URL z wartościami hash zamiast czytelnej ścieżki pliku, co może budzić nieufność.

Migracja na śledzenie oparte na zdarzeniach jest zalecaną drogą przy każdym upgrade TYPO3

Rozszerzenie jest nadal utrzymywane, wersja 9.0.0 z listopada 2024 obsługuje TYPO3 v12.4 i v13.4. Mimo to przy migracji Gosign zaleca przejście na śledzenie pobrań oparte na zdarzeniach. Konkretnie oznacza to: atrybut data na linkach pobierania (np. data-track=“download”) i listener zdarzeń JavaScript, który wysyła kliknięcia do Matomo, Google Analytics 4 lub własnego endpointa. Dla bezpiecznych pobrań nowoczesną alternatywą jest kombinacja dostępu do plików opartego na FAL i systemu tokenów.

Nakład pracy na migrację zależy od ilości istniejących linków jumpurl. Gdy zewnętrzne źródła (newsletter, social media, druk) wskazują na URL-e jumpurl, trzeba skonfigurować przekierowania. Gosign analizuje istniejące dane o dostępach do adresów jumpurl, identyfikuje najczęściej używane pobierania i konfiguruje nowe rozwiązanie śledzenia tak, aby zapewnić historyczną porównywalność. Typowo 80% istniejących linków jumpurl to linki wewnętrzne, które można zautomatyzowano przepisać. Pozostałe 20% to referencje zewnętrzne, dla których trzeba skonfigurować stałe przekierowania 301, aby nie stracić link juice.