Обзор отчетности

API Campaign Manager 360 предоставляет несколько способов получения данных для объявлений, размещаемых через Campaign Manager 360.

Служба отчетов

Создание отчетов с помощью службы Reports включает в себя многоэтапный рабочий процесс для настройки, генерации и получения файлов отчетов (например, в формате CSV или Excel). Это стандартный путь создания отчетов для API Campaign Manager 360 и подходит для больших наборов данных, автоматизированных сценариев по расписанию или приложений, использующих файлы.

Обычно рабочий процесс состоит из следующих этапов:

  1. Определите или найдите ресурс Report (указав измерения, метрики, диапазоны дат и фильтры), который сохраняется с уникальным идентификатором отчета. См. раздел «Создание и обновление отчетов» .
  2. Для запуска генерации отчета вызовите метод reports.run . Это поставит отчет в очередь и вернет ресурс File заполнитель. См. раздел «Поиск и запуск отчетов» .
  3. Периодически проверяйте состояние ресурса File . Поскольку этот процесс выполняется асинхронно, состояние файла изначально будет PROCESSING и перейдет в REPORT_AVAILABLE после завершения. См. раздел «Поиск и запуск отчетов» .
  4. После завершения генерации отчета загрузите содержимое файла (CSV или Excel). См. раздел «Загрузка отчетов» .

Запуск отчетов синхронно

Если вам необходимо сгенерировать отчет в формате CSV или Excel для небольшого объема данных, вы можете запустить его синхронно, вызвав метод reports.run с параметром synchronous , установленным в true . API попытается сгенерировать отчет в течение короткого периода времени. Если выполнение займет больше времени, отчет автоматически будет отправлен в асинхронную очередь.

Для получения более подробной информации см. раздел «Синхронные отчеты» .

Запрос данных отчета

Используйте метод reportData.query для прямого запроса данных отчета вместо создания файла отчета.

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

Для получения более подробной информации см. раздел «Запрос данных отчета в формате JSON» .