Le SaveMyBudget Toolkit est open source

Nous publions aujourd'hui en open source la partie collecte de preuves de SaveMyBudget. Elle s'appelle le SaveMyBudget Toolkit, elle est sous licence Apache-2.0 et tourne dans un seul conteneur Docker, sur un serveur que vous contrôlez.

Ce qu'il fait

Le toolkit enregistre chaque clic Google Ads qui arrive sur votre site et conserve ce que Google ne peut pas voir de son côté : la page a-t-elle jamais été visible, combien de temps est-elle restée ouverte, a-t-on touché à quoi que ce soit, de quel réseau venait la visite, et le même ID de clic est-il apparu plusieurs fois.

Il applique ensuite dix règles de détection à ces enregistrements — chacune documentée avec son seuil par défaut et ses faux positifs connus — et prépare le dossier que demande le formulaire de Google pour les clics incorrects : un fichier de preuves avec les ID de clic, les horodatages et les adresses ; un court résumé factuel ; et un guide du formulaire, champ par champ. C'est vous qui le soumettez. Google l'examine et décide ce qui, le cas échéant, était incorrect.

Si vous ne voulez pas faire tourner la balise, vous pouvez importer les journaux de votre serveur web ou un export de clics. Avec les deux, le toolkit peut aussi montrer quelles requêtes sont arrivées sur votre serveur sans que la balise ne s'exécute jamais — le signe le plus net d'un clic qu'aucun navigateur n'a fait.

Ce qu'il ne fait pas

Il ne se connecte pas à votre compte Google Ads. Il ne dépose pas de réclamations. Il ne chiffre pas la valeur des clics signalés — signalé ne veut pas dire incorrect, et seul Google décide de ce qui donne lieu à un avoir. Il ne bloque rien, mais il peut exporter une liste d'IP que vous pouvez choisir d'ajouter aux exclusions de vos campagnes.

En quoi il diffère du service

Le service, sur savemybudget.io, c'est la même idée, exploitée pour vous. Il installe et surveille la balise, se connecte à votre compte Google Ads pour récupérer les données de campagne et de coût, applique des règles et des seuils supplémentaires calibrés sur l'ensemble des comptes, et prépare et dépose les réclamations. C'est « sans résultat, sans frais  » : lorsque Google confirme un avoir, nous gardons 25 %. Si Google ne confirme rien, vous ne payez rien.

Le toolkit s'adresse à ceux qui préfèrent collecter et déposer eux-mêmes — des agences disposant de leur propre infrastructure, des développeurs qui veulent lire le code avant de faire confiance à un script sur leur site, et tous ceux qui veulent les preuves sans la relation. Le moteur de règles et le collecteur sont de la même lignée que ceux du service ; le réglage fin, les signaux inter-comptes et le dépôt des réclamations ne sont pas dans le dépôt et n'y seront pas.

Pourquoi l'ouvrir

Pour deux raisons. Une balise installée sur le site de quelqu'un doit pouvoir être lue. La nôtre est petite, n'a aucune dépendance, ne lit jamais le contenu des pages ni les champs de formulaire et — dans la version toolkit — ne nous contacte jamais. Il est plus facile d'avancer cela quand chacun peut le vérifier.

Et le formulaire de Google est public. Le problème n'a jamais été d'y accéder, mais de disposer d'enregistrements assez solides pour le remplir. Plus il y aura d'annonceurs qui conservent ces enregistrements, plus il y aura de demandes bien fondées, ce qui profite à tous ceux qui ont un budget publicitaire.

La télémétrie, forcément

Le toolkit envoie des compteurs d'usage anonymes — version, nombre de sites, nombre d'analyses — et rien sur vos visiteurs. Chaque champ est listé dans le dépôt. Une variable d'environnement suffit pour la désactiver.

Où le trouver

Le dépôt se trouve sur github.com/10xlabsio/savemybudget-toolkit. Le déploiement se fait avec un fichier Docker Compose et Caddy pour le TLS, et prend environ dix minutes ; la documentation couvre Google Tag Manager, Shopify, WordPress, Webflow, Wix et Squarespace. Les issues et les pull requests sont les bienvenues. Les modifications des valeurs par défaut des règles passent d'abord par une discussion, car un seuil est une décision produit, pas un changement de code.

Si vous préférez que nous nous en chargions : le service.