Il SaveMyBudget Toolkit è open source

Oggi abbiamo pubblicato come open source la parte di raccolta delle prove di SaveMyBudget. Si chiama SaveMyBudget Toolkit, è sotto licenza Apache-2.0 e gira come un solo container Docker su un server che controlli tu.

Cosa fa

Il toolkit registra ogni clic di Google Ads che arriva sul tuo sito e conserva ciò che Google non può vedere dal suo lato: se la pagina è mai stata visibile, per quanto tempo è rimasta aperta, se qualcosa al suo interno è stato toccato, da quale rete arrivava la visita e se lo stesso ID del clic è comparso più di una volta.

Poi applica dieci regole di rilevamento a quei dati — ognuna documentata con la soglia predefinita e i falsi positivi noti — e prepara il pacchetto richiesto dal modulo di Google per i clic non validi: un file di prove con ID dei clic, timestamp e indirizzi; un breve riepilogo basato sui fatti; e una guida, campo per campo, al modulo. Lo invii tu. Google lo esamina e decide cosa, se qualcosa, fosse non valido.

Se non vuoi usare il tag, puoi importare i log del tuo web server o un export dei clic. Con entrambi, il toolkit può anche mostrare quali richieste sono arrivate al tuo server senza che il tag sia mai stato eseguito — il segnale più chiaro di un clic che nessun browser ha fatto.

Cosa non fa

Non si collega al tuo account Google Ads. Non invia reclami. Non assegna un valore in denaro ai clic segnalati — segnalato non significa non valido, e solo Google decide cosa viene accreditato. Non blocca nulla, ma può esportare un elenco di IP che puoi scegliere di aggiungere alle esclusioni della tua campagna.

Differenze rispetto al servizio

Il servizio su savemybudget.io è la stessa idea gestita per te. Installa e monitora il tag, si collega al tuo account Google Ads per i dati di campagna e i costi, applica regole e soglie aggiuntive calibrate su più account, prepara e invia i reclami. Paghi solo a risultato: quando Google conferma un credito, ne tratteniamo il 25%. Se Google non conferma nulla, non paghi nulla.

Il toolkit è per chi preferisce occuparsi di persona della raccolta e dell'invio: agenzie con una propria infrastruttura, sviluppatori che vogliono leggere il codice prima di fidarsi di uno script sul proprio sito, e chiunque voglia le prove ma non il rapporto con un servizio. Il motore delle regole e il collettore hanno la stessa origine di quelli del servizio; la calibrazione, i segnali tra account e l'invio non sono nel repository e non ci saranno.

Perché aprirlo

Per due motivi. Un tag sul sito di qualcuno dovrebbe essere leggibile. Il nostro è piccolo, non ha dipendenze, non legge mai il contenuto della pagina né i campi dei moduli e — nella versione del toolkit — non ci contatta mai. È più facile dirlo quando chiunque può verificarlo.

E il modulo di Google è pubblico. Il problema non è mai stato l'accesso: è avere dati abbastanza buoni per compilarlo. Se più inserzionisti conservano quei dati, vengono presentate più richieste fondate, il che fa bene a chiunque abbia un budget pubblicitario.

Telemetria, perché so che lo chiederai

Il toolkit invia conteggi d'uso anonimi — versione, numero di siti, numero di analisi — e nulla sui tuoi visitatori. Ogni campo è elencato nel repository. Una variabile d'ambiente la disattiva.

Come averlo

Il repository è su github.com/10xlabsio/savemybudget-toolkit. L'installazione è un file Docker Compose con Caddy per il TLS e richiede circa dieci minuti; la documentazione copre Google Tag Manager, Shopify, WordPress, Webflow, Wix e Squarespace. Issue e pull request sono benvenute. Le modifiche ai valori predefiniti delle regole passano prima da una discussione, perché una soglia è una decisione di prodotto, non una modifica al codice.

Se preferisci che lo gestiamo noi: il servizio.