Сортировка

Сортировка определяет порядок строк в результирующей таблице отчёта. Поддерживается сортировка по одному или нескольким полям.

Базовый синтаксис

Сортировка задаётся массивом объектов в параметре sorting:

{
  "sorting": [
    {"field": "cost", "direction": "desc"},
    {"field": "campaign_name", "direction": "asc"}
  ]
}

Параметры сортировки

Параметр	Тип	Описание
field	строка	Имя поля: измерение или метрика
direction	строка	Направление: asc (по возрастанию) или desc (по убыванию)

Направления

Направление	Поведение для чисел	Поведение для строк	Поведение для дат
asc	От меньшего к большему	А → Я, a → z	От ранних к поздним
desc	От большего к меньшему	Я → А, z → a	От поздних к ранним

Множественная сортировка

При указании нескольких полей сортировка применяется последовательно:

{
  "sorting": [
    {"field": "date", "direction": "desc"},
    {"field": "cost", "direction": "desc"}
  ]
}

Сначала строки сортируются по дате (новые сверху), затем внутри одинаковых дат — по расходу (большие сверху).

Сортировка по умолчанию

Если sorting не указан, применяется сортировка по умолчанию:

• Если есть измерение date: по дате desc
• Если есть измерения без даты: по первому измерению asc
• Если нет измерений: без сортировки (порядок из источника)

Особые случаи

NULL-значения

NULL-значения всегда в конце списка независимо от направления сортировки:

• asc: значения → NULL
• desc: значения → NULL

Вычисляемые метрики

Сортировка по вычисляемым метрикам поддерживается:

{
  "calculated_metrics": [
    {"name": "cpl", "formula": "[cost] / [leads]"}
  ],
  "sorting": [
    {"field": "cpl", "direction": "asc"}
  ]
}

Денежные значения

Сортировка по денежным метрикам (money) выполняется по числовому значению в валюте источника, а не по отформатированной строке.

Чувствительность к регистру

Сортировка строк регистронезависима: "А" и "а" считаются одинаковыми.

Ограничения

• Максимум 3 поля сортировки в одном отчёте
• Нельзя сортировать по полям, не включённым в отчёт

Связанные страницы

• Операторы фильтров
• Параметры
• Измерения