Отслеживание остатка бюджета в Google Ads: пошаговая настройка отправки уведомлений в Telegram и на почту

В этой статье мы расскажем и покажем, как подключить скрипт, который отправляет данные об остатке денежных средств на аккаунтах, привязанных к My Client Center (MCC) с оплатой по предоплате, на почту и в Telegram-бот. Итак, начнем.

 

Подключаем скрипт к MCC

 

1. В аккаунте MCC в правом верхнем углу находим “Инструменты и настройки”. Далее идем во вкладку “Массовые действия” → “Скрипты”

2. Нажимаем на “+”, чтобы добавить новый скрипт

 

3. Вставляем скрипт:

var CONFIG = {
// Указать минимальное количество дней до окончания средств на аккаунте для отправки уведомления.
days : 7,
// Указать почты для отправки уведомлений, через запятую, если больше одной
email : ['email@gmail.com', 'email2@gmail.com'],
// Указать ники/имена кому отправляется письмо, через запятую, если больше одного
names : ['name', 'name2'],
// Помечаем необходимые для отслеживания аккаунты ярлыком, пример - BudgetControl
labelName : ['BudgetControl']
}
function main () {
var accounts = MccApp.accounts()
.withCondition('LabelNames CONTAINS "' + CONFIG.labelName + '"')
.executeInParallel("budgetControl")
}
function budgetControl() {
var accountName = AdWordsApp.currentAccount().getName();
var budgets = AdWordsApp.budgetOrders().withCondition('Status = ACTIVE').get();
while (budgets.hasNext()) {
try {
var budget = budgets.next();
if (budget.getSpendingLimit() !== null ) {
var startDate = timeFormat(budget.getStartDateTime());
var cost = AdWordsApp.currentAccount().getStatsFor(startDate,today()).getCost();
var last7DaysCostByDay = (AdWordsApp.currentAccount().getStatsFor("LAST_7_DAYS").getCost() / 7).toFixed();
var limit = budget.getSpendingLimit();
var remainingDays = rDays(limit, cost, last7DaysCostByDay);
var budgetNow = (limit - cost).toFixed();
if (budgetNow < 0) {
var budgetNow = 0;
}
else {
var budgetNow = budgetNow;
}
Logger.log([accountName, budgetNow, last7DaysCostByDay, remainingDays]);
if (remainingDays < CONFIG.days) {
sendTelegramMessage('Аккаунт ' + accountName + ' . Текущий остаток = ' + budgetNow + '. Расход в день = ' + last7DaysCostByDay +
' . Денег хватит на ' + remainingDays + ' дня/дней.');
MailApp.sendEmail(CONFIG.email,
CONFIG.names +' / Заканчивается бюджет на аккаунте: ' + accountName,
'Аккаунт ' + accountName + ' . Текущий остаток = ' + budgetNow +
'. Расход в день = ' + last7DaysCostByDay + ' в валюте аккаунта. ' +
'Денег хватит на ' + remainingDays + ' дня/дней. В аккаунте заканчиваются средства. Необходимо предупредить PM.');
}
}
}
catch (e) {
Logger.log(e);
sendTelegramMessage('Ошибка выполнения скрипта контроль Бюджетов ' + accountName);
MailApp.sendEmail(CONFIG.email,
'Ошибка выполнения скрипта Контроль бюджетов',
'Необходимо проверить работу скрипта Контроль бюджетов ' + accountName + ' ' + e);
}
}
}
function timeFormat (date) {
var year = date.year.toString();
var month = date.month.toString();
var day = date.day.toString();
if (month.length == 1) {
month = "0" + month;
}
if (day.length == 1) {
day = "0" + day;
}
return [year, month, day].join("");
}
function today () {
var date = new Date();
var timeZone = AdWordsApp.currentAccount().getTimeZone();
var format = 'yyyyMMdd';
return Utilities.formatDate(date, timeZone, format);
}
function rDays(limit, cost, last7DaysCostByDay) {
var remainingDays = ((limit - cost) / last7DaysCostByDay).toFixed();
if (remainingDays < 1 || remainingDays == "Infinity" || remainingDays == "-Infinity" || remainingDays == -0 ) {
remainingDays = 0;
}
return remainingDays;
}
function sendTelegramMessage(text) {
var CONFIG2 = {
TOKEN: 'ХХХХХХХХХХХХХХХХХХХХХХ',
CHAT_ID: 'ХХХХХХХХХ'
};
var telegramUrl = 'https://api.telegram.org/bot' + CONFIG2.TOKEN + '/sendMessage?chat_id=' + CONFIG2.CHAT_ID + '&text=';
var message = encodeURIComponent(text);
var sendMessageUrl = telegramUrl + message;
var options = {
method: 'POST',
contentType: 'application/json'
};
UrlFetchApp.fetch(sendMessageUrl, options);
}

4. Меняем данные в первой части скрипта на свои.

→ DAYS – количество дней, на которое должно хватить остатка. В случае, если остатка хватит менее, чем на 7 дней, вам придет уведомление

→ EMAIL – прописываем почту, куда будут приходить уведомления об остатке

→ NAME – указываем ники/имена, кому будет отправляться письмо

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

Обратите внимание, что email-адреса, имена и название ярлыка указываются в одинарных кавычках — ‘

Оставляем скрипт. К нему мы еще вернемся.

 

Создаем Telegram-бот

 

  1. Заходим в Telegram и находим бота: @BotFather
  2. Выбираем команду /newbot, чтобы создать своего бота

  1. Вводим имя и username в формате name_bot, где name — уникальное имя вашего бота

В ответ пришло сообщение: “Sorry, this username is already taken. Please try something different”? Придумываем новое уникальное имя

Если имя уникально, то вы получите такое сообщение:

  1. Копируем и вставляем в строку браузера ссылку: https://api.telegram.org/botТОКЕН/getUpdates, где TOKEH — значение из сообщения бота. По ссылке пока не переходим

    5. Кликаем по ссылке t.me/ХХХХ_bot в сообщении с токеном от чат-бота и переходим в свой свежесозданный бот. Отправляем ему любое сообщение

    6. Теперь можно перейти по ссылке в браузере. Из полученного ответа копируем id чата

Бот готов. Осталось внести несколько изменений в скрипт

 

Дорабатываем и запускаем скрипт

 

Возвращаемся к скрипту в Google Ads. В самом нижнем блоке скрипта вставляем следующие значения:

→ TOKEN – номер токена из ответа бота

→ CHAT_ID – номер чата из ответа в браузере

TOKEN и CHAT_ID так же заключены в одинарных кавычках — ‘

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

Учтите, что скрипт может работать с задержкой до 1 часа. Т.е. если в расписании стоит ежедневное выполнение в 8:00, то данные в бот и на почту могут подтянуться не сразу, а в течение часа

Добавляем к аккаунтам ярлык, название которого прописывали в скрипте

После чего можно проверить работоспособность скрипта, выбрав команду “Выполнить”. Если скрипт будет выполнен без ошибок, в Telegram-бот и на почту придут уведомления об остатках

Telegram

 

Почта

 

 

 

 

 

 

 

 

 

 

 

Всё готово! Успехов в продвижении и вагон лидов 🙂