РСЯ — доход от рекламы на своих площадках

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

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

«Клики по рекламе Яндекс Директа» в статистике РСЯ относятся к рекламе на ваших площадках. Это не отчёт о расходах ваших рекламных кампаний.

Подключение РСЯ и получение OAuth-токена

1. Откройте кабинет РСЯ под аккаунтом, зарегистрированным в Рекламной сети Яндекса. Если предлагается регистрация, сначала завершите подключение к РСЯ. Обычный Яндекс ID или кабинет рекламодателя Директа сами по себе не подтверждают доступ к статистике РСЯ. Для отчёта с показателями у площадок должна накопиться статистика.
2. Найдите «РСЯ — доход от рекламы на своих площадках» в категории «Данные» каталога навыков и установите. Если маркетплейс на вашем контуре выключен, включите навык в каталоге.
3. Откройте официальную инструкцию API статистики, перейдите по ссылке получения токена для статистики и войдите под аккаунтом из первого шага. Другой официальный путь: в кабинете РСЯ справа нажмите значок API → «Получить OAuth-токен для API статистики». Токен API настройки блоков предназначен для другой задачи.
4. Вставьте только значение токена в поле rsya_oauth_token защищённой формы навыка: без префикса OAuth, кавычек и пробелов. Форма доступна из карточки навыка; при запросе данных с пустым или отклонённым токеном Искра предложит открыть её из чата. Токен вводится в поле формы, а не сообщением в чат.
5. Сохраните настройку и напишите «Проверь подключение РСЯ» либо повторите запрос отчёта с датами. Сохранение токена ещё не означает успешный доступ: его подтверждает ответ API на проверку подключения.

В официальной ссылке получения токена уже указан client_id — идентификатор OAuth-приложения из документации Яндекса. Это не ваш секрет. Ссылку используют как есть; создавать собственное приложение по инструкции Метрики для этого способа подключения РСЯ не требуется.

Если у вас есть единый OAuth-токен для Метрики, Wordstat или Директа, наличие этих прав само по себе не подтверждает доступ к статистике РСЯ. Проверить сохранённый токен можно запросом подключения; при отказе используйте официальный способ получения токена статистики РСЯ выше.

Токен хранится для текущего профиля и используется только для обращений к partner.yandex.ru. При установке в организацию каждый участник подключает собственный токен. Отозванный токен можно заменить в той же форме, после сохранения нужно повторить запрос.

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

• «Покажи доход РСЯ, показы и клики за 1–31 августа 2026 года, с динамикой по дням».
• «Какие площадки встречаются в статистике РСЯ за август 2026 года?»
• «Покажи статистику площадки 458472 за 1–7 августа 2026 года».

Указывайте конкретный период и, если нужна одна площадка, её ID из списка. Искра получает доступные названия показателей из вашего кабинета: если источник разделяет виды кликов, в ответе сохраняется этот вид, например «клики по рекламе Яндекс Директа».

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

Доход указан в рублях без НДС, дни — по московскому времени. В ответе указаны выбранные даты и охват: весь кабинет или конкретная площадка. Данные текущего дня могут ещё пополняться.

Список охватывает площадки со статистикой за выбранный период. Площадки без активности могут в него не попасть; полный состав кабинета проверяйте в интерфейсе РСЯ.

Если источник не предоставляет показатель или его значение отсутствует, Искра сообщает, что он недоступен. Это отличается от числового нуля. Пустой отчёт означает отсутствие данных за выбранные даты и площадку. Успешное подключение подтверждает доступ к API; наличие статистики за конкретный период проверяется отдельно. Искра сообщает об отсутствии строк, сохраняя выбранный период и охват отчёта.

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

• Токен не настроен, содержит лишние символы или отклонён — заполните или обновите его в форме. После замены повторите свой запрос.
• Нет доступа (HTTP 403) — откройте кабинет под аккаунтом выдачи токена и проверьте права; при необходимости уточните их у владельца кабинета или поддержки РСЯ.
• Ресурс не найден (HTTP 404) — сохранённый токен использован для запроса, но этот ответ сам по себе не доказывает, что токен неверный или аккаунт не зарегистрирован. Откройте partner.yandex.ru под аккаунтом токена: если показана регистрация, завершите подключение; если кабинет доступен, обратитесь в поддержку РСЯ с кодом HTTP 404. Внутренний request_id Искры предназначен для поддержки Искры. До уточнения причины сохранённый токен можно оставить без изменений. Автоматическое повторение запроса причину не устраняет.
• Превышена частота запросов или источник временно недоступен — повторите позже.
• Отчёт получен не полностью — сначала выполните рекомендацию по причине ошибки: например, проверьте доступ или замените отклонённый токен в форме. Если причина — объём выгрузки, сузьте период и повторите запрос. Неполная выгрузка не выдаётся за итог.
• Показатель недоступен для такого отчёта — выберите доступный показатель по предложенной Искрой схеме; для разных групп она может сделать несколько запросов за одни и те же даты.
• Схема статистики слишком велика — посмотрите полный список показателей в кабинете РСЯ. Если схема превышает допустимый размер, навык отказывает в её передаче вместо обрезанного списка.