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

# Пример. Отчет по кампании

Разберем полный сценарий: получить статистику по кампании `12345` за январь 2024 года — показы, клики и CTR по дням.

## Шаг 1. Получить метаданные

```
curl -H 'Authorization: OAuth <токен>' \
  'https://adfox.yandex.ru/api/v2/reports/metadata?ownerId=67890'
```

В ответе находим нужные `name` у метрик и измерений.

## Шаг 2. Создать задачу

```bash
curl -X POST \
  -H 'Authorization: OAuth <токен>' \
  -H 'Content-Type: application/json' \
  -d '{
    "metrics": ["loads_commercial", "clicks_total", "ctr"],
    "dimensions": ["date"],
    "dateRange": { "from": "2024-01-01", "to": "2024-01-31" },
    "filters": [
      { "field": "campaign_id", "operator": "eq", "value": "12345" }
    ],
    "ownerId": 67890
  }' \
  'https://adfox.yandex.ru/api/v2/reports'
```

Ответ:

```json
{
  "result": {
    "taskId": "umr-a-rsr-b5555555-5555-5555-5555-555555555501",
    "status": "PENDING"
  }
}
```

## Шаг 3. Проверить статус

```bash 
curl -H 'Authorization: OAuth <токен>' \
  'https://adfox.yandex.ru/api/v2/reports/umr-a-rsr-b5555555-5555-5555-5555-555555555501'
```

Повторяйте запрос до получения статуса `SUCCESS`.

## Шаг 4. Получить результат

```bash
curl -H 'Authorization: OAuth <токен>' \
  'https://adfox.yandex.ru/api/v2/reports/umr-a-rsr-b5555555-5555-5555-5555-555555555501/result'
```

Ответ:

```json
{
  "result": {
    "taskId": "umr-a-rsr-b5555555-5555-5555-5555-555555555501",
    "columns": [
      { "name": "date", "type": "string" },
      { "name": "loads_commercial", "type": "integer" },
      { "name": "clicks_total", "type": "integer" },
      { "name": "ctr", "type": "number", "format": "float", "unit": "percent" }
    ],
    "rows": [
      ["2024-01-01", 15000, 225, 1.5],
      ["2024-01-02", 18000, 270, 1.5]
    ],
    "totals": [null, 33000, 495, null]
  }
}
```

Порядок значений в каждой строке `rows` соответствует порядку колонок в `columns`.