---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/reference/GetSummaryStat.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetSummaryStat.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# GetSummaryStat
Возвращает статистику по указанным кампаниям за каждый день выбранного периода.
Для метода существует версия [GetSummaryStat (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/GetSummaryStat.html).

## Ограничения {#restrictions}

Для одной кампании возможно до 100 вызовов метода в сутки.

Количество запрошенных кампаний, помноженное на количество дней в выбранном периоде, не должно превышать 1000.

<!-- source: ru/reference/_includes/live/GetBannersStat/id-GetBannersStat/stat3years.md -->
Статистика доступна за последние три года от текущего месяца: например, 15 сентября 2016 года можно получить данные начиная с 1 сентября 2013 года.
<!-- endsource: ru/reference/_includes/live/GetBannersStat/id-GetBannersStat/stat3years.md -->



## Входные данные {#input}

Ниже показана структура входных данных в формате JSON.

```javascript
{
   "method": "GetSummaryStat",
   "param": {
      /* GetSummaryStatRequest */
      "CampaignIDS": [
         (int)
         ...
      ],
      "StartDate": (date),
      "EndDate": (date)
   }
}
```

Ниже приведено описание параметров.


#|
||
**<sup >Параметр</sup>**
|
**<sup >Описание</sup>**
|
**<sup >Требуется</sup>**
||

||
**<sub >Объект GetSummaryStatRequest</sub>**
||
||
`CampaignIDS`
|
Массив, содержащий идентификаторы кампаний.


{% note alert %}

Количество кампаний помноженное на количество дней в отчетном периоде не должно превышать 1000.

{% endnote %}
|
Да
||
||
`StartDate`
|
Начальная дата отчетного периода, за который возвращается статистика (`YYYY-MM-DD`).
|
Да
||
||
`EndDate`
|
Конечная дата отчетного периода, за который возвращается статистика (`YYYY-MM-DD`).
|
Да
||
|#


## Результирующие данные {#output}

Метод возвращает массив объектов `StatItem`. Каждый объект содержит статистику по одной кампании за одну дату выбранного периода.


{% note alert %}

Если по запрошенной кампании не было показов за весь период, сведения о кампании не выводятся в ответ.

{% endnote %}


Часть возвращаемых параметров рассчитывается на основе данных Яндекс Метрики (см. раздел справки [Метрика. Оценка эффективности рекламной кампании](https://yandex.ru/support/direct/statistics/metrika.xml)[Yandex Metrica: advertising campaign efficiency evaluation](https://yandex.com/support/direct/statistics/metrika.xml)).

```javascript
{
   "data": [
      {  /* StatItem */
         "CampaignID": (int),
         "StatDate": (date),
         "SumSearch": (float),
         "SumContext": (float),
         "ShowsSearch": (int),
         "ShowsContext": (int),
         "ClicksSearch": (int),
         "ClicksContext": (int),
         "SessionDepthSearch": (float),
         "SessionDepthContext": (float),
         "GoalConversionSearch": (float),
         "GoalConversionContext": (float),
         "GoalCostSearch": (float),
         "GoalCostContext": (float)
      }
      ...
   ]
}
```

Ниже приведено описание параметров.


#|
||
**<sup >Параметр</sup>**
|
**<sup >Описание</sup>**
||

||
**<sub >Объект StatItem</sub>**
||
||
`CampaignID`
|
Идентификатор кампании.
||
||
`StatDate`
|
Дата, за которую приведена статистика.
||
||
`SumSearch`
|
Стоимость кликов на поиске.
||
||
`SumContext`
|
Стоимость кликов в Рекламной сети Яндекса.
||
||
`ShowsSearch`
|
Количество показов на поиске.
||
||
`ShowsContext`
|
Количество показов в Рекламной сети Яндекса.
||
||
`ClicksSearch`
|
Количество кликов на поиске.
||
||
`ClicksContext`
|
Количество кликов в Рекламной сети Яндекса.
||
||
`SessionDepthSearch`
|
Глубина просмотра сайта при переходе с поиска.

Берется по данным Яндекс Метрики и если на поиске применяется автоматическая стратегия CPAOptimizer.
||
||
`SessionDepthContext`
|
Глубина просмотра сайта при переходе из Рекламной сети Яндекса.

Берется по данным Яндекс Метрики и если в Рекламной сети применяется автоматическая стратегия CPAOptimizer.
||
||
`GoalConversionSearch`
|
Доля целевых визитов в общем числе визитов при переходе с поиска, в процентах.

Берется по данным Яндекс Метрики и если на поиске применяется автоматическая стратегия CPAOptimizer.
||
||
`GoalConversionContext`
|
Доля целевых визитов в общем числе визитов при переходе из Рекламной сети Яндекса, в процентах.

Берется по данным Яндекс Метрики и если в Рекламной сети применяется автоматическая стратегия CPAOptimizer.
||
||
`GoalCostSearch`
|
Цена достижения [цели](https://yandex.ru/support/metrika/general/goals.xml)[цели](https://yandex.com/support/metrica/general/goals.xml) Яндекс Метрики при переходе с поиска.

Берется по данным Яндекс Метрики и если на поиске применяется автоматическая стратегия CPAOptimizer.
||
||
`GoalCostContext`
|
Цена достижения [цели](https://yandex.ru/support/metrika/general/goals.xml)[цели](https://yandex.com/support/metrica/general/goals.xml) Яндекс Метрики при переходе из Рекламной сети Яндекса.

Берется по данным Яндекс Метрики и если в Рекламной сети применяется автоматическая стратегия CPAOptimizer.
||
|#


## Примеры входных данных {#examples}

## Python

```python
{
   'CampaignIDS': [238456],
   'StartDate': '2011-05-14',
   'EndDate': '2011-05-19'
}
```

## PHP

```php
array(
   'CampaignIDS' => array(238456),
   'StartDate' => '2011-05-14',
   'EndDate' ='2011-05-19'
)
```

## Perl

```perl
{
   'CampaignIDS' => [238456],
   'StartDate' => '2011-05-14',
   'EndDate' ='2011-05-19'
}
```