jumpurl para TYPO3

jumpurl foi removido do Core desde TYPO3 v9 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 registrava o clique no banco de dados e depois redirecionava ao download real. No auge da extensão, estimadamente 40% de todas as instalações TYPO3 usavam jumpurl para tracking de downloads. Desde TYPO3 v9, 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? jumpurl registra cada clique em uma tabela de banco de dados com timestamp, endereço IP e referrer.

Segundo cenário: tracking de links externos. Quando um site corporativo linka para parceiros, fornecedores ou recursos, jumpurl mostra 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 logging de banco de dados

jumpurl registra um handler eID no Core TYPO3 que intercepta requests de entrada com parâmetro jumpurl. O parâmetro contém um hash que referencia a URL de destino ou o caminho do arquivo. O handler registra o acesso em uma tabela de banco de dados (tx_jumpurl_tracking), valida o hash e redireciona o navegador via redirect 302 ao destino real.

A configuração ocorre via constantes TypoScript: quais tipos de arquivo são rastreados (típico: PDF, DOCX, XLSX, ZIP), se links externos são capturados e se o tracking está ativado. A extensão modifica automaticamente os links gerados no frontend para que editores não precisem adaptar nada manualmente.

O log de tracking contém: timestamp, endereço IP (relevante para LGPD (PT: RGPD)), URL de destino, HTTP referrer e User-Agent. Para a análise, existe um módulo backend mínimo que mostra contagens de cliques por URL. Análises mais complexas requerem acesso direto ao banco de dados ou exportação.

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. jumpurl armazena endereços IP em texto claro. Sem pseudonimização ou conceito de exclusão, isso é uma violação da LGPD. A tabela do banco de dados deve ser limpa 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. A arquitetura jumpurl baseada em eID colide em algumas configurações com o novo roteamento e produz erros 404.

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

jumpurl não tem suporte oficial para TYPO3 v12 ou v13. 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 tracking jumpurl existentes, identifica os downloads mais utilizados e configura a nova solução de tracking de forma a garantir comparabilidade histórica.