SaveMyBudget Toolkit er open source

I dag har vi udgivet den del af SaveMyBudget, der indsamler beviser, som open source. Den hedder SaveMyBudget Toolkit, den er Apache-2.0, og den kører som én Docker-container på en server, du selv styrer.

Hvad det gør

Toolkittet registrerer hvert Google Ads-klik, der lander på dit site, og gemmer det, Google ikke kan se fra sin side: om siden overhovedet var synlig, hvor længe den var åben, om noget på den blev rørt, hvilket netværk besøget kom fra, og om det samme klik-id dukkede op mere end én gang.

Derefter kører det ti detektionsregler over de registreringer — hver især dokumenteret med sin standardtærskel og kendte falske positiver — og bygger den pakke, som Googles formular om ugyldige klik beder om: en bevisfil med klik-id'er, tidsstempler og adresser, et kort faktuelt resumé og en vejledning felt for felt til formularen. Du indsender den. Google gennemgår den og afgør, hvad der eventuelt var ugyldigt.

Hvis du ikke vil køre tagget, kan du i stedet importere dine webserverlogs eller en klikeksport. Med begge dele kan toolkittet også vise, hvilke forespørgsler der nåede din server, uden at tagget nogensinde kørte — det tydeligste tegn på et klik, som ingen browser har foretaget.

Hvad det ikke gør

Det forbinder ikke til din Google Ads-konto. Det indgiver ikke krav. Det sætter ikke en pris på markerede klik — markeret er ikke det samme som ugyldigt, og kun Google afgør, hvad der krediteres. Det blokerer ikke noget, men det kan eksportere en IP-liste, som du kan vælge at føje til dine kampagneekskluderinger.

Forskellen på toolkittet og tjenesten

Tjenesten på savemybudget.io er den samme idé, kørt for dig. Den installerer og overvåger tagget, forbinder til din Google Ads-konto for kampagnedata og omkostninger, kører yderligere regler og tærskler kalibreret på tværs af konti og forbereder og indgiver kravene. Det er no cure, no pay: når Google bekræfter en kredit, beholder vi 25 %. Hvis Google intet bekræfter, koster det ikke noget.

Toolkittet er til dem, der hellere selv vil stå for indsamlingen og indgivelsen — bureauer med egen infrastruktur, udviklere, der vil læse koden, før de stoler på et script på deres site, og alle, der vil have beviserne, men ikke relationen. Regelmotoren og collectoren har samme ophav som tjenestens; finjusteringen, signalerne på tværs af konti og indgivelsen ligger ikke i repositoriet og kommer ikke til det.

Hvorfor åbne det

To grunde. Et tag på en andens site bør kunne læses. Vores er lille, har ingen afhængigheder, læser aldrig sidens indhold eller formularfelter og kontakter — i toolkit-versionen — aldrig os overhovedet. Det er lettere at sige, når alle kan tjekke det.

Og Googles formular er offentlig. Problemet har aldrig været adgangen til den, men at have optegnelser gode nok til at udfylde den. Hvis flere annoncører fører de optegnelser, bliver der indgivet flere velbegrundede anmodninger, og det er godt for alle med et annoncebudget.

Telemetri, for du vil spørge

Toolkittet sender anonyme brugstal — version, antal sites, antal analyser — og intet om dine besøgende. Hvert felt er opført i repositoriet. Én miljøvariabel slår det fra.

Hent det

Repositoriet ligger på github.com/10xlabsio/savemybudget-toolkit. Installationen er en Docker Compose-fil med Caddy til TLS og tager omkring ti minutter; dokumentationen dækker Google Tag Manager, Shopify, WordPress, Webflow, Wix og Squarespace. Issues og pull requests er velkomne. Ændringer af regelstandarder går først gennem en diskussion, for en tærskel er en produktbeslutning, ikke en kodeændring.

Hvis du hellere vil have, at vi kører det: tjenesten.