GetSummaryStat

Возвращает статистику по указанным кампаниям за каждый день выбранного периода.
Для метода существует версия GetSummaryStat (Live).

Ограничения

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

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

Статистика доступна за последние три года от текущего месяца: например, 15 сентября 2016 года можно получить данные начиная с 1 сентября 2013 года.

Входные данные

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

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

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

^{Параметр}	^{Описание}	^{Требуется}
_{Объект GetSummaryStatRequest}
`CampaignIDS`	Массив, содержащий идентификаторы кампаний. Внимание Количество кампаний помноженное на количество дней в отчетном периоде не должно превышать 1000.	Да
`StartDate`	Начальная дата отчетного периода, за который возвращается статистика (`YYYY-MM-DD`).	Да
`EndDate`	Конечная дата отчетного периода, за который возвращается статистика (`YYYY-MM-DD`).	Да

Результирующие данные

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

Внимание

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

Часть возвращаемых параметров рассчитывается на основе данных Яндекс Метрики (см. раздел справки Метрика. Оценка эффективности рекламной кампании Yandex Metrica: advertising campaign efficiency evaluation).

{
   "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)
      }
      ...
   ]
}

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

^{Параметр}	^{Описание}
_{Объект StatItem}
`CampaignID`	Идентификатор кампании.
`StatDate`	Дата, за которую приведена статистика.
`SumSearch`	Стоимость кликов на поиске.
`SumContext`	Стоимость кликов в Рекламной сети Яндекса.
`ShowsSearch`	Количество показов на поиске.
`ShowsContext`	Количество показов в Рекламной сети Яндекса.
`ClicksSearch`	Количество кликов на поиске.
`ClicksContext`	Количество кликов в Рекламной сети Яндекса.
`SessionDepthSearch`	Глубина просмотра сайта при переходе с поиска. Берется по данным Яндекс Метрики и если на поиске применяется автоматическая стратегия CPAOptimizer.
`SessionDepthContext`	Глубина просмотра сайта при переходе из Рекламной сети Яндекса. Берется по данным Яндекс Метрики и если в Рекламной сети применяется автоматическая стратегия CPAOptimizer.
`GoalConversionSearch`	Доля целевых визитов в общем числе визитов при переходе с поиска, в процентах. Берется по данным Яндекс Метрики и если на поиске применяется автоматическая стратегия CPAOptimizer.
`GoalConversionContext`	Доля целевых визитов в общем числе визитов при переходе из Рекламной сети Яндекса, в процентах. Берется по данным Яндекс Метрики и если в Рекламной сети применяется автоматическая стратегия CPAOptimizer.
`GoalCostSearch`	Цена достижения цели цели Яндекс Метрики при переходе с поиска. Берется по данным Яндекс Метрики и если на поиске применяется автоматическая стратегия CPAOptimizer.
`GoalCostContext`	Цена достижения цели цели Яндекс Метрики при переходе из Рекламной сети Яндекса. Берется по данным Яндекс Метрики и если в Рекламной сети применяется автоматическая стратегия CPAOptimizer.

Примеры входных данных

Python

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

PHP

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

Perl

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

Была ли статья полезна?

GetBannersStat (Live)

GetSummaryStat (Live)