Документация
Справочник разработчика
API управления
Управление клиентами Директа
API отчетов v1
Группировки
Клики
Параметры посетителей

Шаблоны

Шаблоны (preset) автоматически задают метрики и группировки, которые необходимы для того или иного отчета.

Например, чтобы получить данные для отчета по браузерам, используйте шаблон tech_browsers:

https://api-metrika.yandex.ru/stat/v1/data.csv?id=2138128&preset=tech_browsers&limit=5

Вы можете использовать шаблоны со всеми методами API.

В запросе шаблоны могут быть использованы вместе с метриками и группировками. В таком случае явно заданный параметр имеет приоритет над параметром, указанным в шаблоне.

Используйте шаблоны, чтобы сформировать отчеты Яндекс.Метрики, доступные в веб-интерфейсе:

Примеры использования шаблонов

Отчет "Источники - Сводка"

preset=sources_summary

Отчет "Источники - Сводка". Посетители из Санкт-Петербурга

preset=sources_summary

filters=ym:s:regionCityName=='Санкт-Петербург'

Данные отчета сегментированы с помощью параметра filters=ym:s:regionCity=='Санкт-Петербург'.

Отчет "Источники - Поисковые фразы"

preset=sources_search_phrases

Отчет "Технологии - Браузеры"

preset=tech_platforms

dimensions=ym:s:browser

Данный шаблон помогает формировать отчет по браузеру, который используют посетители сайта, без учета версии браузера.

где параметр dimensions=ym:s:browser задает группировку в шаблоне, по которой группируются полученные данные.