Фраза «в dataLayer что-то не то» слишком широка. Значение может отсутствовать при событии, прийти строкой вместо числа, сохраниться от прошлого шага или быть правильным, но не прочитанным переменной GTM. Быстрее всего разбирать один пользовательский сценарий и один push, а не весь контейнер сразу.

До изменения тегов договоритесь, что именно считается событием. Например, `order_completed` отправляется один раз после подтверждения сервером, содержит идентификатор заказа и сумму числом, но не включает email или телефон. Это уже проверяемый контракт.

Контракт отделяет обязательное от случайного

ПолеТипПравило
eventstringСтабильное имя в lower_snake_case
schema_versionintegerМеняется при несовместимой схеме
order_idstringНепустой, не секрет
valuenumberЧисло, не форматированная строка
currencystringКод валюты одинакового регистра
itemsarrayДаже для одного товара остаётся массивом

Названия чувствительны к регистру: `orderId` и `orderID` — разные ключи. Не пытайтесь лечить расхождение десятью переменными с запасными путями. Лучше исправить producer и держать один контракт в репозитории рядом с кодом сайта.

Массив создаётся до контейнера и не перезаписывается

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'order_completed',
  schema_version: 1,
  order_id: 'A-1042',
  value: 3490,
  currency: 'RUB',
  items: [{ item_id: 'SKU-7', quantity: 1 }]
});

Google рекомендует работать через `dataLayer.push()`. Позднее присваивание `window.dataLayer = []` создаёт новый массив и может уничтожить ранее добавленные данные и служебные сообщения контейнера. Событийный ключ `event` нужен, чтобы GTM мог реагировать на определённый момент, а не угадывать его по изменению произвольной переменной.

Порядок push важнее итогового содержимого массива

  • Данные, необходимые для события, передаются в том же push или раньше него.
  • Push выполняется после подтверждённого действия, а не при каждом render компонента.
  • Повторный mount не создаёт второй purchase с тем же order_id.
  • SPA отправляет page/event при смене маршрута, а не только при первой загрузке.
  • Необязательное поле явно пропускается по контракту, а не наследуется случайно.
  • Согласие пользователя проверяется до отправки данных соответствующим получателям.

Просмотр `window.dataLayer` в консоли в конце сценария не доказывает, что нужное значение существовало в момент срабатывания тега. В Tag Assistant Preview выберите событие в левой хронологии и смотрите Variables и Data Layer именно для него.

Ошибка данных и ошибка тега дают разные следы

Наблюдение в PreviewВероятная причинаСледующий шаг
События нетProducer не вызвал pushПроверить ветку приложения
Событие есть, поля пустыНеверный путь или порядокСверить объект push
Поля верны, тег не сработалУсловия trigger/consentОткрыть причины not fired
Тег сработал, payload неверенMapping параметровПроверить запрос
Два одинаковых событияПовторный listener/renderДобавить дедупликацию

Не публикуйте контейнер после одного удачного клика. Проверьте ещё отмену, возврат назад, повторную загрузку confirmation и отсутствие обязательного поля. Негативные случаи часто обнаруживают дубли и наследованные значения раньше production.

Персональные данные не нужны для диагностики

В логах Preview и сетевых запросах легко оставить email, телефон, адрес или токен. Для большинства событий достаточно технического идентификатора, категории действия и числовых параметров. Если бизнесу нужны user-provided data, это отдельный согласованный процесс с хешированием и правилами конкретного продукта, а не повод складывать профиль пользователя в общий dataLayer.

Релиз принимают по матрице сценариев

  1. Зафиксировать эталонный JSON и типы полей.
  2. Пройти happy path в Preview и сохранить событие.
  3. Проверить отсутствие события при отмене действия.
  4. Повторить сценарий после reload и перехода назад.
  5. Проверить фактический сетевой payload тега без секретов.
  6. Опубликовать контейнер с версией и наблюдать долю пропусков и дублей.

Готовый dataLayer — это не тот, где «видно много полей», а тот, где одно бизнес-событие воспроизводимо, типы стабильны, лишние данные не попадают в браузер, а контейнер не компенсирует ошибки producer. Такой контракт легче тестировать при следующем изменении сайта.

Проверенные источники