Exportar dados de link curto: as quatro coisas que você pode levar

Um encurtador de URL guarda quatro tipos de dados, e apenas um viaja sem problemas quando você sai. A tabela de links - slugs, destinos, tags e os domínios em que eles estão hospedados - é a classe para a qual todo fornecedor sério permite que você exporte dados de link curto, geralmente em CSV ou por API, porque o esquema é simples e toda plataforma precisa de um importador básico para conquistar novos clientes. As contagens agregadas de cliques também costumam estar disponíveis, embora a granularidade varie. Os eventos brutos de cliques - o registro linha a linha por clique, com timestamp, referenciador, dispositivo e IP - são a exceção: a maioria dos fornecedores nunca os expõe, porque a superfície de exportação nunca foi construída para a extração de histórico completo. Os metadados da conta - tags, domínios, usuários - ficam no meio do caminho, exportáveis em partes, e não em uma única extração limpa.

Trate a tabela de links como a única classe com a qual você pode realmente contar, planeje-se para perder todo o histórico bruto de cliques, e obtenha uma resposta por escrito sobre as contagens agregadas antes de assinar qualquer coisa. Esta não é mais uma história de migração - o guia de migração do Bitly já cobre essa transição. Este é o hábito permanente de tirar os seus próprios dados de lá, migrando ou não.

O que uma plataforma de link curto realmente guarda

Todo encurtador é construído em torno das mesmas quatro classes de dados. Saber qual é qual antes de precisar de uma exportação decide se uma migração ou uma auditoria vai levar uma tarde ou um trimestre.

• Tabela de links: slug, URL de destino, data de criação, tags, pasta e o domínio personalizado ao qual o link está atribuído.
• Contagens agregadas de cliques: um total vitalício por link, às vezes um detalhamento diário, ocasionalmente dividido por país ou referenciador.
• Eventos brutos de cliques: uma linha por clique, com o timestamp, IP, user agent e referenciador que o gerou.
• Metadados da conta: configurações do workspace, registros de domínio personalizado, a lista de membros da equipe, chaves de API, taxonomia de tags.

As quatro classes não são expostas de forma igual, e a diferença entre elas é o assunto central desta publicação.

Por que a tabela de links viaja e o histórico de cliques geralmente não

A tabela de links é portátil porque o seu esquema é propositalmente simples. Um slug, um destino, um punhado de campos opcionais - todo fornecedor aceita uma importação em CSV para conquistar novos clientes, o que significa que todo fornecedor também tem alguma forma de exportação em CSV, nem que seja apenas para que a página de marketing de um concorrente possa prometer "migre em uma tarde". O guia de falhas de migração do Bitly cobre o que realmente quebra quando você move essa tabela - capitalização do slug, barras finais, colisões de caminho em deep links. Esta publicação trata de um momento diferente: a extração de rotina que você faz, haja ou não uma migração no calendário.

O histórico de cliques é outra história. Uma exportação agregada, quando um fornecedor oferece uma, entrega um contador vitalício ou um total diário grosseiro - útil para um número de destaque, inútil quando você precisa de detalhe dia a dia ou por referenciador. A própria exportação do Bitly é um exemplo claro: ela entrega o contador vitalício por link e nada no nível de evento, um padrão que se repete na maior parte da categoria, não algo específico do Bitly. Uma vez que uma exportação descarta essa granularidade, ela se foi para sempre.

Onde os eventos brutos de cliques desaparecem

Os eventos brutos de cliques somem por um motivo estrutural, não por sovinice. Os armazenamentos de eventos de cliques são construídos para consultas dentro do próprio dashboard do fornecedor, não para extração em massa. A superfície de API que permitiria a um cliente percorrer milhões de linhas individuais de cliques é um compromisso de engenharia bem diferente de um gráfico de dashboard, e a maioria dos fornecedores nunca a constrói, porque a maioria dos clientes nunca pergunta antes de precisar dela.

A consequência é direta: assim que a sua conta ultrapassa a janela de retenção dos eventos brutos, ou um downgrade de plano corta o nível de API que os expunha, esses dados se perdem para sempre. A tabela de links costuma sobreviver a uma mudança de conta; o histórico de cliques por baixo dela não sobrevive. Mesmo onde existe uma API de eventos brutos, extrair um histórico completo esbarra na mesma mecânica que rege toda chamada grande contra uma API de encurtador - veja limites de taxa, retentativas e idempotência em uma API de encurtador para saber como ritmar uma extração de vários dias sem esbarrar no limitador. Se o histórico de cliques é algo que a sua equipe continua consultando, e não apenas arquivando, as análises de links do Elido são construídas para que a maior parte dessa consulta aconteça sem a necessidade de uma exportação, para começo de conversa.

Perguntas para fazer a um fornecedor antes de assinar

Faça essas perguntas antes de assinar, não depois que o aviso de downgrade chegar. Um fornecedor que responde às seis por escrito na ligação de vendas é um fornecedor em quem você pode confiar para continuar respondendo a elas daqui a um ano.

Se nada disso estiver escrito em lugar nenhum na documentação do seu fornecedor, esse silêncio já é a resposta à primeira pergunta. As APIs e SDKs do Elido publicam os endpoints de exportação, os limites de taxa e a janela de retenção na mesma documentação de referência de tudo o mais - recuperar os seus próprios dados nunca deveria exigir a abertura de um chamado de suporte.

