Яндекс Директ — статистика кампаний

Для рекламодателей Яндекс Директа: список кампаний с их состоянием и ключевыми целями, расходы без НДС, показы, клики, CTR, средняя цена клика, конверсии по целям Метрики и стоимость заявки за период. Искра показывает итоги за выбранные даты, динамику по дням и разбивку по кампаниям — по всему кабинету или по выбранным кампаниям. Навык только читает статистику: кампании, ставки и бюджеты он не меняет.

Директ, РСЯ, Метрика и Вебмастер: какой сервис нужен

Конверсии в отчёте Директа считаются по целям Яндекс.Метрики, привязанным к кампаниям. Посещаемость и источники трафика сайта целиком остаются в навыке Метрики.

Подключение Директа: своё приложение и токен

Директ выдаёт доступ к API приложению, а не пользователю, поэтому токен получают через собственное OAuth-приложение. Искра своё приложение в Директе не регистрирует.

1. Откройте oauth.yandex.ru под аккаунтом рекламодателя и создайте приложение. В доступах отметьте «Использование API Яндекс Директа» (право direct:api); другие права навыку не нужны.
2. В интерфейсе Директа подайте заявку на доступ к API для этого приложения: раздел «Настройки API» → «Мои заявки». Заявка рассматривается в рабочие дни от часа до трёх суток, в пиковые периоды — до семи. До одобрения токен приложения к статистике не допускается.
3. После одобрения откройте ссылку https://oauth.yandex.ru/authorize?response_type=token&client_id=<ID вашего приложения> под аккаунтом рекламодателя и подтвердите доступ — Яндекс покажет токен. ID приложения указан в его карточке на oauth.yandex.ru.
4. Найдите «Яндекс Директ — статистика кампаний» в категории «Данные» каталога навыков и установите. Если маркетплейс на вашем контуре выключен, включите навык в каталоге. В защищённой форме навыка заполните два поля:
   • «Окружение API Директа» — оставьте production: это рабочий кабинет рекламодателя. Значение sandbox выбирают только для проверки приложения в песочнице Директа с тестовыми кампаниями; в песочнице отчёт строится по одной кампании.
   • «OAuth-токен» — вставьте только значение токена, без префикса Bearer, кавычек и пробелов. Токен вводится в поле формы, а не сообщением в чат. Форма доступна из карточки навыка; при запросе с пустым или отклонённым токеном Искра предложит открыть её из чата.
5. Сохраните настройку и напишите «Покажи мои кампании в Директе». Успешный список кампаний подтверждает подключение: токен принят и приложение допущено к API. Сохранение токена само по себе доступ ещё не доказывает.

Если заявка приложения ещё не одобрена, Директ отвечает ошибкой 58 «Незавершенная регистрация» (app_not_approved). Это не ошибка токена: менять или перевыпускать его не нужно — дождитесь решения по заявке и повторите запрос. Искра в этом случае форму не открывает, а напоминает о порядке рассмотрения.

Токен хранится для текущего профиля и уходит только на выбранный хост API Директа — api.direct.yandex.com или, в песочнице, api-sandbox.direct.yandex.com. При установке навыка в организацию каждый участник подключает собственный токен и видит только свои кампании. Отозванный токен можно заменить в той же форме, после сохранения нужно повторить запрос. Агентские аккаунты Директа с выбором клиента (заголовок Client-Login) навык не поддерживает: статистика читается по кабинету, которому принадлежит токен.

Примеры вопросов

• «Какие кампании есть в моём Директе и какие из них активны?»
• «Сколько потратили за прошлую неделю и сколько было кликов и заявок?»
• «Сравни стоимость заявки по кампаниям за август 2026 года».
• «Покажи расходы и клики по дням за 1–31 августа 2026 года».

Указывайте календарный период; если нужны отдельные кампании, назовите их — Искра найдёт их в списке кампаний по названию, а при совпадениях уточнит, какие именно имеются в виду. Для вопросов о заявках Искра берёт ключевую цель кампании из списка кампаний или спрашивает, какую цель считать заявкой.

Как читать результат

