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

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

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

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

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

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

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'

Ответ:

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

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

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

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

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

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

Ответ:

{
  "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.

Предыдущая
Коды ошибок