Бюджеты Google Ads + Яндекс Директ в Telegram

В этой статье мы разберем настройку уведомлений в Телеграм об окончании бюджета рекламных аккаунтов Google Ads и Яндекс Директ. Уведомления помогут контролировать бюджет и своевременно его пополнять, это освобождает вас от необходимости постоянно мониторить рекламные кабинеты с целью проверки бюджета.

Кому может подойти данное решение?

Фрилансерам/агентствам – если у вас несколько аккаунтов клиентов и необходимо оперативно отслеживать рекламный бюджет;
Клиентам – получать уведомление о бюджете до тех пор, пока рекламный кабинет не будет пополнен и не допускать приостановки рекламных кампаний.

Решение существует в двух вариантах использования:

агентский вариант – получайте уведомление сразу о нескольких аккаунтах;
клиентский вариант – получайте уведомление по одному аккаунту.

В данном решении не является целью выгружать рекламную статистику, с помощью него вы сможете получить только данные по текущим остаткам в рекламных кабинетах.

Содержание

1. Для фрилансеров/агентств

Выгрузка бюджетов рекламных аккаунтов происходит с помощью скриптов, реализованных на коде JavaScript с использованием библиотек Google. Для выгрузки данных о бюджетах Яндекс Директ мы будем использовать дополнительную прослойку Google Sheets, а в случае с Google Ads – работать в интерфейсе Google Ads напрямую. В данном варианте можно получать бюджет нескольких аккаунтов сразу.

Настройка для Яндекс Директ

План работ Яндекс Директ:

Получение токенов клиентских аккаунтов и создание таблицы с токенами/логинами;
Создание пустой таблицы для статистики;
Создание чат бота, получение id чата;
Подключение скрипта в Google Apps Script к таблице;
Выставляем переменные в скрипте (id таблиц, id чата в тг, токен бота, предел бюджета);
Автоматизация скрипта с помощью триггеров, кастомизация ботов и чата.

Шаг 1 – получение токенов клиентских аккаунтов, создание таблицы с токенами/логинами.

На этом шаге нам необходимо получить токены каждого клиентского аккаунта, который вы хотите отслеживать. Для этого необходимо будет залогиниться в ручную в каждом аккаунте.

Создаем таблицу в Google Sheets с токенами, вот пример данной таблицы – вы можете скопировать ее себе и добавить ваши токены и логины, которые вы получили на предыдущем шаге – https://docs.google.com/spreadsheets/d/1Tv4Ss9Bp95UYZqPrVDFBHCmg4xKCkoJWgT1Q6549InY/edit?usp=sharing

Для того, чтобы получить токен клиента – перейдите по след. ссылке – https://oauth.yandex.ru/authorize?response_type=token&client_id=1d3fefb9813c46aab45dedc0cb4e3887

Тут внимательно – каждый новый аккаунт требует того, чтобы у вас появилось такое окно и вы залогинились. Токены у каждого аккаунта – разные!

Если окна нет – то слева выбираете аккаунт, закрываете вкладку и переходите по ссылке еще раз до появления окна с нужным аккаунтом.

Шаг 2 – создание пустой таблицы для статистики

Создаем пустую таблицу в Google Sheets, к которой мы будем подключать скрипт.

Шаг 3 – создание телеграм бота, получение ID чата.

Для создания бота найдем в поиске телеграм BotFather или перейдем по ссылке https://t.me/BotFather . Это бот телеграма, который помогает создавать ботов.

При первом диалоге вам необходимо будет его запустить.

Далее ввести команду /newbot для создания нового бота. Даете название бота (в моем примере, Бюджет Яндекс Директ), и задаете его ссылку с окончанием на bot (например, yandex_budget_test_bot). После успешного создания вы увидите ссылку на вашего бота и его токен. Токен мы получили, копируем его пока себе.

Следующим шагом будет получить id чата, куда бот будет отправлять сообщения о бюджете. Это может быть и личные сообщения, но для удобства я рекомендую сделать отдельную группу в телеграм, чтобы можно было добавить коллег.

Создаем группу в телеграм, объяснять не буду, тут вроде понятно. В нее добавляем бота, и обязательно делаем его администратором.

После этого запускаем бота в группе (Отправляем сообщение в группу), затем переходим по ссылке https://api.telegram.org/bot<Ваш Токен бота>/getUpdates (ваш токен бота меняем на тот, который мы получили в BotFather). Здесь вы увидите следующую информацию:

