/yandex-metrika

Произвольные отчёты

Как построить произвольный отчёт с любыми dimensions и metrics.

Принцип

Все скрипты используют common.sh для API-вызовов. Можно легко собрать запрос вручную:

. scripts/common.sh
load_config

metrika_get_csv "/stat/v1/data.csv" "output.csv" \
  --data-urlencode "ids=COUNTER_ID" \
  --data-urlencode "date1=2025-01-01" \
  --data-urlencode "date2=2025-12-31" \
  --data-urlencode "metrics=METRICS" \
  --data-urlencode "dimensions=DIMENSIONS" \
  --data-urlencode "filters=FILTERS" \
  --data-urlencode "accuracy=1" \
  --data-urlencode "sort=-SORT_FIELD" \
  --data-urlencode "limit=100"

Примеры

Страницы входа с метриками

dimensions=ym:s:startURL
metrics=ym:s:visits,ym:s:bounceRate,ym:s:avgVisitDurationSeconds
sort=-ym:s:visits

География: города

dimensions=ym:s:regionCity
metrics=ym:s:visits,ym:s:users,ym:s:bounceRate
filters=ym:s:regionCountry=='Россия' AND ym:s:isRobot=='No'

Устройства: ОС + браузер

dimensions=ym:s:operatingSystem,ym:s:browser
metrics=ym:s:visits,ym:s:users

Реферальные источники

dimensions=ym:s:lastsignReferalSource
metrics=ym:s:visits,ym:s:users,ym:s:bounceRate
filters=ym:s:lastsignTrafficSource=='referral' AND ym:s:isRobot=='No'

Рекламные системы

dimensions=ym:s:lastsignAdvEngine
metrics=ym:s:visits,ym:s:users,ym:s:goal<ID>conversionRate
filters=ym:s:lastsignTrafficSource=='ad' AND ym:s:isRobot=='No'

JSON-запросы (drilldown и др.)

Для endpoints, не поддерживающих CSV (drilldown), используйте metrika_get напрямую:

. scripts/common.sh
load_config

RESULT=$(metrika_get "/stat/v1/data/drilldown" \
  --data-urlencode "ids=COUNTER_ID" \
  --data-urlencode "date1=2025-01-01" \
  --data-urlencode "date2=2025-12-31" \
  --data-urlencode "metrics=ym:s:visits" \
  --data-urlencode "dimensions=ym:s:startURLPathLevel1" \
  --data-urlencode "accuracy=1")

echo "$RESULT"

Результат — JSON. Парсите через grep/sed или сохраняйте в файл.

Правила

• Нельзя смешивать visit (ym:s:) и pageview (ym:pv:) префиксы в одном запросе
• Максимум ~10 dimensions и ~20 metrics в одном запросе
• Для больших выгрузок используйте limit + offset для пагинации
• bytime по умолчанию выбирает 7 значений dimension; параметр top_keys позволяет выбрать до 30. Если значений больше, используйте /stat/v1/data с фильтрами по каждому периоду отдельно
• Полный справочник: API_REFERENCE.md