UTM Builder ganha criação de links em lote por campanha

Depois de transformar uma ideia simples em um produto real de governança para GA4, o UTM Builder ganhou uma evolução importante para operações com maior volume de links: a criação de UTMs em lote.

A nova funcionalidade nasceu de uma necessidade prática de cliente: gerar dezenas de URLs parametrizadas para uma mesma campanha sem depender de preenchimento manual link por link, mas mantendo a mesma estrutura de controle, validação e histórico do sistema.

O problema: volume sem perder governança

Criar um link parametrizado manualmente é simples quando estamos falando de uma ou duas URLs.

Mas, em campanhas maiores, esse processo começa a escalar mal.

Imagine um projeto com 60, 70 ou 100 links diferentes, distribuídos entre idiomas, canais, peças, conteúdos, mensagens e páginas de destino.

Se cada URL for criada individualmente, aumentam os riscos de:

• erro de digitação em parâmetros UTM;

• variações indevidas em utm_source e utm_medium;

• nomes inconsistentes em utm_content, utm_term e utm_id;

• URLs duplicadas;

• links salvos sem relação clara com uma campanha;

• perda de rastreabilidade depois no GA4.

O desafio era permitir velocidade operacional sem abrir mão da padronização.

Como funciona a criação em lote

A nova opção aparece no UTM Builder dentro do contexto do link, ao lado de Link pontual e Campanha.

Agora o usuário pode escolher:

• Link pontual;

• Campanha;

• Lote de campanha.

No modo Lote de campanha, o fluxo é sempre vinculado a uma campanha cadastrada.

Isso é intencional.

A regra de negócio é simples: links em lote precisam nascer dentro de uma governança de campanha. Assim, todos os links importados ficam relacionados ao mesmo contexto estratégico e usam o slug da campanha selecionada como utm_campaign.

O fluxo operacional

O processo foi desenhado para ser simples:

1. O usuário seleciona ou cadastra uma campanha.

2. Baixa o modelo oficial em XLSX.

3. Preenche uma linha por link.

4. Faz o upload da planilha.

5. O sistema valida todas as linhas antes de salvar.

6. O usuário revisa avisos e erros.

7. Se estiver tudo certo, salva o lote.

Se houver erro, o sistema não salva o lote.

A pessoa corrige a planilha e sobe novamente.

Se houver apenas aviso, o sistema permite continuar, mas destaca os pontos que merecem atenção.

Por que usar um modelo XLSX oficial

A importação não aceita qualquer planilha solta.

O sistema oferece um modelo oficial para download, já com os campos esperados pelo backend.

As colunas seguem a estrutura operacional do UTM Builder:

• Nome interno;

• Link original;

• Source;

• Medium;

• Term;

• Content;

• ID;

• Tipo de ação;

• Destino;

• Grupo de anúncio;

• Tipo de anúncio/formato;

• Observações;

• Campaign.

Mesmo quando a planilha possui uma coluna Campaign, o sistema não usa esse valor como fonte final do utm_campaign.

O utm_campaign é definido pela campanha selecionada na interface.

Isso evita que uma planilha preenchida de forma inconsistente quebre a governança da campanha no GA4.

Validação antes do salvamento

A validação roda antes de qualquer gravação no banco.

O sistema verifica pontos como:

• existência de campanha selecionada;

• presença dos campos obrigatórios;

• URL base válida;

• utm_source preenchido;

• utm_medium preenchido;

• tipo de ação informado;

• destino informado;

• tipo de anúncio/formato informado;

• duplicidade de URL final dentro da própria planilha;

• normalização de valores para o padrão aceito.

Depois da validação, a interface mostra uma prévia com:

• número da linha;

• status;

• nome interno;

• URL final gerada;

• mensagens de erro ou aviso.

Essa prévia é importante porque mostra exatamente o que será persistido.

Antes de salvar, o usuário consegue comparar a planilha enviada com a URL final calculada pelo sistema.

Diferença entre aviso e erro

A interface separa claramente aviso de erro.

Um erro bloqueia o salvamento.

Um aviso não bloqueia, mas pede revisão.

Por exemplo: se a planilha trouxer uma coluna Campaign, o sistema mostra um aviso informando que esse valor será ignorado, porque o utm_campaign oficial virá da campanha selecionada.

Esse tipo de aviso aparece em amarelo.

Erros reais aparecem em vermelho.

Essa distinção é importante para não gerar ruído operacional. Nem todo ponto de atenção deve impedir o trabalho, mas tudo que pode afetar a leitura posterior precisa ficar visível.

Salvamento em massa

Depois da validação, o usuário pode salvar o lote.

Quando o salvamento é concluído, o sistema mantém a prévia visível e exibe uma mensagem de sucesso abaixo da validação.

O botão de salvar é substituído por um botão de reiniciar processo.

Isso evita duplicidade acidental e deixa claro que aquele lote já foi processado.

Ao reiniciar, o fluxo de lote é zerado para uma nova importação.

Registro em auditoria

A criação em lote também entra no log de atividade do UTM Builder.

O registro inclui informações como:

• campanha utilizada;

• slug da campanha;

• nome do arquivo enviado;

• quantidade de links criados;

• quantidade de linhas com aviso.

Isso mantém a rastreabilidade da operação e ajuda em verificações futuras, especialmente em ambientes com múltiplos usuários criando links.

Segurança e limites de upload

A funcionalidade foi preparada com alguns cuidados técnicos:

• upload limitado a 10 MB;

• validação no backend antes do salvamento;

• leitura controlada do arquivo XLSX;

• limite de linhas por lote;

• bloqueio de salvamento quando há erro;

• proteção contra fórmulas perigosas em exportações CSV;

• preservação das permissões e regras de autenticação existentes.

Além disso, a rotina de backup diário do sistema continua cobrindo os dados salvos, já que os links criados em lote entram nas mesmas tabelas dos links criados individualmente.

O impacto no GA4

Do ponto de vista de mensuração, o ganho principal está na consistência.

Todos os links de uma campanha passam a compartilhar o mesmo utm_campaign, definido pelo cadastro da campanha no sistema.

Ao mesmo tempo, cada linha pode variar parâmetros como:

• utm_term;

• utm_content;

• utm_id;

• URL de destino;

• nome interno;

• observações.

Isso permite organizar diferentes mensagens, peças, idiomas, canais ou pontos de distribuição sem quebrar a leitura consolidada da campanha no GA4.

Na prática, o time ganha velocidade na criação e mantém uma base mais limpa para análise posterior.

Conclusão

A criação de UTMs em lote é uma evolução natural do UTM Builder.

O produto continua resolvendo a mesma dor original: criar links parametrizados com mais controle, consistência e rastreabilidade.

A diferença é que agora ele atende melhor operações com volume.

Em vez de voltar para planilhas soltas como fonte final da verdade, o sistema usa a planilha apenas como interface de entrada.

A governança continua no UTM Builder.

A campanha continua sendo cadastrada e controlada no sistema.

A validação continua acontecendo antes do salvamento.

E o histórico continua disponível para auditoria e análise.

Esse é o tipo de evolução que fortalece o produto: mais eficiência para quem opera, sem sacrificar a qualidade dos dados que depois alimentam o GA4.