Το SaveMyBudget Toolkit είναι ανοιχτού κώδικα

Σήμερα δημοσιεύσαμε ως ανοιχτό κώδικα το μισό της SaveMyBudget που συλλέγει στοιχεία. Ονομάζεται SaveMyBudget Toolkit, έχει άδεια Apache-2.0 και τρέχει ως ένα container Docker σε διακομιστή που ελέγχετε εσείς.

Τι κάνει

Το toolkit καταγράφει κάθε κλικ του Google Ads που φτάνει στον ιστότοπό σας και κρατά όσα η Google δεν μπορεί να δει από τη δική της πλευρά: αν η σελίδα ήταν ποτέ ορατή, πόση ώρα έμεινε ανοιχτή, αν αγγίχθηκε κάτι πάνω της, από ποιο δίκτυο ήρθε η επίσκεψη και αν το ίδιο αναγνωριστικό κλικ εμφανίστηκε περισσότερες από μία φορές.

Στη συνέχεια εφαρμόζει δέκα κανόνες εντοπισμού σε αυτά τα αρχεία — καθένας τεκμηριωμένος με το προεπιλεγμένο όριό του και τα γνωστά ψευδώς θετικά αποτελέσματα — και φτιάχνει τον φάκελο που ζητά η φόρμα της Google για τα μη έγκυρα κλικ: ένα αρχείο στοιχείων με αναγνωριστικά κλικ, χρονοσημάνσεις και διευθύνσεις· μια σύντομη τεκμηριωμένη περίληψη· και έναν οδηγό για κάθε πεδίο της φόρμας. Την υποβάλλετε εσείς. Η Google την εξετάζει και αποφασίζει τι, αν κάτι, ήταν μη έγκυρο.

Αν δεν θέλετε να τρέξετε την ετικέτα, μπορείτε να εισαγάγετε τα logs του web server σας ή μια εξαγωγή κλικ. Με τα δύο, το toolkit μπορεί επίσης να δείξει ποια αιτήματα έφτασαν στον διακομιστή σας χωρίς να τρέξει ποτέ η ετικέτα — η πιο καθαρή ένδειξη ενός κλικ που δεν έκανε κανένα πρόγραμμα περιήγησης.

Τι δεν κάνει

Δεν συνδέεται με τον λογαριασμό σας στο Google Ads. Δεν υποβάλλει αξιώσεις. Δεν βάζει τιμή στα επισημασμένα κλικ — επισημασμένο δεν σημαίνει μη έγκυρο, και μόνο η Google αποφασίζει τι πιστώνεται. Δεν αποκλείει τίποτα, αν και μπορεί να εξαγάγει μια λίστα IP που μπορείτε να επιλέξετε να προσθέσετε στις εξαιρέσεις της καμπάνιας σας.

Πώς διαφέρει από την υπηρεσία

Η υπηρεσία στο savemybudget.io είναι η ίδια ιδέα, που τρέχει για εσάς. Εγκαθιστά και παρακολουθεί την ετικέτα, συνδέεται με τον λογαριασμό σας στο Google Ads για δεδομένα καμπάνιας και κόστους, εφαρμόζει πρόσθετους κανόνες και όρια βαθμονομημένα σε πολλούς λογαριασμούς, και προετοιμάζει και υποβάλλει τις αξιώσεις. Ισχύει «χωρίς αποτέλεσμα, καμία χρέωση»: όταν η Google επιβεβαιώνει μια πίστωση, κρατάμε το 25%. Αν η Google δεν επιβεβαιώσει τίποτα, δεν υπάρχει χρέωση.

Το toolkit είναι για όσους προτιμούν να κάνουν μόνοι τους τη συλλογή και την υποβολή — γραφεία με δική τους υποδομή, προγραμματιστές που θέλουν να διαβάσουν τον κώδικα πριν εμπιστευτούν ένα script στον ιστότοπό τους, και όποιον θέλει τα στοιχεία χωρίς τη σχέση με μια υπηρεσία. Η μηχανή κανόνων και ο συλλέκτης έχουν την ίδια καταγωγή με αυτά της υπηρεσίας· η βαθμονόμηση, τα σήματα από πολλούς λογαριασμούς και η υποβολή δεν υπάρχουν στο αποθετήριο και δεν θα υπάρξουν.

Γιατί το ανοίξαμε

Για δύο λόγους. Μια ετικέτα στον ιστότοπο κάποιου πρέπει να είναι αναγνώσιμη. Η δική μας είναι μικρή, δεν έχει εξαρτήσεις, δεν διαβάζει ποτέ το περιεχόμενο της σελίδας ή τα πεδία φορμών και — στην έκδοση του toolkit — δεν επικοινωνεί καθόλου μαζί μας. Αυτό είναι πιο εύκολο να το λέμε όταν μπορεί ο καθένας να το ελέγξει.

Και η φόρμα της Google είναι δημόσια. Το πρόβλημα δεν ήταν ποτέ η πρόσβαση σε αυτήν· είναι να έχετε αρχεία αρκετά καλά για να τη συμπληρώσετε. Αν περισσότεροι διαφημιζόμενοι κρατούν τέτοια αρχεία, γίνονται περισσότερα τεκμηριωμένα αιτήματα, κάτι που ωφελεί όλους όσους έχουν διαφημιστικό budget.

Τηλεμετρία, γιατί θα ρωτήσετε

Το toolkit στέλνει ανώνυμους αριθμούς χρήσης — έκδοση, πόσοι ιστότοποι, πόσες αναλύσεις — και τίποτα για τους επισκέπτες σας. Κάθε πεδίο αναφέρεται στο αποθετήριο. Μία μεταβλητή περιβάλλοντος την απενεργοποιεί.

Λήψη

Το αποθετήριο βρίσκεται στο github.com/10xlabsio/savemybudget-toolkit. Η εγκατάσταση γίνεται με ένα αρχείο Docker Compose με Caddy για TLS και παίρνει περίπου δέκα λεπτά· η τεκμηρίωση καλύπτει Google Tag Manager, Shopify, WordPress, Webflow, Wix και Squarespace. Τα issues και τα pull requests είναι ευπρόσδεκτα. Οι αλλαγές στις προεπιλογές των κανόνων περνούν πρώτα από συζήτηση, επειδή ένα όριο είναι απόφαση προϊόντος και όχι αλλαγή κώδικα.

Αν προτιμάτε να το τρέχουμε εμείς: η υπηρεσία.