O SaveMyBudget Toolkit é de código aberto

Hoje publicámos como código aberto a parte de recolha de evidências da SaveMyBudget. Chama-se SaveMyBudget Toolkit, tem licença Apache-2.0 e corre como um único contentor Docker num servidor que controla.

O que faz

O toolkit regista cada clique do Google Ads que chega ao seu site e guarda o que o Google não consegue ver do seu lado: se a página chegou a estar visível, quanto tempo ficou aberta, se alguma coisa nela foi tocada, de que rede veio a visita e se o mesmo ID de clique apareceu mais do que uma vez.

Depois aplica dez regras de deteção a esses registos — cada uma documentada com o seu limiar predefinido e os falsos positivos conhecidos — e cria o pacote que o formulário de cliques inválidos do Google pede: um ficheiro de evidências com IDs de clique, datas e horas e endereços; um breve resumo factual; e um guia campo a campo do formulário. A submissão fica consigo. O Google analisa-o e decide o que, se for o caso, era inválido.

Se não quiser executar a tag, pode importar os registos do seu servidor web ou uma exportação de cliques. Com ambos, o toolkit também pode mostrar que pedidos chegaram ao seu servidor sem que a tag alguma vez tenha sido executada — o sinal mais claro de um clique que nenhum navegador fez.

O que não faz

Não se liga à sua conta do Google Ads. Não apresenta reclamações. Não atribui um valor aos cliques sinalizados — sinalizado não é o mesmo que inválido, e só o Google decide o que é creditado. Não bloqueia nada, embora possa exportar uma lista de IPs que poderá optar por adicionar às exclusões da sua campanha.

Em que difere do serviço

O serviço em savemybudget.io é a mesma ideia, executada por nós. Instala e monitoriza a tag, liga-se à sua conta do Google Ads para obter dados de campanha e custo, aplica regras adicionais e limiares calibrados entre contas, e prepara e apresenta as reclamações. É «sem sucesso, sem custo»: quando o Google confirma um crédito, ficamos com 25%. Se o Google não confirmar nada, não há cobrança.

O toolkit é para quem prefere fazer a recolha e a apresentação por si — agências com infraestrutura própria, programadores que querem ler o código antes de confiar num script no seu site e quem quer as evidências sem a relação com um fornecedor. O motor de regras e o coletor têm a mesma origem que os do serviço; a afinação, os sinais entre contas e a apresentação das reclamações não estão no repositório e não estarão.

Porque o abrimos

Por duas razões. Uma tag no site de alguém deve poder ser lida. A nossa é pequena, não tem dependências, nunca lê o conteúdo da página nem os campos de formulários e — na versão do toolkit — nunca nos contacta. É mais fácil afirmá-lo quando qualquer pessoa o pode verificar.

E o formulário do Google é público. O problema nunca foi o acesso; é ter registos suficientemente bons para o preencher. Se mais anunciantes mantiverem esses registos, serão feitos mais pedidos bem fundamentados, o que é bom para todos os que têm um orçamento de anúncios.

Telemetria, porque vai perguntar

O toolkit envia contagens de utilização anónimas — versão, quantos sites, quantas análises — e nada sobre os seus visitantes. Todos os campos estão listados no repositório. Uma variável de ambiente desliga-a.

Como obtê-lo

O repositório está em github.com/10xlabsio/savemybudget-toolkit. A instalação é um ficheiro Docker Compose com Caddy para TLS e demora cerca de dez minutos; a documentação abrange Google Tag Manager, Shopify, WordPress, Webflow, Wix e Squarespace. Issues e pull requests são bem-vindos. As alterações aos valores predefinidos das regras passam primeiro por uma discussão, porque um limiar é uma decisão de produto, não uma alteração de código.

Se preferir que o executemos nós: o serviço.