---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.1
alternate:
  - https://yandex.com/dev/adfox/doc/en/statistics/how-to.md
  - https://yandex.com/dev/adfox/doc/ru/statistics/how-to.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/adfox/doc/ru/llms.txt

# Формирование отчета

## Как сформировать отчет {#how-to}

1. Для авторизации в API Статистики используйте токен, который вы получили для API Adfox. Если у вас еще нет токена, [получите его](https://yandex.com/dev/adfox/doc/ru/v.1/authorization.md#token).
    
1. В HTTP-заголовке `Authorization` передавайте полученный OAuth-токен при каждом запросе. 

    ```no-highlight
    curl -H 'Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037' https://adfox.yandex.ru/api/report/list/owner
    ```
    
1. Выберите [уровень детализации отчета](#level) в главе ниже. С помощью [методов](https://yandex.com/dev/adfox/doc/ru/statistics/methods.md) узнайте, какой набор отчетов доступен для выбранного уровня детализации, какие аргументы необходимо передать для получения отчета, допустимые периоды формирования отчета. Полный список аргументов представлен в главе [Аргументы для построения отчета](#arguments).

1. Выполните [запрос](https://yandex.com/dev/adfox/doc/ru/statistics/methods/report-request.md) на формирование отчета. Одновременно в работе могут находиться не больше 3 отчетов.
    
1. Выполните [запрос](https://yandex.com/dev/adfox/doc/ru/statistics/methods/get-report.md) на получение готового отчета. Если отчет еще не готов, в ответе вы получите соответствующий статус.

## Уровень детализации {#level}

<!-- source: ru/_includes/statistics.md -->
Доступные уровни детализации:

- `owner` — общий отчет;
- `supercampaign` — на уровне суперкампании;
- `campaign` — на уровне кампании;
- `banner` — на уровне баннера;
- `site` — на уровне сайта;
- `section` — на уровне раздела;
- `place` — на уровне рекламного места.
<!-- endsource: ru/_includes/statistics.md -->

## Аргументы для построения отчета {#arguments}

Ниже перечислены все возможные аргументы для построения отчетов. В зависимости от выбранного отчета, в запросе потребуется передать определенный набор аргументов. Чтобы узнать, какие из аргументы потребуются для выбранного отчета, используйте [метод](https://yandex.com/dev/adfox/doc/ru/statistics/methods/report-arguments.md).

- `supercampaignId` — ID суперкампании;
- `campaignId` — ID кампании;
- `bannerId` — ID баннера;
- `siteId` — ID сайта;
- `sectionId` — ID раздела;
- `placeId` — ID рекламного места;
- `categoryId` — ID категории;
- `criteriaId` — ID пользовательской метрики;
- `criteria2Id` — ID пользовательской метрики;
- `name` — название отчета;
- `dateFrom` — начальная дата отчетного периода, `YYYY-MM-DD`;
- `dateTo` — конечная дата отчетного периода, `YYYY-MM-DD`;
- `day` — день, отчет за который необходимо представить, `YYYY-MM-DD`;
- `ownerId` — ID владельца аккаунта. Аргумент доступен только для владельцев площадок и рекламодателей.


{% note info %}

Чтобы построить отчет по нескольким объектам, передайте список ID в виде массива JSON. Например, для сайтов: `siteId=[1,2,3]`.

{% endnote %}