SaveMyBudget Toolkit теперь с открытым кодом

Сегодня мы опубликовали часть SaveMyBudget, собирающую доказательства, с открытым кодом. Она называется SaveMyBudget Toolkit, распространяется по лицензии Apache-2.0 и работает как один Docker-контейнер на сервере под вашим контролем.

Что он делает

Toolkit записывает каждый клик по рекламе Google Ads, который приводит на ваш сайт, и сохраняет то, чего Google не видит со своей стороны: была ли страница вообще видна, как долго она оставалась открытой, трогали ли на ней что-нибудь, из какой сети пришёл визит и не встречался ли тот же ID клика больше одного раза.

Затем он применяет к этим записям десять правил обнаружения — каждое описано со значением порога по умолчанию и известными ложными срабатываниями — и собирает пакет, который запрашивает форма Google по недействительным кликам: файл с доказательствами (ID кликов, время, адреса), краткое изложение фактов и пошаговое руководство по полям формы. Отправляете его вы. Google рассматривает его и решает, что именно, если вообще что-то, было недействительным.

Если вы не хотите запускать тег, можно импортировать логи веб-сервера или выгрузку кликов. С обоими источниками Toolkit также показывает, какие запросы дошли до вашего сервера без запуска тега, — это самый ясный признак клика, который не делал ни один браузер.

Чего он не делает

Он не подключается к вашему аккаунту Google Ads. Он не подаёт заявки. Он не оценивает помеченные клики в деньгах — «помечен» не означает «недействителен», и только Google решает, какой возврат будет сделан. Он ничего не блокирует, хотя может выгрузить список IP, который вы вправе добавить в исключения кампаний.

Чем он отличается от сервиса

Сервис на savemybudget.io — та же идея, но с работой на нашей стороне. Он устанавливает тег и следит за ним, подключается к вашему аккаунту Google Ads за данными о кампаниях и расходах, применяет дополнительные правила и пороги, откалиброванные по аккаунтам, а также готовит и подаёт заявки. Принцип «без результата — без оплаты»: когда Google подтверждает возврат, мы берём 25%. Если Google ничего не подтверждает, вы ничего не платите.

Toolkit — для тех, кто предпочитает собирать данные и подавать заявки сам: агентств со своей инфраструктурой, разработчиков, которые хотят прочитать код, прежде чем доверять скрипту на своём сайте, и всех, кому нужны доказательства, но не отношения с подрядчиком. Движок правил и сборщик происходят из той же линейки, что и в сервисе; настройка, межаккаунтные сигналы и подача в репозитории не лежат и лежать не будут.

Зачем открывать

Две причины. Тег на чужом сайте должен быть читаемым. Наш небольшой, без зависимостей, никогда не читает содержимое страницы и поля форм и — в сборке Toolkit — вообще не связывается с нами. Это утверждение проще делать, когда любой может его проверить.

И форма Google публична. Дело никогда не было в доступе к ней — дело в записях, достаточно хороших, чтобы её заполнить. Чем больше рекламодателей ведут такие записи, тем больше обоснованных обращений подаётся, а это хорошо для каждого, у кого есть рекламный бюджет.

Телеметрия — раз вы спросите

Toolkit отправляет анонимные счётчики использования — версию, число сайтов, число анализов — и ничего о ваших посетителях. Каждое поле перечислено в репозитории. Отключается одной переменной окружения.

Как получить

Репозиторий находится по адресу github.com/10xlabsio/savemybudget-toolkit. Развёртывание — это файл Docker Compose с Caddy для TLS, оно занимает около десяти минут; документация охватывает Google Tag Manager, Shopify, WordPress, Webflow, Wix и Squarespace. Issues и pull request’ы приветствуются. Изменения значений правил по умолчанию сначала обсуждаются, потому что порог — это продуктовое решение, а не правка кода.

Если хотите, чтобы это запускали мы: сервис.