Допустимые периоды отчетов
Примечание
Срок хранения данных для отчетов — 3 года.
Чтобы узнать допустимые периоды для построения отчета, потребуется выполнить 2 запроса.
-
С помощью первого запроса необходимо узнать, какие параметры влияют на период для выбранного уровня детализации отчета:
https://adfox.yandex.ru/api/report/date/argument/list/<level>
Параметры запроса
Параметр
Описание
level
Уровень детализации отчета.
Формат ответа
Ответ представляет собой массив из названий параметров.
Пример ответа
{ "result": [ "supercampaignId" ], "error": null }
-
Полученные параметры нужно передать во второй запрос, чтобы получить допустимые периоды:
https://adfox.yandex.ru/api/report/date/interval/<level>?<arguments>
Параметры запроса
Параметр
Описание
level
Уровень детализации отчета.
arguments
Параметры, полученные в результате первого вопроса со значениями.
Формат ответа
{ "result": { "dateFrom": (string) "dateTo": (string) }, "error": (string) }
Параметр
Описание
dateFrom
Дата в формате YYYY-MM-DD, начиная с которой можно строить отчет.
dateTo
Дата в формате YYYY-MM-DD, до которой накоплены данные для построения отчета.
Пример запроса
https://adfox.yandex.ru/api/report/date/interval/owner?name=devicesTypes
Пример ответа
{ "result": { "dateFrom": "2019-07-09", "dateTo": "2022-04-17" }, "error": null }
Уровень детализации
Доступные уровни детализации:
-
owner — общий отчет;
-
supercampaign — на уровне суперкампании;
-
campaign — на уровне кампании;
-
banner — на уровне баннера;
-
site — на уровне сайта;
-
section — на уровне раздела;
-
place — на уровне рекламного места.