Як дебажити Google Tag Manager через режим Preview

"Тег не спрацьовує" - найпоширеніше звернення в підтримку GTM, і режим Preview майже завжди містить реальну відповідь. Просто більшість людей не знають, як читати те, що він показує. Preview підключає ваш живий сайт до панелі дебагу, що показує кожен тег, тригер і змінну точно так, як GTM оцінює їх у реальному часі. Ось як користуватися ним, щоб діагностувати зламаний тег, а не вгадувати виправлення.

Крок 1: почніть сесію Preview

У GTM натисніть "Preview" у правому верхньому куті. Це відкриє Tag Assistant у новій вкладці, де ви вводите URL свого сайту. Після підключення внизу вашого реального сайту з'являється панель дебагу: ліворуч - жива стрічка подій, праворуч - детальна інформація про теги, змінні й data layer для будь-якої події, на яку ви клікнете.

Крок 2: правильно читайте панель Summary

Клікніть на будь-яку подію в лівій часовій шкалі (Page View, Click, Form Submission чи кастомну подію), і вкладка Summary покаже два списки: "Tags Fired" і "Tags Not Fired". Якщо тег, який ви очікували побачити серед спрацьованих, опинився в списку "Tags Not Fired", це ваша відправна точка. Клікніть на нього, щоб побачити, яка саме умова тригера не виконалася і чому: GTM показує конкретну умову й фактичне значення, з яким її звіряли.

Крок 3: перевірте вкладку Variables на неправильні значення

Тег може спрацювати коректно, але надіслати неправильні дані, чого самого лише Tags Fired не покаже. Вкладка Variables показує фактичне обчислене значення кожної змінної для конкретної події. Якщо змінна Click Text порожня, коли ви очікували напис на кнопці, або змінна data layer повертає "undefined", саме тут ви це помітите.

Крок 4: використовуйте вкладку Data Layer для кастомних подій

Для тегів, що запускаються кастомною подією, відправленою через data layer (поширено в e-commerce і на будь-якому сайті, де data layer керує розробник), вкладка Data Layer показує точний об'єкт, відправлений у цей момент. Переконайтеся, що назва події точно збігається з тим, що слухає ваш тригер. Навіть така дрібна невідповідність, як "purchase" проти "Purchase", достатня, щоб тихо зламати зв'язок.

Поширені патерни збоїв і що вони означають

Крок 5: поділіться Preview з кимось іншим

Панель дебагу включає посилання "Share Preview", що підключає інший браузер, вкладку чи пристрій до тієї самої живої сесії без доступу до GTM. Це зручно, коли треба, щоб розробник чи колега подивилися на ті самі дані дебагу на власній машині чи на іншому пристрої, де відтворюється проблема.

Поширені помилки

• Плутанина між успіхом у режимі Preview та живим, опублікованим контейнером. Preview лише показує, як поводилася б поточна чорнова версія. Нічого не запрацює по-справжньому, доки ви не натиснете Submit і Publish. Тег, що працює ідеально в Preview, нічого не робить для реальних відвідувачів, поки його не опубліковано.
• Перевірка лише Tags Fired і пропуск Variables. Тег, показаний як "спрацював", усе одно може надсилати зламані чи порожні дані. Завжди перехресно перевіряйте фактичні значення для всього, що залежить від динамічного контенту.
• Дебаг не на тій сторінці чи пристрої. Тег, налаштований лише для мобільного тригера, не покаже нічого корисного, коли ви тестуєте з десктопного браузера. Узгодьте тестове середовище з реальними умовами тригера.

Часті запитання

Чи впливає режим Preview на реальних відвідувачів чи живі дані?

Ні. Preview лише симулює роботу чорнової версії контейнера і впливає лише на ту браузерну сесію, яка до нього активно підключена. Для звичайних відвідувачів сайту нічого не змінюється.

Чи можна використовувати Preview на живому продакшн-сайті?

Так, це стандартний спосіб дебагу, оскільки Preview впливає лише на вашу власну підключену сесію, а не на інших відвідувачів, що переглядають той самий сайт одночасно.

Чому тег працює в Preview, але не спрацьовує після публікації?

Зазвичай це означає, що зміну не включили в опубліковану версію, або що на продакшені є окрема проблема - наприклад, шар кешування, який віддає старішу версію сторінки. Переконайтеся, що опублікована версія контейнера збігається з тією, яку ви тестували.

Режим Preview відповідає на "чому цей тег не спрацьовує" швидше й надійніше за будь-яку кількість вгадувань, але контейнер, що потребує постійного дебагу, зазвичай є симптомом глибших структурних проблем - дублікатів тегів, конфліктних тригерів чи відстеження, яке ніхто роками не аудитував. Якщо вашому контейнеру GTM потрібне більше, ніж разове виправлення, наша команда GTM Setup може провести аудит і перебудувати його правильно.