jumpurl dla TYPO3

jumpurl od TYPO3 v9 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 protokołował kliknięcie w bazie danych i następnie przekierowywał do właściwego pobierania. W okresie szczytowym rozszerzenie było używane przez szacunkowo 40% wszystkich instalacji TYPO3 do śledzenia pobrań. Od TYPO3 v9 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. Śledzenie opiera się na wpisach w bazie danych, których żadne nowoczesne narzędzie analityczne nie potrafi natywnie przeanalizować. Dla funkcji, która dziś każdy standardowy setup analityki odwzorowuje przez zdarzenia, własne rozszerzenie z obciążeniem bazy danych 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? jumpurl protokołuje każde kliknięcie w tabeli bazy danych ze znacznikiem czasu, adresem IP i referrerem. 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, jumpurl pokazuje, 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 logowaniu w bazie danych

jumpurl rejestruje handler eID w Core TYPO3, który przechwytuje przychodzące żądania z parametrem jumpurl. Parametr zawiera hash, który wskazuje na docelowy URL lub ścieżkę pliku. Handler loguje dostęp w tabeli bazy danych (tx_jumpurl_tracking), waliduje hash i kieruje przeglądarkę przez przekierowanie 302 do właściwego celu.

Konfiguracja odbywa się przez stałe TypoScript: które typy plików są śledzone (typowo: PDF, DOCX, XLSX, ZIP), czy są śledzone linki zewnętrzne i czy śledzenie jest aktywne. 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 warstwę śledzenia.

Log śledzenia zawiera: znacznik czasu, adres IP (istotne dla RODO), docelowy URL, referrer HTTP i User-Agent. Do analizy jest minimalny moduł backendu, który pokazuje liczby kliknięć na URL. Bardziej złożone analizy wymagają bezpośredniego dostępu do bazy danych lub eksportu.

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. jumpurl zapisuje adresy IP w formie jawnej. Bez pseudonimizacji lub koncepcji usuwania to naruszenie RODO. W Polsce UODO traktuje to tak samo restrykcyjnie. Tabela bazy danych musi być regularnie czyszczona 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. Architektura jumpurl oparta na eID koliduje w niektórych konfiguracjach z nowym routingiem i produkuje błędy 404. 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

jumpurl nie ma oficjalnego wsparcia dla TYPO3 v12 lub v13. 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 śledzenia 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.