Новый режим отладки в Яндекс Тег Менеджере

20 ноября 2025 года в Яндекс Тег Менеджере появился «полноценный» режим предварительного просмотра. О том, что из себя представляет новая панель отладки и как ее использовать, подробно разберем в этом руководстве.

Режим отладки Яндекс Тег Менеджера все еще находится в разработке, поэтому его возможности со временем могут изменяться. Из-за этого некоторые разделы данного руководства со временем могут стать устаревшими. Я буду стараться своевременно обновлять материал и сообщать вам о всех изменениях.

Видео на Rutube:

Видео на YouTube:

Введение

Как вы знаете, 10 июня 2025 года Яндекс анонсировал Яндекс Тег Менеджер, представив нам бета-версию своего нового продукта. Одним из самых важных функционалов в ЯТМ (да и вообще в любой системе управления тегами, например, Google Tag Manager) является режим предварительного просмотра (режим отладки, он же дебаггер). С его помощью можно проверить, насколько правильно настроены теги, триггеры и переменные, перед публикацией контейнера, выявить проблемы на этапе тестов и снизить риск их появления в будущем.

В Яндекс Тег Менеджере он располагается в правом верхнем углу (рядом с кнопкой публикации контейнера):

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

Например:

• шаблон тега Мини дебагер триггеров и переменных;
• отладка с помощью _ym_debug=2 (в Яндекс Метрике есть свой собственный отладчик. Он помогает проверить, какие данные собирает счетчик Метрики, а так же правильно ли отслеживаются цели, события электронной коммерции и данные по контентной аналитике).

Подробно об этих способах я писал в этой публикации.

С момента релиза Тег Менеджера прошло около 5,5 месяцев, и теперь в режиме предварительного просмотра стала доступна панель отладки. Когда вы запускаете Предварительный просмотр, открывается всплывающее окно, где можно указать конкретную страницу сайта для проверки настроенных отслеживаний:

Каждый раз, когда вы будете вносить какие-то изменения в контейнере ЯТМ, а затем открывать предварительный просмотр, Тег Менеджер будет просить вас указывать ссылку.

Нажав кнопку Опубликовать, дождитесь компиляции ссылки. Как только это произойдет, нажмите на кнопку Открыть предварительный просмотр:

Небольшой лайфхак: что бы не ждать, пока прогрузиться всплывающее окно с ссылкой на предварительный просмотр, обновите страницу с Яндекс Тег Менеджером в браузере, ссылка сгенерируется быстрее.

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

Нажмите на значок Тег Менеджера внизу страницы, чтобы открыть панель дебаггера:

Работая с _ym_debug=2 от Яндекс Метрики и режимом предварительного просмотра Яндекс Тег Менеджера одновременно, вы можете столкнуться с проблемой открытия каждой панели, поскольку сейчас одна иконка от одной панели накладывается на иконку другой панели, что неудобно.

Надеюсь, Яндекс в ближайшее время исправит это.

В нижней части окна браузера появится консоль отладки с подробной информацией о запущенных тегах, порядке их активации и собираемых данных. Эту консоль будете видеть только вы - другим посетителям сайта она недоступна.

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

• вы используете какие-либо блокировщики, например, AdBlock или AdGuard (хотя я тестировал открытие режима отладки с активным расширением и проблем не обнаружил);
• ваш антивирус блокирует всплывающие окна;
• сам браузер настроен таким образом, что воспрепятствует появлению дополнительных окон;
• проблема связана с историей посещения и файлами cookie (можно попробовать их почистить).

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

По умолчанию у вас (если вы ничего еще не настраивали в своем контейнере) будет отображаться только одно событие на шкале - Инициализация с цифрой 1. По мере выполнения действий (например, просмотр страницы, клики по элементам или ссылкам, отправка формы и др.) все они будут фиксироваться в панели дебаггера.

Примечание: Инициализация (инициализация кода счетчика) - это триггер, который активируется сразу после начала загрузки страницы - на этапе обработки тега <head>, когда содержимое страницы еще не загружено.

Для чего нужен режим отладки Яндекс Тег Менеджера?

• позволяет отслеживать изменения в реальном времени: какие теги активировались, какие - нет, и по какой причине;
• показывает порядок срабатывания тегов и данные, которые отправляются в аналитические системы;
• дает возможность безопасно протестировать настройки;
• помогает быстрее настраивать цели, пиксели и интеграции с Яндекс Метрикой и другими сервисами.

