Готовая формула для выгрузки данных из Яндекс Директа напрямую в Google Таблицу
Введение
Привет! На связи Артём Дурнев и Султан Назаралиев. Мы занимаемся performance маркетингом и сквозной аналитикой. Как и все кто занимается платным трафиком мы делаем много отчётов. Для этого используем Google Таблицы.
Но сводить данные в Google Таблицах не всегда легко. Например, как отчеты из Яндекс Директа. Скачивать Excel файл, а потом заливать его в таблицу - неудобно. Но мы нашли решение.
Как это все устроено
Из Яндекс Директа можно получить данные программным способом при помощи API.
Для Google Таблиц мы сделали формулу для получения статистики из API Яндекс Директ через Google Apps Script.
Это фреймворк для интеграции с многими сервисами Google.
Как пользоваться
Скопируйте Google Таблицу
Скопируйте специальную Google Таблицу. В ней уже есть формула для получения данных
Получите и скопируйте токен Яндекс Директ
Чтобы получить данные из Яндекс API вам нужен токен. Для получения токена перейдите на наше приложение Яндекс OAuth
Вставьте токен в поле OAuth Token Google Таблицы и вызовите формулу
Изменяйте поля отчёта под себя
Полный список параметров и показателей для поля Field names
Как это работает
Формула получения отчёта называется YandexDirectReport.
Подробнее про поля формулы:
- yaToken - токен Яндекса
- login - логин клиента в Яндекс Директ. Если используется для агентского аккаунта - укажите логин клиента. Если ваш аккаунт представительский - логин представительского аккаунта
- datefrom - дата начала отчёта в формате ГГГГ-ММ-ДД
- dateto - дата окончания отчёта в формате ГГГГ-ММ-ДД
- fields - поля отчета. Перечислите поля через точку с запятой внутри кавычек "CampaignName;Clicks;Cost"
- includeVAT - включая НДС
Пример
Заключение
Так мы упростили загрузку данных из Яндекс Директа в Google Таблицы. Хотим поделиться решением, возможно кому-то будет полезно.
Данные об остатке может передавать?...
Нет, но предложение отличное. Допилим в следующей версии
А если еще можно будет увидеть на какой период хватить этих средств и еще помечать остаток в последние три дня, будет идеально!
Поддерживаю, искал много в инете как следить за балансом клиентов. уж больно много времени уходит на переходы между аккаунтами
Было бы круто, если можно было так выгружать остаток на счету
8800 скорее всего от того, что в поле client login вы не вписали собсна логин клиента. Я вписала, у меня ошибка 4001 - не нравится формат даты, но он такой как надо https://prnt.sc/sigoht
Скорей всего у вас формат "числа" или "даты", а должен быть формат "текст". Проверить формат можно с помощью формулы "type". Если результат формулы 2 - текст, если 1 - это число.
да, спасибо!
Привет, Артём и Султан!
Спасибо за статью, материал полезный.
Есть несколько вопросов, буду благодарен за ответы.
1. Почему токен вы рекомендовали получать через ваше приложение, а не получить его напрямую у Яндекса, минуя посредников?
2. Сохраняете ли вы у себя токены, которые получены через ваше приложение?
3. Если сохраняете, то, теоритически, какие данные из аккаунтов, сделавших токен через ваше приложение, вы можете получать?
Здравствуйте Артём!
Вы можете получать токен напрямую, если у вас есть свое приложение. Все сервисы которые работают с вашими данным Яндекс Директ используют своё OAuth приложение. Мы сделали также. Это исключительно для удобства пользователей кому не нужно регистрировать приложение.
В любом случае токены сохраняются в логах запросов к серверу. Данные к которым вы даете доступ приложению написано на странице Яндекса в момент авторизации. В нашем приложении это соответственно доступ к Яндекс Директ, Яндекс Метрике и данные вашего аккаунта в Яндексе. В дальнейшем мы хотим сделать такое же дополнение для Яндекс Метрики, а для того чтобы узнать нужно ли это людям, мы хотим знать количество пользователей дополнения для принятия решения: развивать его или нет
Спасибо за материал!
Рекомендую для следующей версии добавить параметр "Goals", что позволит получать данные по определенным целям. Сейчас этого не хватает
Полезная информация, спасибо. Раньше приходилось статистику скачивать в Excel-файл, потом копировать и вставлять в Google Таблицу, что занимает время. Теперь можно это делать более удобно и изменять поля отчета под себя.
Привет! Выдает ошибку 8800. В чем может быть проблема?
Можете показать скрин?
Минут 20 назад отчет строился, а теперь такая же ошибка. Уже сто раз проверил и написание логина и токена, но всё равно ошибка http://prntscr.com/ura6mj
А статистика по смарт баннерам и динамическим кампаниям тоже будет выгружаться?
Спасибо, большое, очень сильно упрощает выгрузку данных из директа в Data Studio!
Можно и по смарт баннерам и по динамическим кампаниям.
спасибо, отличное приложение.
все работает, и очень удобно выгружать быстро данные с директа.
Добрый день, а как сделать чтобы числа были в российском формате, а то не получается использовать цифры в других формулах
Добрый день! Спасибо за приложение. А можно ли получить данные не по всем кампаниям аккаунта, а настроить отчет для конкретной кампании?
Как сделать, чтобы данные выгружались в формате чисел, а не в формате текста?