Как сформировать отчет

  1. Выполните запрос к сервису Reports.

    В HTTP-заголовке Authorization укажите OAuth-токен, полученный для пользователя, по кампаниям которого требуется получить статистику. Полный список заголовков приведен в разделе HTTP-заголовки.

    В теле запроса укажите значения основных параметров в зависимости от того, какие данные вам нужны:

    • за какой период требуется получить отчет и по каким периодам нужно агрегировать данные;

    • какой тип отчета подходит для вашей задачи;

    • какие поля (столбцы) необходимо выводить в отчете;

    • в каком виде следует выводить денежные значения;

    • какие фильтры будут использоваться для отбора данных.

    Полный список входных параметров представлен в разделе Запрос: спецификация отчета.

  2. Отчеты с небольшим количеством данных формируются в режиме онлайн. В этом случае вы сразу получите HTTP-код ответа 200, а отчет будет передан в теле ответа.

    Отчеты с большим количеством данных, а также некоторые типы отчетов формируются в режиме офлайн. В этом случае вы получите HTTP-код ответа 201.

    Подробная схема запросов и ответов приведена в разделе Онлайн- и офлайн-отчет.

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

    Если формирование отчета еще не завершено, вы получите HTTP-код ответа 202.

    Если отчет готов, вы получите HTTP-код ответа 200, а отчет будет передан в теле ответа.

Пример запроса и пример отчета представлен в разделе Пример: клики и стоимость.