SaveMyBudget Toolkit har öppen källkod

I dag publicerade vi den del av SaveMyBudget som samlar bevis som öppen källkod. Den heter SaveMyBudget Toolkit, har licensen Apache-2.0 och körs som en Docker-container på en server du styr.

Vad det gör

Toolkitet registrerar varje Google Ads-klick som landar på din webbplats och sparar det Google inte kan se från sin sida: om sidan någonsin var synlig, hur länge den var öppen, om något på den berördes, vilket nätverk besöket kom från och om samma klick-ID dykt upp mer än en gång.

Därefter kör det tio detekteringsregler över de uppgifterna — var och en dokumenterad med sitt standardvärde för tröskeln och sina kända falska positiver — och bygger det paket som Googles formulär för ogiltiga klick ber om: en bevisfil med klick-ID, tidsstämplar och adresser, en kort saklig sammanfattning och en fält-för-fält-guide till formuläret. Du skickar in det. Google granskar det och avgör vad, om något, som var ogiltigt.

Om du inte vill köra taggen kan du i stället importera webbserverns loggar eller en klickexport. Med båda kan toolkitet också visa vilka förfrågningar som nådde din server utan att taggen någonsin körts — det tydligaste tecknet på ett klick som ingen webbläsare gjort.

Vad det inte gör

Det ansluter inte till ditt Google Ads-konto. Det lämnar inte in krav. Det sätter inget pris på flaggade klick — flaggad är inte samma sak som ogiltig, och bara Google avgör vad som ger kreditering. Det blockerar ingenting, men det kan exportera en IP-lista som du kan välja att lägga till i dina kampanjers uteslutningar.

Hur det skiljer sig från tjänsten

Tjänsten på savemybudget.io är samma idé, driven åt dig. Den installerar och övervakar taggen, ansluter till ditt Google Ads-konto för kampanjdata och kostnad, kör ytterligare regler och tröskelvärden kalibrerade över flera konton, och förbereder och lämnar in kraven. Det är ingen vinst, ingen avgift: när Google bekräftar en kreditering behåller vi 25 %. Om Google inte bekräftar något tar vi ingen avgift.

Toolkitet är till för dem som hellre samlar in och lämnar in själva — byråer med egen infrastruktur, utvecklare som vill läsa koden innan de litar på ett skript på sin webbplats, och alla som vill ha underlaget men inte relationen. Regelmotorn och insamlaren har samma ursprung som tjänstens; finjusteringen, signalerna över flera konton och inlämningen finns inte i arkivet och kommer inte att göra det.

Därför öppnar vi

Två skäl. En tagg på någons webbplats ska gå att läsa. Vår är liten, saknar beroenden, läser aldrig sidans innehåll eller formulärfält och — i toolkit-versionen — kontaktar oss aldrig alls. Det påståendet är lättare att göra när vem som helst kan kontrollera det.

Och Googles formulär är offentligt. Problemet har aldrig varit åtkomsten till det, utan att ha tillräckligt bra underlag för att fylla i det. Om fler annonsörer för sådana register görs fler välgrundade förfrågningar, vilket är bra för alla med en annonsbudget.

Telemetri, eftersom du kommer att fråga

Toolkitet skickar anonym användningsstatistik — version, antal webbplatser, antal analyser — och ingenting om dina besökare. Varje fält är listat i arkivet. En miljövariabel stänger av den.

Så får du det

Arkivet finns på github.com/10xlabsio/savemybudget-toolkit. Driftsättningen är en Docker Compose-fil med Caddy för TLS och tar ungefär tio minuter; dokumentationen täcker Google Tag Manager, Shopify, WordPress, Webflow, Wix och Squarespace. Ärenden och pull requests är välkomna. Ändringar av regelns standardvärden går först via en diskussion, eftersom ett tröskelvärde är ett produktbeslut, inte en kodändring.

Vill du hellre att vi kör det: tjänsten.