A SaveMyBudget Toolkit nyílt forráskódú

Ma nyílt forráskóddal közzétettük a SaveMyBudget bizonyítékgyűjtő felét. SaveMyBudget Toolkit a neve, Apache-2.0 licencű, és egyetlen Docker-konténerként fut a te szervereden.

Mit csinál

A Toolkit rögzít minden Google Ads-kattintást, amely a webhelyedre érkezik, és megőrzi azt, amit a Google a saját oldaláról nem láthat: látható volt-e valaha az oldal, mennyi ideig maradt nyitva, érintettek-e rajta bármit, milyen hálózatról jött a látogatás, és előfordult-e többször ugyanaz a kattintásazonosító.

Ezután tíz észlelési szabályt futtat ezeken a rekordokon – mindegyiknél dokumentálva van az alapküszöb és az ismert téves riasztások köre –, és összeállítja azt a csomagot, amelyet a Google érvénytelen kattintásokról szóló űrlapja kér: egy bizonyítékfájlt kattintásazonosítókkal, időbélyegekkel és címekkel; egy rövid, tárgyilagos összefoglalót; és az űrlap mezőnkénti útmutatóját. Te nyújtod be. A Google felülvizsgálja, és eldönti, mi volt érvénytelen, ha egyáltalán volt.

Ha nem szeretnéd futtatni a címkét, importálhatod a webszerver naplóit vagy egy kattintásexportot is. Mindkettővel a Toolkit azt is megmutatja, mely kérések érkeztek a szerveredre úgy, hogy a címke egyszer sem futott le – ez a legvilágosabb jele annak, hogy a kattintást nem böngésző végezte.

Mit nem csinál

Nem csatlakozik a Google Ads-fiókodhoz. Nem nyújt be igényt. Nem szab árat a jelzett kattintásokra – a jelzett nem ugyanaz, mint az érvénytelen, és azt, hogy mi kerül jóváírásra, kizárólag a Google dönti el. Nem zár ki semmit, de exportálhat egy IP-listát, amelyet a kampányaid kizárásaihoz adhatsz hozzá, ha úgy döntesz.

Miben más, mint a szolgáltatás

A savemybudget.io szolgáltatás ugyanaz az ötlet, de helyetted üzemeltetve. Telepíti és figyeli a címkét, csatlakozik a Google Ads-fiókodhoz a kampány- és költségadatokért, további, fiókok között kalibrált szabályokat és küszöbértékeket futtat, és előkészíti, valamint benyújtja az igényeket. Nincs eredmény, nincs díj: amikor a Google megerősít egy jóváírást, annak 25%-át megtartjuk. Ha a Google semmit sem erősít meg, nem számítunk fel díjat.

A Toolkit azoknak szól, akik inkább maguk végeznék a gyűjtést és a benyújtást – saját infrastruktúrával rendelkező ügynökségeknek, fejlesztőknek, akik megnéznék a kódot, mielőtt megbíznak egy szkriptben a webhelyükön, és bárkinek, aki a bizonyítékot szeretné, de a kapcsolatot nem. A szabálymotor és a gyűjtő ugyanabból a vonalból származik, mint a szolgáltatásé; a hangolás, a fiókok közötti jelzések és a benyújtás nincsenek a tárolóban, és nem is lesznek.

Miért nyitottuk?

Két okból. Egy webhelyen futó címkének olvashatónak kell lennie. A miénk kicsi, függőségei nincsenek, soha nem olvassa az oldal tartalmát vagy az űrlapmezőket, és – a Toolkit-kiadásban – soha nem veszi fel velünk a kapcsolatot. Ezt könnyebb állítani, ha bárki ellenőrizheti.

A másik: a Google űrlapja nyilvános. Soha nem a hozzáférés volt a hiányzó láncszem, hanem az, hogy legyenek elég jó nyilvántartások a kitöltéséhez. Ha több hirdető vezeti ezeket, több megalapozott kérelem születik, ami mindenkinek jó, akinek hirdetési költségvetése van.

Telemetria, mert úgyis kérdezni fogod

A Toolkit névtelen használati számlálókat küld – verzió, hány webhely, hány elemzés –, a látogatóidról pedig semmit. Minden mező fel van sorolva a tárolóban. Egyetlen környezeti változóval kikapcsolható.

Beszerzés

A tároló a github.com/10xlabsio/savemybudget-toolkit címen érhető el. A telepítés egy Docker Compose fájl a Caddyvel a TLS-hez, és nagyjából tíz percig tart; a dokumentáció kitér a Google Tag Managerre, a Shopifyra, a WordPressre, a Webflow-ra, a Wixre és a Squarespace-re. Hibajelentéseket és pull requesteket szívesen fogadunk. A szabályok alapértékeinek módosítása előbb megbeszélésen megy át, mert a küszöbérték termékdöntés, nem kódmódosítás.

Ha inkább mi futtatnánk: a szolgáltatás.