Импорт расходов Директа в Гугл Таблицы

Две статьи,

Получаем отчет из Яндекс Директ формулой в Google Таблицу

Следим за балансом «Яндекс.Директа» в «Google Таблицах»

Введение

Привет! На связи Артём Дурнев и Султан Назаралиев. Мы занимаемся performance маркетингом и сквозной аналитикой. Как и все кто занимается платным трафиком мы делаем много отчётов. Для этого используем Google Таблицы.

Но сводить данные в Google Таблицах не всегда легко. Например, как отчеты из Яндекс Директа. Скачивать Excel файл, а потом заливать его в таблицу — неудобно. Но мы нашли решение.

Как это все устроено

Из Яндекс Директа можно получить данные программным способом при помощи API.

Для Google Таблиц мы сделали формулу для получения статистики из API Яндекс Директ через Google Apps Script.

Это фреймворк для интеграции с многими сервисами Google.

Как пользоваться

Скопируйте Google Таблицу

Скопируйте специальную Google Таблицу. В ней уже есть формула для получения данных

Получите и скопируйте токен Яндекс Директ

Чтобы получить данные из Яндекс API вам нужен токен. Для получения токена перейдите на наше приложение Яндекс OAuth

Обратите внимание на аккаунт Яндекса для которого вы получаете токен

Вставьте токен в поле OAuth Token Google Таблицы и вызовите формулу

Изменяйте поля отчёта под себя

Полный список параметров и показателей для поля Field names

Как это работает

Формула получения отчёта называется YandexDirectReport.

Подробнее про поля формулы:

1. yaToken — токен Яндекса
2. login — логин клиента в Яндекс Директ. Если используется для агентского аккаунта — укажите логин клиента. Если ваш аккаунт представительский — логин представительского аккаунта
3. datefrom — дата начала отчёта в формате ГГГГ-ММ-ДД
4. dateto — дата окончания отчёта в формате ГГГГ-ММ-ДД
5. fields — поля отчета. Перечислите поля через точку с запятой внутри кавычек «CampaignName;Clicks;Cost»
6. includeVAT — включая НДС

Пример

YandexDirectReport( «eh3eldlxoL4iMnoRcAhkGa»; «anilange-ss»; «2019-05-24»; «2019-05-24»; «CampaignName;Clicks;Cost»; «YES»)​

Заключение

Так мы упростили загрузку данных из Яндекс Директа в Google Таблицы. Хотим поделиться решением, возможно кому-то будет полезно.

Вторая статья про импорт остатков

Мы очень любим микро автоматизацию PPC проектов в Google Таблицах.

Что у вас здесь происходит?!

В одной из прошлых статей мы сделали формулу с помощью которой можно получить статистику из Яндекс Директа не покидая Google Таблиц. Инструмент оказался полезным. Им воспользовалось более 1000 пользователей.

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

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

Как всё работает

Из Яндекс Директа можно получить данные при помощи API. Это касается как статистики так и другой информации.

В данной таблице уже есть формула YandexDirectBalance. Этой формулой можно получить баланс из агентского или клиентского аккаунта Яндекс Директ.

Делается это так:

Вызываете формулу YandexDirectBalance

Первым аргументом указываете токен. Получить его можно в нашем приложении Яндекс OAuth

Вторым аргументом указываете логин аккаунта Яндекс Директ.

Можно указать несколько логинов. Перечислите их через точку запятую:

=YandexDirectBalance(«AQAAAAA4tfhfAAZAoZsO-I-bwUMPoIVrGiS9S», «login1;login2;login3»)

Формула вернёт таблицу из 3 столбцов: логин, баланс, валюта.

Вот и всё.

Но значение баланса в ячейке таблицы несет не так много пользы.

В этом материале мы предложим способ отслеживания баланса с отправкой уведомления на почту по расписанию. И все это в Google Таблицах

Представим, что мы хотим получать уведомление, когда денег на балансе осталось на 7 или менее дней.

