Как читать отчёты
Обновлено
Счётчик и период
Для работы с конкретным счётчиком используется counter_id. Если его нет, плагин берёт «Счётчик по умолчанию». Список счётчиков получают через metrika_get_counters; ему номер не нужен.
Отчётные инструменты принимают date1 и date2: даты YYYY-MM-DD или выражения Метрики, например today, yesterday, 7daysAgo. Без дат плагин подставляет сегодня и дату на 29 дней раньше — получается 30 календарных дней с текущим включительно. Эти явные даты вычисляются на сервере PHP. Часовой пояс самого счётчика показывает metrika_get_counter_info.
Для сравнения конкретных календарных периодов лучше передавать обе границы явно:
Покажи посещаемость с 2026-09-01 по 2026-09-30,
затем сравни её с периодом с 2026-08-01 по 2026-08-31.В сводках посещаемости и продаж compare по умолчанию включён. Автоматический предыдущий период имеет такую же длину, как текущий, и заканчивается накануне его начала. Для календарных месяцев разной длины используйте явное сравнение через metrika_query. compare: false отключает дополнительный запрос.
Если даты не удаётся разобрать для расчёта предыдущего периода или конец раньше начала, автоматическое сравнение не строится. Относительные даты для гарантированного сравнения заменяйте явными.
В ответе агента показаны показатели двух периодов, их изменения и таблица источников трафика.
Достоверность и количество строк
Отчёты содержат блок sampling:
| Поле | Значение |
|---|---|
sampled |
Применялась ли выборка. При true числа приблизительны. |
sample_share |
Доля данных, использованная для расчёта; 1 означает всю выборку данных. |
note |
Пояснение, добавляемое при выборке. |
Чтобы запросить полный расчёт, используйте accuracy: "full". Он может выполняться дольше. Также поддерживается строка с долей выборки от 0.01 до 1; без параметра точность выбирает Метрика. Сокращение периода — ещё один способ уменьшить объём расчёта.
В инструментах с постраничным выводом limit обычно равен 20, максимум — 1000 строк. offset начинается с 1. Для metrika_query фактический лимит без аргумента — 50. Запрашивайте нужные значения явно при обходе большого отчёта.
Обычные таблицы возвращают rows, totals и total_rows: последние два поля означают итоги и число строк отчёта, а не только полученной страницы. В динамике по времени возвращаются points. Итоги динамики запрашиваются отдельно; если этот дополнительный запрос не удался, totals может быть пустым. Доли, средние и уникальных посетителей не следует самостоятельно суммировать по точкам времени.
Атрибуция и разные виды отчётов
Отчёты по источникам зависят от «Модели атрибуции». Параметр attribution позволяет выбрать lastsign, last или first для конкретного вызова. При сравнении с интерфейсом Метрики сверяйте счётчик, период, атрибуцию и выборку.
Популярные страницы считаются по просмотрам (ym:pv:*), страницы входа — по визитам (ym:s:*). Они отвечают на разные вопросы. Не смешивайте эти пространства в одном произвольном запросе.
Демография определяется не для всех посетителей. Сумма визитов по полу или возрасту может быть меньше общего числа визитов.
Как рассчитываются продажи
Источником служит электронная коммерция Яндекс.Метрики.
| Показатель | Расчёт в плагине |
|---|---|
average_check |
Выручка / число покупок; при отсутствии покупок — 0. |
purchase_rate |
Число покупок / число визитов × 100; при отсутствии визитов — 0. Это именно отношение покупок к визитам. |
abandoned_quantity |
Добавленное в корзину количество товара минус купленное; отрицательный результат заменяется нулём. |
abandonment_rate |
(Добавленное количество − купленное) / добавленное × 100. Если добавлений нет — null. |
«Брошенные корзины» — расчёт по количеству товаров за период, а не список отдельных корзин или покупателей. Если купленных единиц больше добавленных, процент может оказаться отрицательным: в коде ограничено только abandoned_quantity.
Флаг ecommerce_in_code в информации о счётчике показывает включение слоя данных в коде счётчика. Он не подтверждает поступление заказов. При отсутствии данных API может вернуть bad_request с текстом ecommerce is not enabled.
Произвольный отчёт для разработчика
metrika_query требует metrics. Имена метрик и измерений передаются строками через запятую. Схема описывает до 20 метрик за запрос; совместимость полей и ограничения проверяет API Метрики.
| Параметр | Назначение |
|---|---|
metrics |
Обязательная строка метрик, например ym:s:visits,ym:s:users. |
dimensions |
Измерения для разбивки; без них запрашиваются итоги. |
filters |
Выражение отбора данных, например ym:s:isNewUser=='Yes'. Можно использовать expression из metrika_get_segments. |
sort |
Сортировка; по умолчанию по первой метрике по убыванию. В сравнении не отправляется. |
report_form |
table (по умолчанию), bytime, drilldown, comparison. |
group |
Для bytime: day (по умолчанию), week, month. |
date1_b, date2_b |
Границы второго периода для comparison. Укажите обе или ни одной — тогда берётся предыдущий период той же длины. |
filters_b |
Фильтр второго сегмента для comparison; filters описывает первый сегмент. Для сравнения сегментов в одном периоде задайте второму периоду те же даты. |
currency |
Валюта денежных метрик, иначе используется настройка плагина. |
counter_id, date1, date2, limit, offset, accuracy |
Счётчик, период, постраничность и точность, описанные выше. |
drilldown выбирает одноимённый ресурс API. Отдельного параметра для передачи пути углубления в схеме инструмента нет.
Примеры ниже показывают имя инструмента и объект его аргументов; это не команда PHP или CLI.
metrika_query
{
"metrics": "ym:s:visits,ym:s:users",
"dimensions": "ym:s:regionCity",
"date1": "2026-09-01",
"date2": "2026-09-30",
"limit": 20,
"accuracy": "full"
}Сравнение двух периодов:
metrika_query
{
"metrics": "ym:s:visits",
"dimensions": "ym:s:isNewUser",
"report_form": "comparison",
"date1": "2026-09-01",
"date2": "2026-09-30",
"date1_b": "2026-08-01",
"date2_b": "2026-08-31"
}В строках сравнения суффиксы _a и _b относятся к первому и второму наборам данных, _delta — к изменению A относительно B в процентах. При нулевой базе изменение возвращается как null. Имена метрик в ответе сокращаются: ym:s:visits становится visits.