Статистика
get_statisticsRetrieves Yandex Direct performance reports with configurable metrics, date ranges, filters, and campaign breakdowns; supports period comparisons for analyzing ad efficiency.
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. Остальные типы отчётов возвращают строки, разделённые табуляцией (без заголовка). compareTo — сравнение двух периодов: инструмент запускает ДВЕ задачи Reports (текущий период dateFrom/dateTo и compareTo) и возвращает JSON, где строки сопоставлены по разрезам отчёта (matchKey; название кампании или группы не учитывается, если запрошен её id — переименование не ломает сопоставление), с current, previous, delta и deltaPct по каждой метрике. Это только значения Яндекса и их разность: вклад факторов (расход = показы × CTR × CPC) инструмент не считает — при объяснении изменений считать по колонкам ответа и называть порядок факторов. Последние ~3 дня статистики Яндекс может пересчитать.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_statistics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topN | No | Максимум строк детализации в сводке (на сервере ограничено 100). По умолчанию 50. | |
| goals | No | Id целей Яндекс Метрики (не более 10). Без них Conversions и Revenue считаются по всем целям кампании; с ними колонки приходят как <поле>_<idЦели>_<модель> (по одной на цель × модель). Для SEARCH_QUERY_PERFORMANCE_REPORT и compareTo сводка разбирает только одну цель и одну модель (ограничение инструмента, не API). | |
| 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). | |
| compareTo | No | Период, с которым сравнить текущий (dateFrom/dateTo, обязательны). Лучше той же длины. Не для SEARCH_QUERY_PERFORMANCE_REPORT и не с Date/Week/Month/Quarter/Year в fieldNames. sortBy задаёт сортировку по |delta|, topN — сколько строк показать. | |
| 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). |