Получение отчетов
В Adfox есть предзаданные отчеты (далее — fixed), которые предоставляются платформой и доступны партнерам, а также есть возможность с помощью конструктора отчетов собрать и сохранить собственный отчет в интерфейсе (далее — custom).
Получение отчета состоит из нескольких шагов.
Если отчет сохранен — fixed или custom:
-
Запросите список отчетов:
GET /api/v2/reports/list -
Получите параметры отчетов (только для
custom, дляfixedсписок полей не вернет):GET /api/v2/reports/report-info/{reportName} -
Получите доступный период:
GET /available-dates -
Отправьте запрос на формирование отчета и сохраните
result.taskId:POST /api/v2/reports/{reportName}
-
Получите и закэшируйте списки
dimensions,metrics,filtersиlimits:GET /metadata -
При необходимости получите доступные даты для отчета:
GET /available-dates -
Отправьте запрос с валидным телом и сохраните
result.taskId:POST /reports
Далее:
-
Выполняйте цикл запросов до получения одного из статусов:
SUCCESSFAILUREEXPIRED
GET /reports/{taskId} -
Используйте таймаут перед повторным запросом.
-
При статусе
SUCCESSполучите результат отчета:GET /reports/{taskId}/result