Обработка результатов

Обработка ответа на отчет не является тривиальной задачей, особенно если вы хотите, чтобы ваше решение было гибким и независимым от фактических параметров и показателей, которые вы выбрали в своем отчете.

К счастью, ответ на отчет довольно полный и включает много полезной информации.

Заголовки

Вы можете использовать информацию, возвращаемую в заголовках, чтобы выбрать способ форматирования определенной метрики. Он включает информацию о том, что это за показатель, например, валюта, коэффициент или итоговый показатель, и в какой валюте он находится, если это денежная стоимость.

Пример:

"headers": [
  { "name": "MONTH", "type": "DIMENSION" },
  { "name": "CLICKS", "type": "METRIC_TALLY" },
  { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" },
  { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" }
]

Строки

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

"rows": [
  { "cells":
    [ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
    [ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
  }
]

Итоги и средние значения

При запуске отчета вы также получаете массивы totals и averages , которые будут содержать значения для каждой соответствующей метрики.

"totals": {
  "cells": [
    {}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
  ]
},
"averages": {
  "cells": [
    {}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
  ]
}

Даты начала и окончания

Если вы используете относительные даты , иногда может быть полезно узнать, каковы рассчитанные даты начала и окончания. 

"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}

Следующие шаги