В таблице «Баланс Яндекс.Директ» есть лист – schedule. В этом листе необходимо указать все параметры для получения баланса.

Параметры отмеченные знаком ✅ – можно редактировать, 🔴 – нельзя редактировать.

Авторизация

Имя — название клиента (произвольное имя)

Токен — токен агентского или клиентского аккаунта

Логин — логин аккаунта

Статистика

Баланс — выводится баланс формулой YandexDirectBalance

Расход за дней — кол-во дней для получения статистики расходов в столбце «Расход». Пример: 7 дней, это значит: если сегодня 8 августа, то период с 1 августа по 7 августа.

Расход — затраты за указанное кол-во дней

Дней открута — фактическое кол-во дней расхода. Например по Клиенту-1 получили 7 дней, а по Клиенту-2 получили 6 дней. Это значит, что по клиенту 2 в один из дней кампании были на стопе

Средний расход — результат «Расхода», деленное на «Дней открута»

Условия отправки уведомлений

Тема сообщения — тема письма, которое придет на почту.

К примеру, можно написать формулу:

=»Уведомление о балансе по клиенту «&A2

Результат: Уведомление о балансе по клиенту Клиент-1

Купить рекламуОтключить

Сообщение — текст письма, которое приходит на почту.

Пример:

=»Уважаемый «&A2&»! Ваш баланс «&ROUND(D2*1,2;2)&». Он закончится через «&ROUND(D2/H2;0)&» дней. Примите меры!»

Результат: Уважаемый Клиент-1! Ваш баланс 333730,04. Он закончится через 4 дня. Примите меры!

Email — адреса для отправки необходимо заполнить через точку с запятой. Также аналогично другим столбцам можно выстроить свою логику отправок с помощью базовых формул Google-таблиц.

К примеру: нам необходимо отправлять уведомление только в том случае, если денег в кабинете будет меньше, чем наш расход за неделю. В таком случае формула будет выглядеть так:

=IF(D2/H2<E2;»adv@adf-media.ru»;»»)

В данной формуле мы говорим: если баланс / средний расход в день меньше чем 7 дней, то показать список электронных адресов, если нет — не показывать. В таком случае, когда денег на балансе хватит больше чем на 7 дней, согласно формуле, список электронных адресов не покажется в поле и уведомление не отправится. Если хватит меньше чем на 7 дней, то формула покажет почты, и функция отправит уведомления.

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

Инструкция

Как применить к своему проекту:

Шаг 1. Переходим в Google-таблицу, создаем копию

Шаг 2. Указываем название клиента в столбце Имя

Шаг 3. Указываем токен аккаунта в столбце «Токен». Приложение для получения токена.

Шаг 4. Указываем логин аккаунта в столбце «Логин»

Шаг 5. Указываем нужное количество дней в столбце «Расход за дней»

Шаг 6. Пишем тему и текст письма в столбцах «Тема сообщения» и «Сообщение»

Шаг 7. Указываем список электронных адресов для отправки

Далее устанавливаем расписание:

Шаг 8. Скопируйте id вашей таблицы. Перейдите в Расширение -> Apps Script. Вставьте id в переменную в первой строке

Шаг 9. Предоставьте разрешения скрипту подключаться к внешним сервисам и отправлять письма

Шаг 10. Установите триггер отправки по времени

В добавление триггера для проекта устанавливаем следующие параметры:

1. Выберете функцию: balanceShedule
2. Выберете, какое развертывание выполнить: Основное развертывание
3. Источник мероприятия: Триггер по времени
4. Выберете тип триггера: По дням (для того, что бы получать уведомления раз в день)
5. Выберете необходимое время
6. Сохранить

Готово!

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

Заключение

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

На практике подобный инструмент мы используем в наших проектах и передаём баланс в Telegram, отправляем на почту, также применяем при отчетности в Google Data Studio, Power BI, Tableu.