Статистика Директа по API

Выгружает статистику Яндекс Директа для анализа, автоматизации и внешних дашбордов.

Что можно получить

· Статистику по кампаниям и группам объявлений за выбранный период
· Данные по дням, неделям, месяцам или суммарно
· Показы, клики, расходы, конверсии, доход и другие доступные показатели
· Несколько целей и моделей атрибуции в одной логической выгрузке

Как пользоваться

· Через скилл: опишите нужные данные обычным или точным запросом
· Через API: создавайте разовые выгрузки и расписания из своих инструментов
· PerfOps сам разбивает большую выгрузку на части и собирает единый результат

Регулярное обновление

· Расписание запускает выгрузку автоматически
· Постоянная ссылка всегда отдаёт последний успешный результат
· Ошибка новой попытки не заменяет предыдущий успешный файл

Отличие от «Отчётов Директа»

· Этот продукт предназначен для получения статистики по API и автоматического обновления данных
· «Отчёты Директа» нужны для работы с таблицей в PerfOps и массовых действий в рекламном кабинете

Документация API

Агент или ваш инструмент передаёт точный запрос. PerfOps проверяет его, показывает нормализации, сам делит работу по ограничениям Директа и возвращает один результат.

Source-session не является общим server-to-server ключом. Для внешнего дашборда создаётся отдельный ключ только для чтения последнего успешного результата одного расписания.
Cookie, пароль и source-session не передаются агенту. Право source_export:writeуправляет только выгрузками PerfOps и не даёт доступ на изменение объектов Директа.

Пример точного запроса

Передайте этот объект в POST /api/source-exports/preflight. LSC будет явно нормализована в LSCCD.

{
  "recipe": {
    "consumer": "api_client",
    "source": "direct",
    "connection_id": "dcn_example",
    "account_login": "example-account",
    "capability_id": "direct.reports.performance",
    "params": {
      "date_from": "2026-06-01",
      "date_to": "2026-07-31",
      "campaign_selector": {
        "kind": "name_filter",
        "include_mode": "any",
        "include_terms": ["search"],
        "exclude_terms": ["referral", "education", "bnp"]
      },
      "views": [
        {"id": "adgroups_monthly", "level": "adgroup", "granularity": "monthly"}
      ],
      "metrics": ["Impressions", "Clicks", "Cost", "Conversions"],
      "goal_ids": ["123456789", "987654321"],
      "attribution_models": ["LC", "LSC"]
    },
    "destination": {"kind": "object_storage", "format": "csv"},
    "request_context": {}
  }
}

Пример ежедневного полного снимка

Сначала передайте объект в POST /api/source-export-schedules/preflight, затем создайте расписание по полученному preflight_id.

{
  "recipe": {
    "consumer": "api_client",
    "source": "direct",
    "connection_id": "dcn_example",
    "account_login": "example-account",
    "capability_id": "direct.reports.performance",
    "params": {
      "date_from": "2026-01-01",
      "date_to": "{{schedule.interval_end_date_minus_1d}}",
      "campaign_selector": {"kind": "all"},
      "views": [{"id": "campaign_daily", "level": "campaign", "granularity": "daily"}],
      "metrics": ["Impressions", "Clicks", "Cost"]
    },
    "destination": {"kind": "object_storage", "format": "csv"},
    "request_context": {}
  },
  "schedule": {"kind": "daily", "time": "06:00", "timezone": "Europe/Moscow"}
}

Открыть инструкцию и скилл Все методы и схемы API

Формат результата

CSV-файл и ссылка для автоматического обновления

Как начать

Описание доступно без входа. Войдите, чтобы управлять выгрузками и расписаниями.

Войти