SaveMyBudget Toolkit este open source

Astăzi am publicat ca open source jumătatea de colectare a dovezilor din SaveMyBudget. Se numește SaveMyBudget Toolkit, are licența Apache-2.0 și rulează ca un singur container Docker pe un server controlat de dumneavoastră.

Ce face

Toolkitul înregistrează fiecare clic pe anunțurile Google Ads care ajunge pe site-ul dumneavoastră și păstrează ce nu poate vedea Google din partea sa: dacă pagina a fost vreodată vizibilă, cât timp a rămas deschisă, dacă s-a atins ceva pe ea, din ce rețea a venit vizita și dacă același ID de clic a apărut de mai multe ori.

Apoi rulează zece reguli de detectare peste aceste înregistrări — fiecare documentată cu pragul implicit și cu falsele pozitive cunoscute — și construiește pachetul cerut de formularul Google pentru clicuri nevalide: un fișier de dovezi cu ID-uri de clic, marcaje de timp și adrese; un scurt rezumat factual; și un ghid câmp cu câmp al formularului. Îl depuneți dumneavoastră. Google îl analizează și decide ce, dacă este cazul, a fost nevalid.

Dacă nu doriți să rulați tag-ul, puteți importa în schimb jurnalele serverului web sau un export de clicuri. Cu ambele, toolkitul poate arăta și ce cereri au ajuns la serverul dumneavoastră fără ca tag-ul să ruleze vreodată — cel mai clar semn al unui clic pe care nu l-a făcut niciun browser.

Ce nu face

Nu se conectează la contul dumneavoastră Google Ads. Nu depune cereri. Nu pune un preț pe clicurile marcate — marcat nu înseamnă nevalid, iar numai Google decide ce se creditează. Nu blochează nimic, deși poate exporta o listă de IP-uri pe care puteți alege să o adăugați la excluderile campaniei.

Cum diferă de serviciu

Serviciul de la savemybudget.io este aceeași idee, rulată pentru dumneavoastră. Instalează și monitorizează tag-ul, se conectează la contul dumneavoastră Google Ads pentru datele despre campanii și costuri, rulează reguli și praguri suplimentare, calibrate pe mai multe conturi, și pregătește și depune cererile. Funcționează fără câștig, fără comision: când Google confirmă un credit, păstrăm 25%. Dacă Google nu confirmă nimic, nu se percepe nicio taxă.

Toolkitul este pentru cei care preferă să colecteze și să depună singuri — agenții cu infrastructură proprie, dezvoltatori care vor să citească codul înainte de a avea încredere într-un script de pe site-ul lor și oricine vrea dovezile, dar nu relația. Motorul de reguli și colectorul au aceeași origine cu cele ale serviciului; reglajul fin, semnalele din mai multe conturi și depunerea nu se află în repository și nu vor fi acolo.

De ce open source

Din două motive. Un tag de pe site-ul cuiva ar trebui să poată fi citit. Al nostru este mic, nu are dependențe, nu citește niciodată conținutul paginii sau câmpurile de formular și — în versiunea toolkit — nu ne contactează deloc. Afirmația aceasta e mai ușor de susținut când oricine o poate verifica.

Și formularul Google este public. Problema nu a fost niciodată accesul la el, ci lipsa unor evidențe suficient de bune ca să-l completezi. Dacă mai mulți advertiseri păstrează aceste evidențe, se fac mai multe cereri bine întemeiate, ceea ce este în folosul tuturor celor care au un buget de publicitate.

Telemetria, pentru că veți întreba

Toolkitul trimite contoare anonime de utilizare — versiunea, câte site-uri, câte analize — și nimic despre vizitatorii dumneavoastră. Fiecare câmp este listat în repository. O variabilă de mediu o dezactivează.

Cum îl obțineți

Repository-ul se află la github.com/10xlabsio/savemybudget-toolkit. Instalarea înseamnă un fișier Docker Compose cu Caddy pentru TLS și durează cam zece minute; documentația acoperă Google Tag Manager, Shopify, WordPress, Webflow, Wix și Squarespace. Issue-urile și pull request-urile sunt binevenite. Modificările valorilor implicite ale regulilor trec mai întâi printr-o discuție, pentru că un prag este o decizie de produs, nu o schimbare de cod.

Dacă preferați să-l rulăm noi: serviciul.