Статистика
get_statisticsRetrieves Yandex Direct performance reports with configurable report type, date range, filters, fields, and goals; returns aggregated metrics by default for campaign, ad, and search-query analysis.
Instructions
Запрашивает отчёт по эффективности через сервис Reports Яндекс Директа. По умолчанию отчёт АГРЕГИРОВАН за весь период (одна строка на объект) — добавлять "Date" в fieldNames только для динамики по дням или вопросов о трендах. Почасовой статистики в Reports нет: минимум — сутки, внутридневную динамику дают только повторные снимки TODAY. Готового ROAS нет — считать Revenue / Cost; GoalsRoi — это ROI ((Revenue − Cost) / Cost), не ROAS. Revenue, Profit, GoalsRoi и конверсии заполняются только по целям Метрики с ценностью. ALL_TIME без фильтра по кампаниям отклоняется для отчётов SEARCH_QUERY/CRITERIA: нужно передать campaignIds или ограниченный период. SEARCH_QUERY_PERFORMANCE_REPORT возвращает не сырые строки, а ВЫЧИСЛЕННУЮ СВОДКУ (итоги по ВСЕМ строкам + детализация top-N + свёртка хвоста + количество строк без кликов и без конверсий); её форму задают sortBy/topN/minCost/queryContains/zeroClicksOnly/zeroConversionsOnly, а для подсчётов по конверсиям нужно добавить Conversions в fieldNames. Остальные типы отчётов возвращают строки, разделённые табуляцией (без заголовка).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topN | No | Максимум строк детализации в сводке (на сервере ограничено 100). По умолчанию 50. | |
| goals | No | Id целей Яндекс Метрики (не более 10). Без них Conversions и Revenue считаются по всем целям кампании; с ними колонки приходят как <поле>_<idЦели>_<модель> (по одной на цель × модель). Для SEARCH_QUERY_PERFORMANCE_REPORT — только одна цель и одна модель. | |
| order | No | Порядок сортировки строк детализации. По умолчанию desc. | |
| dateTo | No | Дата окончания YYYY-MM-DD (обязательна для CUSTOM_DATE). | |
| sortBy | No | Метрика для ранжирования строк детализации. По умолчанию Cost. | |
| filters | No | Произвольные условия SelectionCriteria.Filter, складываются с campaignIds по И. Например Clicks GREATER_THAN 0 или Device EQUALS MOBILE. | |
| minCost | No | Включать в детализацию только строки с Cost >= этого значения. | |
| dateFrom | No | Дата начала YYYY-MM-DD (обязательна для CUSTOM_DATE). | |
| fieldNames | No | Колонки отчёта (должны быть допустимы для его типа). Сверх базовых метрик: Conversions, ConversionRate, CostPerConversion, Revenue, Profit, GoalsRoi. Разрезы CUSTOM_REPORT: Date, Device, Age, Gender, LocationOfPresenceName, Placement, AdNetworkType, Slot и др. | |
| includeVat | No | Включать ли НДС в расход. По умолчанию true. | |
| reportType | No | Тип отчёта. По умолчанию CAMPAIGN_PERFORMANCE_REPORT. | |
| campaignIds | No | Ограничить отчёт этими id кампаний. | |
| client_login | No | Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена. | |
| dateRangeType | No | Предустановленный период. Если заданы dateFrom/dateTo, подставляется CUSTOM_DATE. | |
| queryContains | No | Включать только строки, где запрос или условие содержит эту подстроку (без учёта регистра). | |
| zeroClicksOnly | No | Включать в детализацию только строки с 0 кликов. | |
| attributionModels | No | Модели атрибуции для конверсий по целям из goals; без goals не применяются (API их тогда не принимает). По умолчанию LC (последний переход). | |
| zeroConversionsOnly | No | Только строки с clicks>0 и 0 конверсий (нужно Conversions в fieldNames). |