Как подключить Метрику к DataLens

Прямое подключение Метрики в DataLens собирается за один проход: токен, счётчик, точность, воркбук, проверка датасета. При добавлении фильтра по дате в чарте фильтр Метрики сбрасывается; документация рекомендует задавать период смещением от текущей даты.

Проверьте доступ и подготовьте подключение

Перед формой подключения решите два вопроса: под какой учётной записью Яндекса вы получаете токен и есть ли у вас доступ к нужному счётчику. DataLens подключается к Метрике напрямую, и в этом режиме доступны не все аналитические функции над данными, потому что обращение идёт через API с ограниченной функциональностью Подключения^[2]. На больших объёмах API может отвечать медленнее, а при активном использовании можно превысить его лимиты Подключения^[2].

Токен — это ключ к данным счётчика. Его нельзя публиковать, пересылать в переписке или складывать в общий документ. Если токен нужен коллеге, он получает свой: вы можете указать OAuth-токен любой учётной записи Яндекса Создание подключения к Metrica^[1].

Сценарий для счётчика под другой учётной записью описан в документации: переключитесь на аккаунт с доступом к Метрике, получите токен по ссылке, при необходимости разрешите доступ приложению и скопируйте токен, затем переключитесь на аккаунт с доступом к DataLens и вставьте токен в поле OAuth-токен Создание подключения к Metrica^[1].

Ограничение по составу: подключить одновременно несколько счётчиков от разных аккаунтов невозможно Создание подключения к Metrica^[1]. Если счётчики живут в разных аккаунтах, это два отдельных подключения.

Про выгрузку через LogsAPI: раньше в DataLens была возможность подключения к Метрике с предварительной выгрузкой в ClickHouse через LogsAPI, сейчас доступно только прямое подключение Подключения^[2]. Для сырых данных Метрики документация предлагает пример кода для экспорта в ClickHouse через LogsAPI или пакет Метрика Про с передачей данных в кластер Managed Service for ClickHouse Подключения^[2]. Это отдельный маршрут, и в рамках задачи прямого подключения он не нужен.

Выберите счётчик и параметры

Перейдите на страницу создания нового подключения Создание подключения к Metrica^[1].
В разделе «Файлы и сервисы» выберите подключение Metrica Создание подключения к Metrica^[1].
В поле OAuth-токен нажмите «Получить токен» или вставьте токен вручную Создание подключения к Metrica^[1].
В поле «Счётчик» укажите один или несколько счётчиков для подключения Создание подключения к Metrica^[1]. Если подходящего счётчика в списке нет, вернитесь к разделу «Получение OAuth-токена» Создание подключения к Metrica^[1].
Задайте точность данных (сэмплирование). Точность можно изменить после создания подключения Создание подключения к Metrica^[1].

Выбранную точность можно изменить после создания подключения. Если настройка не подходит задаче отчёта, вернитесь к этому параметру. Отдельно учитывайте ограничение на одновременные запросы. Квоту на количество одновременно исполняемых запросов для одного пользователя (user_login) документация называет равной 3 Создание подключения к Metrica^[1]. Если дашборд открывают несколько человек под одним логином, они делят эту квоту между собой.

Опция «Автоматически создать дашборд, чарты и датасет» даёт каталог со стандартным набором датасетов, чартов и готовый дашборд Создание подключения к Metrica^[1]. Для проверки подключения она удобна: появляется датасет, на котором видно поля. Если нужен только источник под собственные чарты, опцию можно снять.

Сохраните подключение и проверьте данные

Нажмите «Создать подключение» Создание подключения к Metrica^[1].
Выберите воркбук, в котором сохранится подключение, или создайте новый. При старой навигации по папкам выбирается папка Создание подключения к Metrica^[1].
Нажмите «Создать», укажите название подключения и нажмите «Создать» ещё раз Создание подключения к Metrica^[1].

Дальше — проверка датасета. По умолчанию из Метрики выгружаются данные за последние 60 дней Создание подключения к Metrica^[1]. Откройте датасет над подключением и убедитесь, что строки есть и период соответствует этим 60 дням.

Здесь и находится ловушка с датой. Если в чарте добавить фильтр по дате, фильтр Метрики будет сброшен; документация рекомендует добавлять фильтр по дате как смещение относительно текущей даты Создание подключения к Metrica^[1]. Для проверки выберите относительный период, например последние 30 дней, и сверьте полученный срез с ожидаемым. Само смещение не следует считать гарантией сохранения исходного фильтра Метрики.

Доступ к результату. Подключение к Metrica API не поддерживает публичный доступ к объектам, созданным на его основе Создание подключения к Metrica^[1]. Публичную ссылку на дашборд или чарт из этого подключения не сделать. Чтобы поделиться, добавьте пользователя в организацию или облако и предоставьте ему доступ к дашборду или чарту Создание подключения к Metrica^[1]. Второй способ — выгрузить данные в кластер Managed Service for ClickHouse и подключиться к БД ClickHouse как к источнику Создание подключения к Metrica^[1].

Права на счётчик при этом не меняются: подключение работает с тем доступом, который уже есть у учётной записи, чей токен использован.

Чек-лист проверки подключения

Подключение создано и сохранено в выбранном воркбуке.
Счётчик выбран, точность задана; при необходимости её можно изменить в подключении.
В датасете видны данные за последние 60 дней.
Фильтр по дате в чарте задан смещением от текущей даты, а не фиксированным диапазоном.
Публичная ссылка не используется; доступ выдан через организацию или облако.
Токен не попал в переписку, документ или репозиторий.

Смежные задачи отчётности разобраны в материалах про когортный анализ и падение трафика в Search Console: там та же логика проверки данных до построения вывода.

Учебный пример подключения

Учебный пример

Входы примера целиком:

Параметр	Значение
Счётчик	№00000000, доступ у пользователя уже есть
Воркбук	«Маркетинг-дашборд», создаётся при подключении
Точность	выбрана пользователем при подключении
Автодашборд	включён
Период по умолчанию	последние 60 дней
Фильтр периода в чарте	смещение «последние 30 дней от сегодня»
Публикация	не используется

Проход по шагам и заполненный результат:

Шаг	Действие	Результат
1	Страница нового подключения → «Файлы и сервисы» → Metrica	Форма подключения открыта
2	OAuth-токен получен под учётной записью с доступом к счётчику №00000000	Токен вставлен в поле, в переписку не уходил
3	Счётчик №00000000 выбран	Счётчик в списке подключения
4	Точность выбрана	Значение настройки проверено; при необходимости его можно изменить
5	Автодашборд включён	Появляется датасет, чарты и дашборд
6	«Создать подключение» → воркбук «Маркетинг-дашборд» → «Создать» → название → «Создать»	Подключение сохранено в воркбуке
7	Открыт датасет над подключением	Строки за последние 60 дней на месте
8	В чарте период — смещение «последние 30 дней»	Полученный срез проверен на соответствие выбранному периоду
9	Попытка публичной ссылки	Недоступна; доступ выдаётся через организацию или облако

Проверка результата: если на шаге 7 строк нет, вернитесь к шагу 2 и проверьте, что токен получен под учётной записью с доступом именно к счётчику №00000000. Если на шаге 8 цифры не совпадают с ожидаемым срезом, проверьте, что период задан смещением, а не фиксированными датами. Условия примера — гипотеза на проверку на вашем счётчике.