Получение готового отчета
Для получения отчета выполните запрос:
https://adfox.yandex.ru/api/report/result?taskId=<taskId>
Параметры запроса
Параметр |
Описание |
|
Идентификатор задачи на формирование запроса. |
Формат ответа
Запрос возвращает готовый отчет. Отчет формируется в формате JSON:
{
"result": {
"taskId": ()
"state": ()
"fields": [
<fieldId>,
...
],
"fieldsInfo": {
<filedId>: <fieldInfo>
},
"table": [
[
<dataRowField>,
...
],
...
],
"totals": {
<fieldId>: <totalValue>,
...
},
"eventHorizon": <eventHorizon>
},
"error": <errorCode>
}
Параметр |
Описание |
|
Готовность отчета в момент запроса:
|
|
Идентификатор поля данных. Порядок идентификаторов полей в массиве |
|
Описание содержимого поля данных. |
|
Данные отчета. |
|
Суммарное значение показателя за весь период. Заполнено не для всех полей. |
|
День отчетного периода, до которого данные отчета гарантированно полные, в формате YYYY-MM-DD hh:ii:ss. |
table
Порядок значений в массивах В ответе приходит поле fields
, в котором указан порядок значений в массивах поля table
.
Например, колонка с названием "campaign_id" приходит в fields
третьей. В таком случае в каждом массиве в table
она так же будет третьей.
Псевдокод:
// Ответ API
var response = {
...
fields: ["campaign_name", "campaign_id", "impressions_total"]
table: [
['campaign 1', 101, 1000],
['campaign 2', 102, 1000],
['campaign 3', 103, 1000]
]
...
}
// Для получения значения колонки "impressions_total" нужно узнать ее номер
var impressionsTotalColumnNumber = array_search('impressions_total', response.fields)
// Узнав номер колонки, можем получить ее значение
for (var row of response.table) {
var value = row[impressionsTotalColumnNumber]
}