Навигация

Давайте разберем полностью всю навигацию консоли отладки (по состоянию на 21 ноября 2025 г.).

1. Сводка, шкала временных событий

В этом блоке отображаются все события в хронологическом порядке, которые зафиксировал Яндекс Тег Менеджер. Цифра рядом с каждым событием означает порядок активации. В данном случае событие Инициализация (1) было зафиксировано раньше остальных, затем сработало Просмотр страницы (2), а после - событие Клики - все элементы (3).

При клике на любое событие из списка мы можем посмотреть дополнительную информацию о нем.

2. Вкладка «Теги»

На этой вкладке отображаются теги, которые активированы текущим событием.

Статусы тегов:

• Активированные теги - условия выполнены, тег сработал;
• Неактивированные теги - условия не выполнены;
• На паузе - тег не относится к событию.

Для каждого тега отображается:

• название и тип шаблона;
• условия активации и триггеры;
• список переменных и параметров;
• опция Отображать переменные как Имена/Значения.

Вот так выглядит содержимое тега, когда вы откроете подробную информацию о нем:

2. Вкладка «Переменные»

Эта вкладка отображает переменные, которые доступны при срабатывании события.

Вы получаете подробные сведения о переменных в выбранном событии в тот момент, когда оно произошло. ЯТМ будет передавать те значения переменных, которые были активированы в интерфейсе (встроенные и пользовательские), даже если они не определены (undefined).

Для каждой переменной отображается:

• название;
• тип переменной;
• возвращаемый тип;
• значение.

Предположим, ваш разработчик настроил отслеживание функции User ID и передает на уровень данных (dataLayer) идентификатор пользователя, который авторизовался в системе. Вы, в свою очередь, в Яндекс Тег Менеджере создали триггер специального события, переменную уровня данных для извлечения этого значения и хотите проверить, правильно ли она работает.

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

Аналогичным образом можно поступить и с переменной внутри тега. Для этого откройте вкладку Теги, затем откройте активированный тег и переключитесь на режим Значения. После этого вы можете проверить, действительно ли то самое значение, которое вы хотели извлечь, отправляется вместе с тегом в аналитику. Или переменная принимает какое-то другое значение, или вовсе undefined.

3. Активированные теги

Когда вы раскрываете конкретное событие на шкале, чтобы посмотреть подробные сведения, вы видите несколько статусов тегов:

• Активированные теги - условия выполнены, тег сработал;
• Неактивированные теги - условия не выполнены;
• На паузе - тег не относится к событию.

Например, с триггером Просмотр страницы для моего проекта активированы три тега:

1. HTML - Rutube (Пользовательский HTML)
2. HTML - User ID (Пользовательский HTML)
3. HTML - Копирование текста (Пользовательский HTML)

Нажав на тег, можно просмотреть его свойства и значения, а также триггеры активации и блокировки.

Например, для тега Яндекс Метрики вместе с событием дополнительно можно передавать доход цели и параметры события (поле params). Вся эта информация будет отображаться в соответствующих полях.

Если триггер сработал, то рядом будет стоять зеленая галочка, если нет - красная:

Активация триггера может состоять из нескольких условий. В этом случае какие-то отдельные условия могут сработать, а какие-то нет:

При несоблюдении хотя бы одного условия триггер не сработает.

В верхней части блока есть настройка, которая называется Отображать переменные как - Имена и Значения:

Она позволяет выбрать режим представления переменных: в виде имени (Names) или в виде значения (Values) переменной в момент активации.

4. Неактивированные теги

Неактивированные теги - это теги, которые не были активированы при определенном событии или при загрузке страницы.

Например, вы отслеживаете событие клика по социальной сети. Но в то же время в вашем контейнере Яндекс Тег Менеджера есть и другие теги, созданные для других действий (например, для отслеживания видео Rutube, копирования текста, глубины прокрутки, 404 ошибок, отправки формы и других событий). И когда вы проверяете корректность настройки именно клика по ссылкам, то выбираете именно такое событие на шкале режима отладки.

И, разумеется, у этого события будут как активированные тег(и), которые сработали в данный момент времени с этим событием, так и неактивированные, которые присутствуют в вашем контейнере ЯТМ, но предназначены для других задач и действий.

Вот так может выглядеть список неактивированных тегов с конкретным событием:

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

