Статистика групп объявлений
group_statsRetrieve daily and total performance metrics—views, clicks, CTR, spend, CPM, CPC, video quartiles—for specified ad groups within one Avito Ads campaign over a date range up to 100 days.
Instructions
Статистика по перечисленным группам одной кампании: плоский массив, по записи на группу объявлений ({id, name, paymentModel, campaignType, data[] по дням, totalData за период}). Метрики те же, что у campaign_stats — views (показы), clicks (клики), ctr, spend (расход), spendBonus, cpm, cpc, квартили видео, vtr, — деньги в рублях. Поле groupIds обязательно: инструмент сужает выборку, а не перечисляет её. Период включает обе границы, формат YYYY-MM-DD, длительность не больше 100 дней. Итогов по кампании не возвращает; чтобы охватить все группы кампании, есть campaign_stats с той же разбивкой. Тратит недельные баллы API; apiPointBalance в ответе — остаток до пополнения квоты в понедельник в 00:00 UTC, поэтому один широкий период предпочтительнее многих узких вызовов.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"campaignId": "<campaignId>",
"dateFrom": "<dateFrom>",
"dateTo": "<dateTo>",
"groupIds": "<groupIds>"
},
"name": "group_stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dateTo | Yes | Последний день периода, включительно (YYYY-MM-DD). Должен быть >= dateFrom, а период — не длиннее 100 дней. | |
| dateFrom | Yes | Первый день периода, включительно (YYYY-MM-DD). | |
| groupIds | Yes | Id групп объявлений для отчёта, например [101, 102]. Обязательное поле; id даёт list_groups, а по всей кампании отчитывается campaign_stats. | |
| campaignId | Yes | Кампания, группы которой попадают в отчёт. Id можно найти через list_campaigns. |