Нам нужен результат с “chat”:{“id”:

Здесь id начинается с –, чаще всего для группы он всегда начинается с –. Так же это можно увидеть по строке “type”:”group”.

Копируем этот id.

Если что-то не получается, попробуйте написать сообщение еще раз и снова обновить ссылку.

Шаг 4 – Подключение скрипта в Google Apps Script к таблице

В созданной пустой таблице мы переходим в Расширения – Apps Script

Удаляем пример функции из области:

Вставляем скрипт, который предоставлен ниже:

ТУТ АГЕНТСТКИЙ СКРИПТ ДЛЯ ЯНДЕКС ДИРЕКТ

Сразу разберем переменные, которые нам необходимо выставить для работы со скриптом

var tgToken = ‘YOUR_BOT_TOKEN ‘; // Токен вашего Telegram бота (который мы получили после создания)
var tgChatId = ‘YOUR_CHAT_ID ‘; // Chat ID вашей группы или канала в Telegram (который мы получили после старта бота)
var tokenSheetId = ‘ YOUR_TOKENS_SHEET_ID’; // ID таблицы с токенами (наша таблица с токенами)
var exportSheetId = ‘YOUR_STATISCTICS_SHEET_ID ‘; // ID таблицы для загрузки данных (наша пустая таблица)

Прим. Id таблицы – это часть ссылки на таблицу после d/ и перед /edit.

Предел баланса, при котором нужно отправлять уведомление находится чуть ниже в теле скрипта – для его изменения поменяйте на необходимый вам предел: if (balance < 50) {

Далее мы сохраняем проект и запускаем скрипт для проверки, чтобы все работало необходимо будет авторизовать скрипт с вашей почты.

Для этого нажимаем сохранить проект, а затем Выполнить.

Проходим авторизацию.

И:

Здесь открываем скрытые настройки и нажимаем на Перейти на страницу (Проект без названия). Даем все необходимые разрешения.

После авторизации скрипт автоматически будет запущен. Тестируем все ли корректно доходит – для проверки можете установить более низкий предел баланса.

Для проверки можно всегда нажать кнопку Выполнить, только проверьте, чтобы была выбрана функция getYandexDirectBalance.

Шаг 6 – Автоматизация скрипта с помощью триггеров, кастомизация ботов и чата.

Следующим шагом мы сделаем так, чтобы скрипт работал без нашего участия. В интерфейсе Apps Script переходим в Триггеры – Добавить триггер.

И:

Здесь выбираем функцию getYandexDirectBalance:

Задаем источник – Триггер по времени и устанавливаем удобное для Вас расписание. (В моем примере, уведомления будут приходить каждый день с 9 до 10 утра) при выполнении условий по балансу. Триггер сохраняем.

Возможно при добавлении триггера, вам потребуется снова дать разрешения и авторизоваться повторно.

Готово, если все корректно настроили – ваш скрипт будет отсылать уведомления в телеграм по вашим настройкам и расписанию.

Управление клиентами осуществляется посредством редактирования таблицы с токенами. Если хотите добавить нового клиента- добавьте токен и логин в таблице, если хотите удалить клиента – удалите строку с данными из таблицы.

Также, по умолчанию скрипт выгружает данные с кликами, показами, расходами, конверсиями за день выгрузки.

Кастомизация ботов и чата – по желанию вы можете поменять название чата, бота и поставить на них изображения. Это делается с помощью редактирования бота, либо с помощью команд в BotFather.

Настройка для Google Ads

Данная реализация более проста в настройке и займет немного меньше времени. Скрипт для агентств предназначен для работы с MCC (управляющим аккаунтом Google Ads). Если у вас его нет, то используйте отдельный скрипт для клиентских аккаунтов.

План работ Google Ads:

Добавляем скрипт в интерфейсе Google Ads на управляющий аккаунт;
Добавляем ярлыки на аккаунты Google Ads, которые должны быть включены в отслеживание;
Cоздаем бот и группу в телеграм;
Выставляем переменные (токен бота, id чата, за сколько до окончания бюджета присылать уведомления), тестирование;
Автоматизация скрипта + кастомизация ботов.

Шаг 1 – добавление скрипта на уровень управляющего аккаунта (MCC)

Переходим в Управляющий аккаунт – Инструменты – Массовые действия – Скрипты.

Нажимаем + Создать скрипт.

Вставляем скрипт, который приложен ниже.

ЗДЕСЬ АГЕНТСТКИЙ СКРИПТ ДЛЯ GOOGLE ADS

Разберем переменные, которые необходимо будет заполнить:

days : 7 – минимальное кол-во дней до окончания средств на аккаунте. Скрипт работает таким образом, что пересчитывает среднедневной расход и исходя из этого отправляет уведомления, пишет приблизительное кол-во дней, на которые хватит бюджета. Установите интервал, который вам будет удобен.
labelName: ‘YOUR_LABEL_NAME’ – здесь устанавливаем имя ярлыка, который мы будем устанавливать на аккаунты. Можете оставить таким, или заменить на ваш вариант. (по умолчанию установлен – labelName : [‘budzhet-skript-otslezhivanie’])
TOKEN: ‘ YOUR_TELEGRAM_TOKEN ‘, (Токен вашего телеграм бота)
CHAT_ID: ‘YOUR_CHAT_ID ‘ (Id чата группы)

Шаг 2 – добавление ярлыков на аккаунты Google Ads.

Переходим в управляющем аккаунте в раздел Аккаунты. Отмечаем необходимые для отслеживания аккаунты галочкой – нажимаем кнопку Ярлык – Создать ярлык. И называем его точно также, как в переменной в скрипте. Например, у меня budzhet-skript-otslezhivanie.

Ярлык сохраняется в аккаунте, вы можете в последующем его добавлять к другим аккаунтам или удалять из аккаунтов.

Шаг 3 – Создаем бот и группу в Телеграм.

Здесь шаги аналогичны, как и для Яндекс Директ. Второй раз писать информацию не буду, вернитесь чуть выше.

После того, как мы создали мы копируем токен бота телеграма и id чата.

Шаг 4 – Выставляем необходимые переменные, тестируем работу.

В скрипте замените переменные:

days (Кол-во дней до окончания средств)
labelName (Имя ярлыка аккаунтов)
TOKEN: (Токен бота в телеграме)
CHAT_ID (Id чата вашей группы)

После того, как вы выставили все необходимые переменные нажимаем Выполнить.

Обязательно Авторизуем скрипт со своей почты. И запускаем, для проверки можете установить большее кол-во дней до окончания бюджета, чтобы убедиться в том, что сообщения доходят.

Шаг 5 – Автоматизация скрипта

После успешной проверки – вы можете установить частоту выполнения скрипта (Например, ежедневно с 9 до 10).

В таком случае скрипт будет срабатывать каждый день с 9 до 10 и при выполнении условия по кол-ву оставшихся дней отправлять уведомления в Телеграм.

Управление аккаунтами в данном случае реализовано через ярлыки, если необходимо добавить новый аккаунт – добавьте на него созданный ярлык. Если необходимо убрать аккаунт из отслеживания – снимите с него ярлык.

По итогу настройки двух систем можно получить такой результат, где ежедневно вы будете видеть клиентов у которых заканчивается бюджет и вовремя их информировать и выставлять счета:

2. Для клиентов

Выгрузка бюджетов рекламных аккаунтов происходит с помощью скриптов, реализованных на коде JavaScript с использованием библиотек Google. Для выгрузки данных о бюджетах Яндекс Директ мы будем использовать дополнительную прослойку Google Sheets, а в случае с Google Ads – работать в интерфейсе Google Ads напрямую. Этот вариант скриптов предназначен для работы только с 1 рекламным аккаунтом.

Настройка Яндекс Директ

План работ Яндекс Директ:

Получение токена клиентского аккаунта;
Создание пустой таблицы для статистики;
Создание чат бота, получение id чата;
Подключение скрипта в Google Apps Script к таблице;
Выставляем переменные в скрипте (id таблицы, id чата в тг, токен бота, предел бюджета);
Автоматизация скрипта с помощью триггеров, кастомизация ботов и чата.

Шаг 1 – Получение токена клиентского аккаунта

Залогиньтесь в вашем аккаунте Яндекс Директ, скопируйте полученный токен.

Шаг 2 – создание пустой таблицы для статистики

Создаем пустую таблицу в Google Sheets, к которой мы будем подключать скрипт.

Шаг 3 – создание телеграм бота, получение id чата

Здесь все аналогично, как и при подключении агентского аккаунта. Шаги описаны выше.

Шаг 4 – подключение скрипта в Google Apps Script к таблице

В созданной пустой таблице мы переходим в Расширения – Apps Script:

Удаляем пример функции из области:

Вставляем скрипт, который предоставлен ниже:

ТУТ СКРИПТ КЛИЕНТА ЯНДЕКС.ДИРЕКТ

Сразу разберем переменные, которые нам необходимо выставить для работы со скриптом:

var tgToken = ‘YOUR_TOKEN_BOT’; // Токен вашего Telegram бота
var tgChatId = ‘YOUR_CHAT_ID’; // Chat ID вашей группы или канала в Telegram
var googleSheetId = ‘GOOGLE_SHEET_ID’; // ID вашей таблицы Google Sheets
var clientYandexToken = ‘YOUR_YANDEX_TOKEN’; // Токен клиента Яндекс Директ
var clientLogin = ‘YOUR_YANDEX_LOGIN’; // Логин клиента Яндекс Директ

Прим. Id таблицы – это часть ссылки на таблицу после d/ и перед /edit.

Предел баланса, при котором нужно отправлять уведомление находится чуть ниже в теле скрипта – для его изменения поменяйте на необходимый вам предел: if (balance < 50) {

Для этого нажимаем сохранить проект, а затем Выполнить.

Проходим авторизацию.

Для проверки можно всегда нажать кнопку Выполнить, только проверьте, чтобы была выбрана функция getYandexDirectBalance.

Шаг 6 – Автоматизация скрипта с помощью триггеров, кастомизация бота и чата.

Следующим шагом мы сделаем так, чтобы скрипт работал без нашего участия. В интерфейсе Apps Script переходим в Триггеры – Добавить триггер.

И:

Здесь выбираем функцию getYandexDirectBalance:

Возможно при добавлении триггера, вам потребуется снова дать разрешения и авторизоваться повторно.

Настройка для Google Ads

Данная реализация более проста в настройке и займет меньше времени. Скрипт для клиентов предназначен для работы с клиентским аккаунтом Google Ads.

План работ Google Ads:

Добавляем скрипт в интерфейсе Google Ads на клиентский аккаунт;
Cоздаем бот и группу в телеграм;
Выставляем переменные (токен бота, id чата, за сколько до окончания бюджета присылать уведомления), тестирование;
Автоматизация скрипта + кастомизация ботов.

Шаг 1 – добавление скрипта на клиентский аккаунт Google Ads.

В клиентском аккаунте переходим в Инструменты – Массовые действия – Скрипты:

Нажимаем + Создать скрипт.

Вставляем скрипт, который приложен ниже:

СКРИПТ ДЛЯ КЛИЕНТСКОГО АККАУНТА GOOGLE ADS

Разберем переменные, которые необходимо будет заполнить:

days : 7 – Минимальное кол-во дней до окончания средств на аккаунте – скрипт работает таким образом, что пересчитывает среднедневной расход и исходя из этого отправляет уведомления, пишет приблизительное кол-во дней, на которые хватит бюджета. Установите интервал, который вам будет удобен.
TOKEN : ‘ ‘, (Токен вашего телеграм бота)
CHAT_ID : ‘ ‘ (Id чата группы)

Шаг 3 – Создаем бот и группу в Телеграм.

Здесь шаги аналогичны, как и для Яндекс Директ. Вернитесь чуть выше по инструкции.

После того, как мы создали мы копируем токен бота телеграма и id чата.

Шаг 4 – Выставляем необходимые переменные, тестируем работу.

В скрипте замените переменные:

days (Кол-во дней до окончания средств)
TOKEN: (Токен бота в телеграме)
CHAT_ID (Id чата вашей группы)

После того, как вы выставили все необходимые переменные нажимаем Выполнить.

Обязательно Авторизуем скрипт со своей почты. И запускаем, для проверки можете установить большее кол-во дней до окончания бюджета, чтобы убедиться в том, что сообщения доходят.

Шаг 5 – Автоматизация скрипта

После успешной проверки – вы можете установить частоту выполнения скрипта (Например, ежедневно с 9 до 10).

В таком случае скрипт будет срабатывать каждый день с 9 до 10 и при выполнении условия по кол-ву оставшихся дней отправлять уведомления в телеграм.

Итого

В данной статье описаны варианты настройки уведомлений о бюджете в Телеграм для Яндекс Директ и Google Ads;
Представлено 2 варианта для агентств/фрилансеров и клиентов, в зависимости от выбора скрипта – вы можете отслеживать один или несколько рекламных аккаунтов;
Вы можете редактировать условия, при которых уведомления будут приходить;
Вы можете использовать 4 скрипта по отдельности в зависимости от ваших задач;

Если настройка показалась вам сложной в реализации, но сделать очень хочется – пишите в ЛС, будут рада помочь на платной основе.

Источники:

Идея для Google Ads взята за основу от Netpeak. Скрипт был доработан мной под задачу, скрипт для Яндекс был реализован мной, помогал ChatGPT.

Теги:

Категории:

Контекстная реклама

Алена Шваб

Основатель digital-агентства sas-company.by, digital-маркетолог и автор телеграм-канала по контекстной рекламе https://t.me/sas_company_cases тг для связи @sas_digital