Настройка Google Tag Manager на 1С-Битрикс
Представьте: маркетолог просит добавить пиксель VK, через неделю — Яндекс.Метрику, потом — цепочку событий для GA4. Каждый раз приходится лезть в код, править шаблоны, выкатывать обновления. Наш опыт показывает: правильная установка Google Tag Manager на 1С-Битрикс решает эту проблему раз и навсегда. Мы настраиваем GTM так, чтобы маркетолог сам управлял тегами через интерфейс, а dataLayer автоматически передавал все данные о покупках, корзинах и просмотрах.
Почему dataLayer обязателен для интернет-магазина?
Без dataLayer GTM — просто пустая оболочка. Вы можете опубликовать тег GA4, но не получите данных о цене товара, категории, ID транзакции. Для интернет-магазина на 1С-Битрикс dataLayer — это мост между событиями на сайте и системами аналитики. Он передаёт структурированные данные: item_id, item_name, price, currency, quantity. GA4, Яндекс.Метрика и другие сервисы ожидают именно такой формат. Если dataLayer настроен неправильно, вы теряете до 30% данных о конверсиях — проверено на десятках проектов.
Типичные ошибки при интеграции GTM в 1С-Битрикс
Хардкод ID контейнера
Часто разработчики вписывают GTM-XXXXXXX прямо в шаблон. При смене контейнера (например, для тестирования или перехода на другой аккаунт) приходится снова редактировать файлы. Мы храним ID в настройках модуля через \Bitrix\Main\Config\Option::set — это позволяет менять ID через админку без деплоя.
Отсутствие тегированного кэширования
1С-Битрикс агрессивно кэширует страницы. Если dataLayer генерируется динамически (например, цена зависит от скидки пользователя), кэш может показать устаревшие данные. Мы используем тегированный кэш и сбрасываем его при изменении цены или остатка. Без этого события view_item могут содержать неверную стоимость — расхождения с реальными заказами доходят до 15%.
Событие purchase только на странице заказа
Многие ограничиваются отправкой purchase в момент оформления. Но нужно также передавать add_to_cart, remove_from_cart, begin_checkout. Без этих событий вы не сможете построить полную воронку в GA4. Мы добавляем все ключевые события, используя штатные механизмы Битрикс: OnBasketChange, OnOrderSave, OnSalePayOrder.
Как мы настраиваем GTM: пошаговый процесс
- Анализ текущего сайта: проверяем версию Битрикс, кэширование, установленные модули, тип торгового каталога.
- Проектирование dataLayer: составляем карту событий (просмотр товара, добавление в корзину, оформление, покупка) и согласовываем с маркетологом.
- Разработка и интеграция: добавляем код установки GTM в шаблон, пишем result_modifier для компонентов каталога и корзины, реализуем серверную генерацию dataLayer для событий после оплаты.
- Тестирование: проверяем каждое событие через Tag Assistant и консоль браузера, сверяем данные с реальными заказами из 1С.
- Деплой и документация: заливаем на боевой сервер, отдаём клиенту инструкцию по работе с GTM.
Пример реализации: установка GTM и dataLayer
Установка GTM в шаблон Битрикс
GTM требует два фрагмента кода: один в <head>, второй сразу после <body>. В шаблоне Битрикс (/bitrix/templates/[name]/header.php):
<?php // ID контейнера GTM из аккаунта Google Tag Manager $gtmId = \Bitrix\Main\Config\Option::get('custom', 'gtm_container_id', 'GTM-XXXXXXX'); ?> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <!-- GTM в head (как можно раньше) --> <?php if ($gtmId): ?> <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','<?= htmlspecialchars($gtmId) ?>');</script> <?php endif; ?> </head> <body> <!-- GTM noscript сразу после <body> --> <?php if ($gtmId): ?> <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=<?= htmlspecialchars($gtmId) ?>" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript> <?php endif; ?> ID контейнера хранить в b_option (таблица настроек) через административный интерфейс — не в коде, чтобы маркетолог мог менять без деплоя.
dataLayer для страниц товара
Для работы расширенной электронной торговли (GA4 Ecommerce) нужен dataLayer с данными товара. В шаблоне компонента bitrix:catalog.element или в result_modifier.php:
// bitrix/templates/.default/components/bitrix/catalog.element/.default/result_modifier.php if (!empty($arResult['CATALOG_PRICE']['BASE']['PRICE'])) { $product = [ 'item_id' => $arResult['ID'], 'item_name' => $arResult['NAME'], 'price' => (float)$arResult['CATALOG_PRICE']['BASE']['PRICE'], 'currency' => $arResult['CATALOG_PRICE']['BASE']['CURRENCY'], 'item_category' => $arResult['SECTION']['NAME'] ?? '', 'item_brand' => $arResult['PROPERTIES']['BRAND']['VALUE'] ?? '' ]; $this->arResult['GTM_PRODUCT'] = $product; } В шаблоне компонента вывести dataLayer перед закрывающим </body>:
<?php if (!empty($arResult['GTM_PRODUCT'])): ?> <script> window.dataLayer = window.dataLayer || []; window.dataLayer.push({ event: 'view_item', ecommerce: { currency: '<?= htmlspecialchars($arResult['GTM_PRODUCT']['currency']) ?>', value: <?= (float)$arResult['GTM_PRODUCT']['price'] ?>, items: [<?= json_encode($arResult['GTM_PRODUCT'], JSON_UNESCAPED_UNICODE) ?>] } }); </script> <?php endif; ?> Событие purchase после оплаты
Самое важное событие — факт покупки. В компоненте bitrix:sale.order.ajax или на странице «Спасибо за заказ»:
<?php // Получить последний заказ текущего пользователя $orderId = (int)($_SESSION['SALE_ORDER_ID_REDIRECTED'] ?? 0); if ($orderId > 0) { $order = \Bitrix\Sale\Order::load($orderId); if ($order) { $items = []; foreach ($order->getBasket() as $basketItem) { $items[] = [ 'item_id' => $basketItem->getProductId(), 'item_name' => $basketItem->getField('NAME'), 'price' => (float)$basketItem->getPrice(), 'quantity' => (int)$basketItem->getQuantity() ]; } ?> <script> window.dataLayer = window.dataLayer || []; window.dataLayer.push({ event: 'purchase', ecommerce: { transaction_id: '<?= $order->getId() ?>', value: <?= (float)$order->getPrice() ?>, currency: '<?= $order->getCurrency() ?>', items: <?= json_encode($items, JSON_UNESCAPED_UNICODE) ?> } }); </script> <?php } } ?> Добавление в корзину через JS
Событие add_to_cart генерируется в JavaScript при клике на кнопку «Добавить в корзину». Перехватить стандартное событие Битрикс:
// В шаблоне или в /local/templates/.default/js/analytics.js BX.addCustomEvent('OnBasketChange', function(event) { if (event.action === 'ADD') { window.dataLayer = window.dataLayer || []; window.dataLayer.push({ event: 'add_to_cart', ecommerce: { currency: event.currency || 'RUB', value: event.price * event.quantity, items: [{ item_id: String(event.productId), item_name: event.productName || '', price: event.price, quantity: event.quantity }] } }); } }); Событие OnBasketChange генерируется модулем sale через BX.Event при AJAX-добавлении в корзину.
Как проверить работоспособность dataLayer?
В браузере установить расширение «Tag Assistant» от Google. Оно покажет какие теги GTM сработали, с какими данными и были ли ошибки в dataLayer. Или через консоль браузера выполните console.table(window.dataLayer) для просмотра всех событий.
Хранение ID контейнера
Не хардкодить GTM ID в шаблоне — использовать b_option:
// Запись через API \Bitrix\Main\Config\Option::set('custom', 'gtm_container_id', 'GTM-XXXXXXX'); // Чтение $gtmId = \Bitrix\Main\Config\Option::get('custom', 'gtm_container_id'); Это позволяет менять ID без правки кода через административный интерфейс или через настройки кастомного модуля.
Сравнение подходов: хардкод против настройки через dataLayer
| Критерий | Хардкод скриптов | GTM + dataLayer |
|---|---|---|
| Время внесения изменений | 1-2 часа (правка кода, деплой) | 5 минут (через интерфейс GTM) |
| Зависимость от разработчика | Каждый раз | Только при старте |
| Ошибки в данных | Часто (путают валюту, ID) | Редко (dataLayer формируется Битриксом) |
| Поддержка GA4 Ecommerce | Требует отдельной реализации | Встроена через dataLayer |
Настройка GTM через dataLayer в 3 раза сокращает время на добавление новых тегов и исключает ошибки, связанные с ручным копированием кода.
События dataLayer и их триггеры
| Событие | Триггер | Данные |
|---|---|---|
view_item |
Просмотр страницы товара | item_id, name, price, category |
add_to_cart |
AJAX-добавление в корзину | item_id, name, price, quantity |
remove_from_cart |
AJAX-удаление из корзины | item_id, name, price, quantity |
begin_checkout |
Переход к оформлению | items, value |
purchase |
Успешная оплата | transaction_id, value, items |
Что входит в результат
- Установка GTM в шаблон с хранением ID в настройках.
- Интеграция dataLayer для событий:
view_item,add_to_cart,remove_from_cart,begin_checkout,purchase. - Настройка тегированного кэширования для динамических данных.
- Проверка через Tag Assistant и консоль.
- Документация по добавлению новых тегов в GTM.
- Гарантия корректной передачи данных в течение 30 дней.
Почему стоит доверить настройку профессионалам?
Мы специализируемся на 1С-Битрикс и GTM более 5 лет, реализовали интеграцию для 50+ интернет-магазинов. Наши инженеры сертифицированы по Битрикс и Google Analytics. Мы учитываем особенности кэширования, торговых предложений, скидок и обмена с 1С через CommerceML. Получите консультацию по вашему проекту — оценим объём работ и сроки. Свяжитесь с нами, чтобы обсудить детали.