Uma rotina de exportação agendada que mantém você independente

A solução é um hábito, não um projeto pontual. Faça uma exportação completa em um cronograma, antes que um downgrade ou uma disputa de cobrança force a questão, e você deixa de ser refém do que quer que o seu fornecedor decida que o seu nível de plano vale neste trimestre.

Agende a extração. Semanalmente para um workspace ativo, mensalmente para um mais tranquilo. Uma tarefa agendada que acessa os endpoints da tabela de links e das contagens agregadas é só algumas linhas de script; o importante é que ela rode sem supervisão.

Armazene fora do fornecedor. Um destino que você controla, não uma pasta dentro do próprio produto do qual você está exportando - o seu próprio armazenamento, um drive compartilhado, um repositório. Se o encurtador desaparecer amanhã, a exportação precisa sobreviver a isso. O mesmo formato de planilha usado para importar em massa links de campanha a partir de uma planilha funciona igualmente bem no sentido inverso, uma linha por link.

Verifique a contagem de linhas. Compare a contagem de linhas da exportação recém-feita com a contagem de links que o seu dashboard reporta. Uma diferença abaixo de um ou dois por cento é normal - links arquivados que você descartou de propósito. Uma diferença maior significa que a exportação deixou algo de fora.

Mantenha a última cópia válida conhecida. Guarde as últimas duas ou três extrações, não apenas a mais recente. Uma exportação corrompida sobrescrevendo a sua única cópia anula todo o propósito de baixar as análises de links em um cronograma.

Esse hábito também cobre uma ameaça mais silenciosa: a decadência comum de links (link rot). Os destinos por trás dos seus slugs se deterioram no próprio ritmo, independentemente do que o seu encurtador faça - veja prevenção de decadência de links para campanhas de URL curta para o lado da detecção desse problema. Uma exportação permanente dá a você o inventário para rodar essa detecção, independentemente de qual dashboard você esteja pagando este ano.

O que o Artigo 20 do GDPR realmente cobre aqui

A portabilidade de dados de links surge constantemente em conversas de compras, e ser preciso sobre o que o artigo realmente alcança muda a negociação.

O Artigo 20 do GDPR dá ao titular dos dados o direito de receber os dados pessoais que forneceu a um controlador, em um formato estruturado e de leitura automatizada, e de tê-los transferidos para outro controlador - mas apenas para tratamento baseado em consentimento ou contrato, e apenas por meios automatizados. As diretrizes do WP29 sobre portabilidade de dados restringem isso ainda mais: o direito cobre dados fornecidos diretamente ou gerados pelo próprio uso de um serviço pelo titular, não dados inferidos sobre ele.

Duas consequências decorrem disso. Primeiro, este é um direito do indivíduo contra um controlador, não um direito de uma empresa sobre as suas próprias análises agregadas - nenhum direito do GDPR devolve à sua equipe de marketing o histórico de cliques mediante solicitação. Segundo, a maior parte do rastreamento de cliques em nível de campanha se apoia em interesse legítimo, e não em consentimento ou contrato, como o cornerstone de GDPR para encurtadores de URL cobre em detalhe, e o Artigo 20 não se aplica ao tratamento realizado nessa base, independentemente de quem sejam os dados. Recuperar o seu histórico de cliques de um fornecedor é uma questão de compras, resolvida pelo contrato e pela API de exportação descrita acima, não por um artigo de proteção de dados. Se os dados subjacentes de IP ou dispositivo são de fato dados pessoais, e por quanto tempo você tem o direito de mantê-los, é algo coberto separadamente em retenção de dados de cliques.

Verificando uma exportação antes de confiar nela

Uma exportação que você não conferiu é um boato, não um registro. Faça três verificações antes de arquivá-la em qualquer lugar ou excluir a fonte.

Conte as linhas e compare com o total de links do dashboard; investigue qualquer diferença acima de um ou dois por cento. Abra o arquivo na ferramenta que você realmente pretende usar - uma exportação em csv que parece correta em um editor de texto ainda pode ter um delimitador quebrado ou um problema de codificação que uma planilha só revela ao processar o arquivo, e é por isso que vale a pena conferir uma amostra contra a RFC 4180 em vez de simplesmente presumir. Faça uma checagem pontual em um punhado de links conhecidos, incluindo deliberadamente um que você arquivou ou excluiu, já que excluir silenciosamente os links inativos é a forma mais comum de uma exportação parecer completa sem estar.

Já vi uma revisão de conformidade travar por uma semana por causa de uma exportação que faltava todos os links criados antes de um upgrade de plano dezoito meses antes - ninguém tinha avisado a ferramenta de que aqueles links existiam sob um ID interno diferente. Trinta minutos de conferência da contagem de linhas teriam pego isso antes de a revisão começar.

Relacionados no blog

• Migrando do Bitly para o Elido: um guia técnico
• Migre do Bitly sem quebrar links: um guia de modos de falha
• GDPR para encurtadores de URL: o que o seu DPO realmente quer ver
• Retenção de dados de cliques: por quanto tempo manter os registros de análise
• API de encurtador de URL: limites de taxa, retentativas, idempotência