Расходы указаны без НДС в валюте кабинета — валюту Искра берёт из настроек вашего кабинета Директа. Даты периода включительно; один отчёт охватывает не более 366 дней, более длинный период Искра разбивает на несколько запросов. В ответе указаны выбранный период, охват (весь кабинет или конкретные кампании), валюта и пометка «без НДС».

Конверсии считаются только по отдельным целям Метрики: «заявка» — это одна конкретная цель. Ею служит ключевая цель кампании из списка кампаний или та цель, которую назовёте вы. При сравнении кампаний с разными ключевыми целями стоимость заявки каждой кампании считается по её собственной цели. Искра не складывает конверсии разных целей: одно событие на сайте может достигать нескольких целей, и такая сумма не равна числу заявок. Если цель не указана, показывается агрегат Директа «по всем целям» — Искра называет его именно так. Конверсии считаются по модели атрибуции LC (последний переход).

Если источник не отдал показатель, Искра сообщает, что он недоступен, и указывает, в скольких строках отчёта значения нет. Это отличается от числового нуля: «недоступно» в итогах означает, что сумма по периоду не получена, а не что заявок не было. Пустой отчёт означает отсутствие строк за выбранный период и охват; Искра сообщает об этом, сохраняя период и охват.

CTR, среднюю цену клика, стоимость заявки и конверсию Искра считает сама из итоговых сумм отчёта — показов, кликов, расходов и конверсий выбранной цели. При нулевом знаменателе (нет кликов или конверсий) показатель помечается недоступным, а не нулём.

Очередь отчётов Директа

Большие отчёты Директ формирует не сразу, а в очереди. Искра ждёт готовности до нескольких минут и затем показывает результат. Если ответ содержит «отчёт ещё формируется» (report_pending), повторите тот же запрос примерно через минуту — Искра продолжит ожидание того же отчёта, а не закажет новый. В очереди Директа одновременно находится не больше пяти отчётов одного пользователя; готовые отчёты Директ хранит пять часов.

Ошибки подключения и отчёта

• Токен не настроен, содержит лишние символы или отклонён (not_configured, invalid_token, token_rejected) — заполните или обновите токен в защищённой форме, она откроется из чата. После сохранения повторите свой запрос.
• Приложение не допущено к API (app_not_approved, ошибка 58 «Незавершенная регистрация») — заявка на доступ к API для вашего приложения ещё не одобрена. Токен менять не нужно; дождитесь решения по заявке в разделе «Настройки API» → «Мои заявки» Директа.
• Аккаунт не подключён к Директу (login_not_registered, ошибка 513) — токен получен под аккаунтом, у которого нет кабинета рекламодателя. Получите токен под аккаунтом с кабинетом Директа и замените его в форме.
• Нет прав (access_denied) — приложению или аккаунту запрещён доступ к запрошенным данным. Проверьте права приложения и аккаунта в Директе; при необходимости обратитесь к владельцу кабинета или в поддержку Яндекса.
• Исчерпан суточный лимит баллов (units_exhausted) — Директ ограничивает число обращений к API баллами, которые обновляются раз в сутки. Повторите запрос позже.
• Превышена частота запросов (rate_limited) — повторите позже.
• Очередь отчётов заполнена (queue_full) — в очереди Директа уже пять ваших отчётов. Дождитесь их готовности и повторите запрос.
• Отчёт ещё формируется (report_pending) — повторите тот же запрос через минуту, Искра продолжит тот же отчёт.
• Директ не успел сформировать отчёт (report_timeout, HTTP 502) — сузьте период или число кампаний и повторите запрос.
• Директ отклонил параметры запроса (invalid_request) — Искра сообщит, что именно не принято. В песочнице отчёт строится по одной кампании: укажите одну кампанию.
• Источник временно недоступен (source_error) — Директ ответил ошибкой сервера или ответ не удалось получить. Повторите позже; для обращения в поддержку Яндекса Искра сообщает идентификатор запроса, если Директ его вернул.
• Отчёт слишком велик (report_too_large) — сузьте период или попросите отчёт по выбранным кампаниям, а не по всему кабинету. Частичный итог не показывается.
• Ответ источника не разобран (invalid_response) — Директ вернул отчёт в неожиданном виде, и Искра отказалась показывать его частично. Повторите запрос; при повторении ошибки обратитесь в поддержку Искры.