Предназначена для выгрузки статистики рекламных кампаний за выбранный промежуток времени по нужному списку показателей напрямую в Power BI или Excel.
Функция работает с сервисом Reports API Яндекс Директ 5 версии: https://yandex.ru/dev/direct/doc/reports/reports-docpage/
- Для начала залогиньтесь в нужном аккаунте Яндекс и получите токен авторизации по ссылке: https://oauth.yandex.ru/authorize?response_type=token&client_id=764f4af41256427ba87965a7ed31ea3d
- Согласитесь предоставить доступ к аккаунту (кроме вас им никто не сможет воспользоваться, если, конечно, вы не отдадите кому-то свой токен). Дополнительная информация: https://yandex.ru/dev/direct/doc/start/token-docpage/
- Скопируйте токен
- Создайте новый пустой запрос в Power Query для Power Bi или Excel и вставьте в него исходный код функции
- Вставьте токен в поле функции "Авторизационный токен" и заполните остальные параметры функции на свой вкус.
- Выполните функцию. Отчет подготавливается в режиме оффлайн, поэтому через некоторое время обновляйте запрос пока не получите таблицу с данными. Если заново запросить подготовленный отчёт с теми же параметрами, то он загрузится незамедлительно.
Все параметры необязательные, но без токена ничего не выйдет.
Параметр | Тип | Значение по умолчанию | Описание |
---|---|---|---|
Дата начала интервала | date | 30 дней назад | Дата начала отчета не позднее сегодняшней |
Дата окончания интервала | date | сегодня | Дата окончания отчета не позднее даты начала |
Поля отчета в списке | список | Выбирайте поля, доступные в CUSTOM_REPORTS https://yandex.ru/dev/direct/doc/reports/fields-list-docpage/ | |
Название отчета | text | пусто | Если во время экспериментов API будет "ругаться", что такой отчёт с другими параметрами уже есть, просто придумайте уникальное название 😏 |
Логин аккаунта клиента | text | пусто | Если вы работаете в агентском аккаунте, то для получения статистики клиента укажите логин клиента (тот, что из почты до @) |
Авторизационный токен | text | пусто | Для начала работы залогиньтесь в нужном аккаунте Яндекс и получите токен авторизации по ссылке: https://oauth.yandex.ru/authorize?response_type=token&client_id=764f4af41256427ba87965a7ed31ea3d |
Несколько советов, помогающих упростить вашу работу:
- Чтобы задать список полей, используемых по-умолчанию, закомментируйте ненужные поля с помощью "//" и снимите комментарии напротив нужных полей. Список полей присваивается переменной fields в строках код.
- Чтобы постоянно не указывать токен авторизации, создайте параметр и запишите в него токен. .
- Диапазон дат по-умолчанию задается в переменных endDate (сегодня) и beginDate (30 дней назад).
С вопросами и предложениями стучитесь:
- в фейсбук https://www.facebook.com/iliah.nazarov
- в телеграм https://t.me/IlyaNazarov