Например, хоть я и выполнял проверку для триггера Клики - только ссылки, тег Яндекс Метрика - Скачивание КП не был активирован, потому не было выполнено условие Click URL содержит kp.pdf, то есть конкретный клик по конкретному URL-адресу:

Однако когда я кликну по этой конкретной ссылке на сайте, условие активации триггера сработает корректно и тег передаст событие в Яндекс Метрику:

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

1. запустите режим отладки ЯТМ и выполните действие на сайте (например, отправку формы);
2. найдите событие в списке (например, Отправка формы);
3. откройте вкладку Теги и убедитесь, что нужный тег активировался;
4. в разделе Триггеры активации проверьте, что выполнены все условия активации;
5. на вкладке Переменные убедитесь, что данные передаются корректно.

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

5. Теги на паузе

Теги на паузе - это те теги, которые вы в своем контейнере Яндекс Тег Менеджера поставили на паузу, то есть изменили статус с Запустить на Остановить:

Примечание: приостановленные теги будут иметь статус Неактивный.

Такие теги отображаются в интерфейсе с соответствующей иконкой. Аналогичным образом они отображаются в режиме отладки:

6. Информация о контейнере

Сверху над панелью отладки находится информация о контейнере - его идентификатор (ID) и номер версии.

Эта информация также представлена в интерфейсе самого ЯТМ:

7. Счетчик Яндекс Метрики

Дополнительно Яндекс Тег Менеджер отображает название счетчика Яндекс Метрики и его идентификатор, из которого запущен режим отладки:

8. Очистить шкалу событий

Кнопка Очистить удаляет все данные из шкалы событий. Это удобно, когда вы проводите множество тестов и отладки на одной странице, вызываете разные события и активируете большое количество тегов. Чтобы вам было проще ориентироваться в панели отладки, можно периодически очищать её состояние.

До очищения панели отладки:

После очищения:

Не забывайте, что при обновлении страницы или переходе на другую страницу все состояния на панели отладки ЯТМ обнуляются, и вы заново видите все, что на ней происходит.

9. Сворачивание панели отладки

Иногда панель отладки Яндекс Тег Менеджера загораживает нижнюю часть экрана. В этом случае мы на некоторое время можем свернуть его для внесение каких-либо правок с помощью данной опции.

В свернутом состоянии панель отладки выглядит так:

При клике на элемент панель вернется в исходное состояние. Помимо этого, управлять высотой панели можно с помощью ее перетягивания левой кнопкой мыши вверх-вниз.

Полезное от Яндекс Тег Менеджера

Взято из официальной документации:

• для активации тега необходимо, чтобы хотя бы один из триггеров сработал. Если в тег добавлено несколько триггеров, то активация происходит при срабатывании любого из них;
• все изменения вступают в силу только после публикации версии;
• теги можно временно отключать без удаления. Это удобно для тестирования и приостановки кампаний;
• один шаблон можно использовать в нескольких тегах;
• внутри тега можно использовать переменные, их значения подставляются автоматически;
• вывод в консоль (для отладки) доступен только при включенном разрешении logging в шаблоне;
• в режиме предварительного просмотра активируется cookie _ytm_preview, которая действует в течение 10 минут после запуска.

Итоги

После того, как вы проверили корректность всех настроек в режиме отладки и внесли соответствующие изменения, их можно опубликовать. Для этого необходимо нажать на кнопку Опубликовать в правом верхнем углу Яндекс Тег Менеджера.

В моем блоге за последние полгода опубликовано более 20 материалов, посвященных настройке и отслеживанию событий с помощью Яндекс Тег Менеджера. В каждом из этих руководств подробно разбираются шаги настройки и методы проверки корректности внедрения. Ранее для отладки использовались шаблон тега Мини дебагер триггеров и переменных, а также режим _ym_debug=2 от Яндекс Метрики. Сейчас появилась полноценная панель отладки, и часть описанных ранее подходов устарела. Поэтому, пожалуйста, пользуйтесь новой панелью отладки ЯТМ для проверки ваших настроек и обращайте внимание на актуальность информации в текущих статьях.

Также Яндекс в своем анонсе заявил, что продолжит развивать режим отладки и в ближайшее время планирует добавить вкладку Сводка - боковое меню, где можно будет посмотреть произошедшие события, и переключение между компонентами и панелями отладки Метрики и Тег Менеджера. С нетерпением ждем!