jumpurl para TYPO3

jumpurl foi removido do Core desde TYPO3 7.6 e não deve mais ser utilizado

jumpurl foi por anos parte integrante do Core TYPO3 e fazia uma coisa simples: redirecionar downloads e links externos por uma URL de redirect para tornar cliques contáveis. Um download PDF não ia diretamente ao navegador, mas por um endereço jumpurl que o TYPO3 processava como requisição própria e depois redirecionava ao download real. No auge da extensão, o jumpurl era uma solução difundida para tracking de downloads. Desde o TYPO3 7.6, jumpurl não faz mais parte do Core. Como extensão independente ainda existe, mas a arquitetura é desatualizada e alternativas modernas são superiores em todos os aspectos.

Quem ainda usa jumpurl trabalha com uma técnica da era TYPO3 v4. A extensão gera URLs crípticas com parâmetros hash que não são nem legíveis por humanos nem amigáveis ao SEO.

Cenários típicos de uso eram tracking de downloads e monitoramento de links

O cenário principal foi e é tracking de downloads: quantas vezes o whitepaper foi baixado, quantas vezes a lista de preços, quantas vezes o catálogo de produtos? O próprio jumpurl não registra nada; a contagem acontece pelas requisições de redirect, por exemplo nos logs do servidor.

Segundo cenário: tracking de links externos. Quando um site corporativo linka para parceiros, fornecedores ou recursos, os redirects do jumpurl nos logs do servidor mostram quais destinos externos recebem mais cliques. Isso é relevante para programas de afiliados e relatórios de parceiros.

Terceiro cenário: downloads seguros com controle de acesso. jumpurl pode vincular downloads a um login de usuário, para que apenas usuários logados possam baixar arquivos. O sistema de token garante que URLs diretas para arquivos protegidos não funcionem.

Arquitetura técnica se baseia em reescrita de URL e num redirect pelo TYPO3

Desde a versão 8, jumpurl registra um middleware PSR-15 no frontend do TYPO3 que intercepta requests de entrada com parâmetro jumpurl. O parâmetro contém a URL de destino ou o caminho do arquivo, e um segundo parâmetro (juHash) contém um hash que protege o endereço contra manipulação. O middleware valida o hash e redireciona o navegador ao destino real, por padrão com o código de status 303. A extensão não cria nenhuma tabela própria para os acessos.

A configuração ocorre via TypoScript: globalmente com config.jumpurl_enable, por link ou link de arquivo com a opção typolink jumpurl, e para links de e-mail ela pode ser desligada com config.jumpurl_mailto_disable. A extensão modifica automaticamente os links gerados no frontend para que editores não precisem adaptar nada manualmente.

A extensão não tem log de tracking nem módulo backend próprios. O que se analisa é o que o servidor web registra de qualquer forma: timestamp, endereço IP (relevante para LGPD (PT: RGPD)), o endereço jumpurl chamado com o destino, HTTP referrer e User-Agent.

Problemas frequentes envolvem SEO, LGPD e compatibilidade com reescrita de URL

Problema um: dano SEO por cadeias de redirect. URLs jumpurl não são URLs de página reais, mas intermediários de redirect. Se o Google indexa um link jumpurl (o que acontece com configuração incorreta), surge uma cadeia de redirect que desperdiça crawl budget e dilui link juice. A solução: garantir que URLs jumpurl tenham tag noindex ou robots disallow.

Problema dois: conformidade com a LGPD. O próprio jumpurl não armazena nada, mas cada clique vai parar, com o endereço IP, no log do servidor web. Sem pseudonimização ou conceito de exclusão, isso é uma violação da LGPD. Os logs do servidor devem por isso ser limpos regularmente ou os endereços IP anonimizados antes do armazenamento.

Problema três: compatibilidade com roteamento URL moderno. TYPO3 v12 usa Site Handling e roteamento baseado em Symfony. Como middleware, o jumpurl até funciona no v12, mas acrescenta seus parâmetros como query string à URL da página, de modo que as URLs amigáveis do roteamento voltam a ganhar anexos crípticos.

Migração para tracking baseado em eventos é o caminho recomendado em todo upgrade TYPO3

A extensão continua sendo mantida: a versão 9.0.0, de novembro de 2024, suporta o TYPO3 v12.4 e v13.4. Mesmo assim, em uma migração a Gosign recomenda a mudança para tracking de download baseado em eventos. Concretamente: um data-attribute em links de download (p.ex. data-track=“download”) e um event listener JavaScript que envia cliques ao Matomo, Google Analytics 4 ou um endpoint customizado. Para downloads seguros, a combinação de acesso a arquivo baseado em FAL e um sistema de token é a alternativa moderna.

O esforço de migração depende da quantidade de links jumpurl existentes. Se fontes externas (newsletter, mídia social, impressos) apontam para URLs jumpurl, redirects devem ser configurados. A Gosign analisa os dados de acesso existentes aos endereços jumpurl, identifica os downloads mais utilizados e configura a nova solução de tracking de forma a garantir comparabilidade histórica.