Фраза «в dataLayer что-то не то» слишком широка. Значение может отсутствовать при событии, прийти строкой вместо числа, сохраниться от прошлого шага или быть правильным, но не прочитанным переменной GTM. Быстрее всего разбирать один пользовательский сценарий и один push, а не весь контейнер сразу.
До изменения тегов договоритесь, что именно считается событием. Например, `order_completed` отправляется один раз после подтверждения сервером, содержит идентификатор заказа и сумму числом, но не включает email или телефон. Это уже проверяемый контракт.
Контракт отделяет обязательное от случайного
| Поле | Тип | Правило |
|---|---|---|
| event | string | Стабильное имя в lower_snake_case |
| schema_version | integer | Меняется при несовместимой схеме |
| order_id | string | Непустой, не секрет |
| value | number | Число, не форматированная строка |
| currency | string | Код валюты одинакового регистра |
| items | array | Даже для одного товара остаётся массивом |
Названия чувствительны к регистру: `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.
Релиз принимают по матрице сценариев
- Зафиксировать эталонный JSON и типы полей.
- Пройти happy path в Preview и сохранить событие.
- Проверить отсутствие события при отмене действия.
- Повторить сценарий после reload и перехода назад.
- Проверить фактический сетевой payload тега без секретов.
- Опубликовать контейнер с версией и наблюдать долю пропусков и дублей.
Готовый dataLayer — это не тот, где «видно много полей», а тот, где одно бизнес-событие воспроизводимо, типы стабильны, лишние данные не попадают в браузер, а контейнер не компенсирует ошибки producer. Такой контракт легче тестировать при следующем изменении сайта.