MCP для AI-агентов

ER и сохранения

ER = 100 × (likes + comments) / views, с округлением до двух знаков. Он считается по последним полным наблюдениям просмотров, лайков и комментариев. Итог использует суммы этих счётчиков, а не среднее процентов постов. При нулевых просмотрах или отсутствии полного наблюдения ER равен null. Сохранения и репосты в формулу не входят.

Список и карточка кампании, её аналитика, посты и креаторы возвращают engagement со scope: accepted_video. В расчёт входят только принятые видеопосты; в строке поста — только этот пост, в строке креатора — его аккаунт. Для знаменателя используйте engagement.views: прежний totalViews может включать другие статусы или отражать оплаченные просмотры.

В фабриках канонический ER находится в metrics.er (в сводке — totals.er), сохранения — в metrics.saves. Те же поля доступны в точках истории и snapshotBaseline. Прежнее верхнеуровневое er сохраняет старую семантику; новые клиенты используют вложенное поле. Отсутствие новых полей в старом ответе не подтверждает измерение.

saves — отдельный последний известный счётчик. Автоматические источники: TikTok collectCount и X bookmarkCount, только когда поставщик вернул корректное значение. На остальных платформах он недоступен без фактического измерения. 0 означает измеренный ноль, null — отсутствие данных. Не подменяйте null нулём. Старая история кампаний не доказывает исходное число просмотров: новый ER появится после обычного скана, без массового платного перескана.

erCoverage и savesCoverage содержат measuredPosts / totalPosts для всей выбранной выборки до пагинации. Частичное покрытие означает частичный итог. updatedAt и savesUpdatedAt — самое раннее время включённого измерения; null означает неизвестную свежесть. Перенос старого счётчика в новый снимок не обновляет его время. ER и сохранения на графиках — абсолютные снимки, без режима прироста.

В hiddenFields отчёта можно передать saves: сервер уберёт число, покрытие и время измерения. Скрытие views, likes, comments или er также убирает зависимый ER; скрытие posts — покрытие, lastScanned — время измерения. Эти правила действуют для сводок, строк, истории и baseline.

{
  "engagement": {
    "scope": "accepted_video",
    "views": 100,
    "likes": 0,
    "comments": 0,
    "er": 0,
    "saves": null,
    "erCoverage": { "measuredPosts": 1, "totalPosts": 2 },
    "savesCoverage": { "measuredPosts": 0, "totalPosts": 2 },
    "updatedAt": "2026-10-09T08:00:00.000Z",
    "savesUpdatedAt": null
  }
}