Отчёты по Директу сами собой: API → PDF → Telegram
Понедельник, кофе, двадцать клиентов ждут отчёт. Если вы узнали себя — эта статья для вас. Отчёт можно собирать автоматически: скрипт сам снимает статистику, сравнивает с прошлой неделей, делает PDF и присылает клиенту в Telegram.
Александр Евстигнеевмаркетолог, сертифицированный специалист Яндекс Директ Про
Пять шагов: приложение на oauth.yandex.ru (доступы к Директу и Метрике) → заявка на доступ к API в самом Директе → токен после одобрения → бот в Telegram → агент-нейросеть собирает скрипт, а расписание запускает его, например, по понедельникам в 9:00. Секреты — только в файле настроек, не в чате и не в публичном репозитории.
Зачем это нужно
Автоматизация окупается, когда клиентов больше двух-трёх. На выходе раз в неделю:
- скрипт снимает статистику Директа;
- добавляет из Метрики отказы и глубину просмотра;
- сравнивает настройки кампаний с прошлой неделей;
- собирает PDF с вашим логотипом и цветами;
- отправляет в чат с клиентом.
Есть два режима: полуручной — в понедельник пишете агенту «собери отчёт»; полный автомат — расписание всё делает само.
Какую нейросеть брать
Почти любую. Главное — чтобы она работала с папкой проекта на компьютере или сервере, а не только в окне чата. Подойдут среды для программирования с ИИ-агентом: они сами поставят нужные программы и напишут скрипт. Для отчётов хватит недорогих моделей — топовые здесь избыточны.
Когда скрипт написан, нейросеть почти не нужна: он запускается сам.
Шаг 1. Приложение на oauth.yandex.ru
Это не заявка в Директе, а отдельный сайт: oauth.yandex.ru. Входите под логином, к которому нужен доступ.
- Тип приложения — «Для доступа к API или отладки».
- Название — любое, например «Еженедельные отчёты».
- В доступах ищите на английском:
dirиmetr. Нужны два права:direct:apiиmetrika:read. - Сохраните ClientID и секрет.
- 1Ищите на английском — на русском поиск прав часто ничего не находит
- 2Одно приложение тянет статистику со всех кабинетов, к которым есть доступ
Не нужно регистрировать отдельное приложение под каждый из пятидесяти кабинетов. Одно приложение тянет статистику со всех кабинетов, к которым есть доступ.
Шаг 2. Заявка в Директе
Теперь в самом Директе: «Настройки API» → «Мои заявки» → «Новая заявка». Если страница не открывается — примите соглашение об использовании API; в кабинете должна быть хотя бы одна кампания.
- Выберите ClientID, который создали на первом шаге.
- В описании напишите честно: «выгрузка статистики и еженедельные PDF-отчёты клиентам, без управления ставками».
- Рассматривают до 7 дней, на практике часто за 10–15 минут.
Шаг 3. Токен
Только после статуса «одобрена». Откройте под нужным аккаунтом адрес:
https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID
Полученный токен положите в файл настроек .env. Не храните его в переписке и не отправляйте в общий репозиторий.
Что API отдаёт, а что нет
Журнал «История изменений» из интерфейса через API не выгружается. Есть только флаги: менялась ли сама кампания, менялось ли что-то внутри неё, поправил ли Яндекс статистику (часто это антифрод).
Поэтому, чтобы написать в отчёте «добавили минус-слова», скрипт должен сам сохранять снимок настроек каждую неделю и сравнивать с прошлым. Пока снимков нет — в отчёте только цифры, без описания действий.
Если у агента нет прошлого снимка, он может написать «оптимизировали ставки», хотя никто ничего не трогал. Запретите описывать действия без данных о них.
Telegram-бот
- Создайте бота через официальный @BotFather — только с синей галочкой. Команда
/newbot, имя, адрес наbot, получите токен. - Один бот может работать на все проекты: просто добавьте его в разные чаты.
- Дайте боту право удалять сообщения — если отправит лишнее, сможет убрать.
- Узнайте
chat_idнужного чата — например, через бота, который показывает ID.
Сборка и расписание
- Дайте агенту подробное задание: ниша, сайт, токен Директа, цели Метрики, токен бота, chat_id. Пусть не начинает писать код, пока всех данных нет, и не подставляет заглушки.
- Сначала отправьте первый отчёт вручную и посмотрите, всё ли в порядке.
- Выгрузите проект в закрытый репозиторий. Секреты — в
.env, в репозиторий они не попадают. - Поставьте расписание: например, каждый понедельник в 9:00 по Москве. Это можно сделать на своём сервере, через автоматизации среды разработки или облачные задания.
Ниже 10 готовых наборов показателей для еженедельного автоотчёта — что снимать из Директа и Метрики в разных нишах. Вставьте нужный набор в задание агенту.
Скопируйте набор своей ниши в задание агенту вместе с ID целей Метрики. Раз в месяц сверяйте отчёт с CRM — если цифры заявок расходятся, сначала чините цели, а не отчёт.
- 1Ремонт квартирклиент-владелец ремонтной компанииДирект — расход, клики, цена клика по кампаниям.
Метрика — заявки по цели «Отправил форму» и звонки, цена заявки.
Сравнение с прошлой неделей в процентах.
Блок «Что меняли» — только из снимка настроек.Почему работает. Владельцу ремонта важна цена заявки, а не клики. Блок изменений из снимка не даёт агенту выдумывать действия. - 2Интернет-магазинклиент-собственник магазинаДирект — расход и клики по товарным и поисковым кампаниям.
Метрика — заказы, выручка, ДРР по электронной коммерции.
Топ-5 товаров по выручке из рекламы.
Отказы по главным категориям.Почему работает. Магазину нужен ДРР, а не цена заявки. Топ товаров подсказывает, на что поднять ставки. - 3Стоматологияуправляющий клиникойДирект — расход, клики, показы по кампаниям.
Метрика — записи онлайн и звонки, цена записи.
Доля мобильного трафика и его конверсия.
Отказы и глубина просмотра по страницам услуг.Почему работает. Запись в клинику часто идёт со смартфона. Отдельная строка по мобильным показывает, где теряются пациенты. - 4B2B-оборудованиекоммерческий директорДирект — расход и клики по направлениям оборудования.
Метрика — запросы КП, скачивания прайса, звонки.
Цена запроса КП по направлениям.
Ключевые фразы с расходом без конверсий за 2 недели.Почему работает. В B2B сделок мало, поэтому считают промежуточные действия. Фразы без конверсий — готовый список на чистку. - 5Онлайн-школапродюсер курсаДирект — расход, клики, цена клика.
Метрика — регистрации на вебинар и оплаты, цена регистрации.
Доходимость до оплаты по неделям.
Сравнение аудиторий ретаргетинга и холодных кампаний.Почему работает. Продюсеру важна цепочка от регистрации до оплаты. Сравнение холодных и тёплых кампаний показывает, куда направить бюджет. - 6Доставка едывладелец кафе с доставкойДирект — расход и клики по дням недели.
Метрика — заказы и средний чек по рекламе.
Пики заказов по часам.
Расход по районам, если стоят радиусы.Почему работает. Доставка живёт по часам и дням. Пики заказов подсказывают расписание показов. - 7Агентство недвижимостируководитель отдела продажДирект — расход и клики по объектам или ЖК.
Метрика — заявки на подборку и звонки по каждому ЖК.
Цена заявки по объектам.
Квиз — сколько дошли до конца и сколько оставили телефон.Почему работает. Разные ЖК продаются по-разному. Разбивка по объектам показывает, на какой из них тратится бюджет впустую. - 8Автосервисвладелец сервисаДирект — расход, клики, доля показов на мобильных.
Метрика — звонки и онлайн-записи, цена записи.
Запросы с «рядом» и «срочно» и их конверсия.
Сравнение будней и выходных.Почему работает. Клиент автосервиса ищет помощь срочно и рядом. Отдельная строка по таким запросам показывает самые горячие обращения. - 9Юридическая компанияуправляющий партнёрДирект — расход и клики по направлениям права.
Метрика — заявки на консультацию и звонки.
Цена заявки по направлениям.
Поисковые запросы, которые стоит добавить в минус-слова.Почему работает. Юристам приходит много нецелевых запросов вроде «бесплатно» и «образец». Список кандидатов в минус-слова экономит бюджет. - 10Производство мебелисобственник фабрикиДирект — расход и клики по категориям мебели.
Метрика — заявки на расчёт и замер, цена заявки.
Изменения настроек кампаний за неделю из снимка.
Отказы на страницах каталога.Почему работает. Собственнику важно видеть, что сделано за его деньги. Снимок настроек позволяет честно описать действия.
Чек-лист
Частые вопросы
Не нахожу право metrika:read при создании приложения
Ищите в поиске прав на английском: metr и dir. На русском поиск часто ничего не находит.
Можно выгружать отчёты в Google Таблицы вместо PDF?
Да, через коннектор к таблицам. Но для клиента PDF в чате обычно удобнее: открыл и посмотрел.
Стоит ли платить за сервис отчётов?
Для своих клиентов обычно дешевле собрать самим: один раз потратить вечер, потом отчёты идут бесплатно.
Читайте дальше
Система работы с ИИКак ставить задачу нейросети, хранить контекст, когда нужны агенты
Яндекс МетрикаСчётчик, цели, связь с Директом, отчёты, вебвизор, Тег Менеджер
Аналитика в ExcelСводим выгрузки Директа и CRM, анализируем запросы
База знаний + ИИПять лет аудитов лежат в папках — а ответ на вопрос клиента вы ищете заново каждый раз