Подключаем Яндекс к ИИ — Метрика, Вебмастер, Директ

Что происходит и куда жмём

Чтобы агент смог тянуть статистику из Яндекс.Директа, нужно один раз создать OAuth-приложение — это занимает 3 минуты. Метрика и Вебмастер подключаются проще, без модерации.

Открываем → https://oauth.yandex.ru/

Жмём «Зарегистрировать приложение» → платформа «Веб-сервисы» → Redirect URI https://oauth.yandex.ru/verification_code → доступы: Яндекс.Директ API (direct:api), и сразу добавь рядом metrika:read для Метрики и webmaster:hostinfo,webmaster:verify для Вебмастера, если они тоже пойдут в дашборд.

В конце формы будут два поля «зачем приложение и как работает» — модерация Директа смотрит именно их. Ответы готовы, копируй блоками ниже.

Ответ на «Какие новые возможности работы с Директом даёт ваше приложение пользователям?»

Внутренний маркетинговый дашборд для отслеживания эффективности рекламных кампаний.
Приложение получает статистику по объявлениям (показы, клики, расход) через Reports API
и сопоставляет с лидами из CRM для расчёта CPL и конверсий.
Только чтение данных, без управления кампаниями.

Ответ на «Опишите схему взаимодействия вашего приложения с Директом»

1. Раз в день (или по запросу пользователя) приложение делает 2-3 запроса к Reports API:
   - AD_PERFORMANCE_REPORT — статистика по объявлениям
   - SEARCH_QUERY_PERFORMANCE_REPORT — поисковые запросы
   - Ads.get — тексты объявлений (по необходимости)

2. Защита лимитов API:
   - Максимум 5-10 запросов в день (ручной запуск через веб-интерфейс)
   - Соблюдение retryIn из заголовков ответа при формировании отчётов
   - Кэширование результатов — повторный запрос за тот же период не обращается к API
   - processingMode: auto — отчёт формируется в фоне, не нагружая API
   - Никаких мутаций: приложение ТОЛЬКО читает статистику

3. Результат отображается на закрытом веб-дашборде (Basic Auth)
   для внутреннего использования маркетологом компании.

После регистрации

  1. Сохрани ClientID и Client secret приложения.
  2. Получи OAuth-токен в браузере: https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID> → разреши доступ → токен прилетит в URL после #access_token=.
  3. Положи токен в .env проекта как YANDEX_DIRECT_TOKEN (и аналогично для Метрики/Вебмастера).

Вот что получим в итоге

Marketing Dashboard v2

Кликни по картинке — откроется в полном размере, можно сохранить.

Подготовительный материал для встречи 1 «Подключаем бизнес к нейросетям» — вайбкодинг-мастермайнд.