De SaveMyBudget Toolkit is open source

Vandaag hebben we de bewijsverzameling van SaveMyBudget als open source gepubliceerd. Ze heet de SaveMyBudget Toolkit, valt onder Apache-2.0 en draait als één Docker-container op een server die jij beheert.

Wat het doet

De toolkit legt elke Google Ads-klik vast die op je site landt en bewaart wat Google van zijn kant niet kan zien: of de pagina ooit zichtbaar was, hoe lang ze openstond, of er iets op is aangeraakt, van welk netwerk het bezoek kwam en of dezelfde klik-ID meer dan eens opdook.

Vervolgens past hij tien detectieregels toe op die gegevens — elk gedocumenteerd met de standaarddrempel en de bekende valse positieven — en bouwt het pakket dat het formulier van Google voor ongeldige klikken vraagt: een bewijsbestand met klik-ID's, tijdstempels en adressen, een korte feitelijke samenvatting en een veld-voor-veldgids bij het formulier. Jij dient het in. Google beoordeelt het en beslist wat er, indien iets, ongeldig was.

Wil je de tag niet draaien, dan kun je in plaats daarvan je webserverlogs of een klikexport importeren. Met allebei kan de toolkit ook laten zien welke verzoeken je server bereikten zonder dat de tag ooit draaide — het duidelijkste teken van een klik die geen browser heeft gemaakt.

Wat het niet doet

Het maakt geen verbinding met je Google Ads-account. Het dient geen claims in. Het hangt geen prijs aan gemarkeerde klikken — gemarkeerd is niet hetzelfde als ongeldig, en alleen Google bepaalt welk krediet wordt toegekend. Het blokkeert niets, al kan het een IP-lijst exporteren die je eventueel aan de uitsluitingen van je campagne toevoegt.

Hoe het verschilt van de dienst

De dienst op savemybudget.io is hetzelfde idee, voor jou uitgevoerd. Ze installeert en bewaakt de tag, maakt verbinding met je Google Ads-account voor campagnegegevens en kosten, past extra regels en drempels toe die over accounts heen zijn gekalibreerd, en bereidt de claims voor en dient ze in. Het is no cure, no pay: als Google een krediet bevestigt, houden wij 25%. Bevestigt Google niets, dan betaal je niets.

De toolkit is voor mensen die het verzamelen en indienen liever zelf doen — bureaus met eigen infrastructuur, ontwikkelaars die de code willen lezen voordat ze een script op hun site vertrouwen, en iedereen die het bewijs wil maar niet de relatie. De regelengine en de collector hebben dezelfde afkomst als die van de dienst; de afstemming, de signalen over accounts heen en het indienen zitten niet in de repository en komen daar ook niet.

Waarom openen

Twee redenen. Een tag op iemands site moet leesbaar zijn. De onze is klein, heeft geen afhankelijkheden, leest nooit pagina-inhoud of formuliervelden en neemt — in de toolkit-build — helemaal geen contact met ons op. Die bewering is makkelijker te doen als iedereen haar kan controleren.

En het formulier van Google is openbaar. Het ontbrak nooit aan toegang ertoe; het ontbreekt aan gegevens die goed genoeg zijn om het in te vullen. Als meer adverteerders die gegevens bijhouden, worden er meer goed onderbouwde verzoeken gedaan, en dat is goed voor iedereen met een advertentiebudget.

Telemetrie, want je gaat ernaar vragen

De toolkit stuurt anonieme gebruikstellingen — versie, aantal sites, aantal analyses — en niets over je bezoekers. Elk veld staat in de repository. Eén omgevingsvariabele zet het uit.

Aan de slag

De repository staat op github.com/10xlabsio/savemybudget-toolkit. Uitrollen is een Docker Compose-bestand met Caddy voor TLS en duurt ongeveer tien minuten; de documentatie behandelt Google Tag Manager, Shopify, WordPress, Webflow, Wix en Squarespace. Issues en pull requests zijn welkom. Wijzigingen aan de standaardwaarden van regels gaan eerst langs een discussie, want een drempel is een productbeslissing, geen codewijziging.

Liever dat wij het draaien? De dienst.