GTM · настройка Meta Pixel событий

⚠️ План-документ (май 2026). Реализация пошла другим путём. Pixel и все события сейчас грузятся inline (не через GTM), а CAPI работает серверно через Make. Документ оставлен как история ранней стратегии. Актуальное as-built устройство трекинга — 24-tracking-runbook.md. Легаси GTM-теги Meta Pixel и Meta · Lead поставлены на паузу.

Стратегия. Начинаем с 2 событий: PageView (уже работает) + Lead (одно главное). Этого достаточно для оптимизации Meta Ads на старте. Дальше расширяем — но только когда поймём что Lead срабатывает чисто и трафика хватает для разделения по сегментам.

Логика: чем меньше событий, тем чище сигнал. Meta тренируется на «реальных покупателях», а не «всех кто куда-то ткнул». Микро-конверсии типа CTAClick разбавляют сигнал.

⚠️ Не используй Meta «Event Setup Tool»

В Events Manager есть кнопка «Set up events» с no-code инструментом (point-and-click по элементам сайта). Не используй её. Она:

• Перекрывает GTM-теги и создаёт дубликаты
• Не знает про наш dataLayer
• Не передаёт eventID для CAPI дедупа
• Триггеры завязаны на DOM-селекторы — ломаются при любом изменении вёрстки

Всё делаем через GTM (контейнер GTM-K4Z4WPDB).

Шаг 1 · Минимальная конфигурация (только PageView + Lead)

1.1 Что в dataLayer (для справки)

Важно: generate_lead теперь firs только когда есть submission_id в sessionStorage. Прямой заход на /thank-you (закладка, рефреш с очисткой кеша) — Lead не fires. Это защищает Meta от шума.

1.2 GTM переменные (создать один раз)

Variables → User-Defined → New:

(Можно создать больше позже — но для Lead-тега хватит этих.)

1.3 GTM триггер для Lead

Triggers → New → Custom Event

• Event Name: generate_lead
• This trigger fires on: All Custom Events
• Name: Custom · generate_lead

1.4 GTM Тег · Meta · Lead ⭐

Tags → New

Если используешь шаблон «Facebook Pixel» (Templates → Search Gallery → найти Facebook Pixel by Stape или Simo Ahava):

• Pixel ID: {{Pixel ID}}
• Event Type: Standard → Lead
• Event ID (поле «Event ID» в шаблоне): {{DL · event_id}} ⚠️ критично для CAPI дедупа
• Параметры:
  • content_category = {{DL · tier}}
  • content_name = {{DL · funnel_mechanism}}
• Trigger: Custom · generate_lead
• Name: Meta · Lead

Если делаешь через Custom HTML:

<script>
  fbq('track', 'Lead', {
    content_category: {{DL · tier}},
    content_name: {{DL · funnel_mechanism}},
    country: {{DL · country}}
  }, {
    eventID: {{DL · event_id}}
  });
</script>

• Trigger: Custom · generate_lead
• Name: Meta · Lead

Шаг 2 · Тестирование (15 минут)

2.1 GTM Preview

1. GTM → правый верхний угол → Preview
2. Вводим URL: https://x5.karada.kz/?utm_source=test&utm_campaign=preview-1&fbclid=test_fbclid_001
3. Открывается сайт + панель Tag Assistant внизу
4. Тыкай по событиям слева:

Что должно сработать:

• Container Loaded → Meta Pixel - PageView ✓
• page_view (custom) → переменные DL · tier = "standard", DL · country = "KZ", DL · funnel_mechanism = "quick-lead"

Теперь пройди форму:

• Нажми «Записаться на курс» → модалка
• Заполни имя QA Тест + телефон +7 700 000 0000
• Submit → редирект на /thank-you

На /thank-you:

• generate_lead событие в Tag Assistant ✓
• DL · event_id непустой (UUID) ✓
• Meta · Lead тег fires ✓

В Meta Events Manager → Test Events (параллельно):

• PageView появляется на каждой странице
• Lead появляется когда дошёл до /thank-you
• В деталях Lead-события: Event ID: <uuid> присутствует

2.2 Тест «прямой /thank-you» (защита от шума)

1. Очисти sessionStorage в DevTools (Application → Session Storage → clear)
2. Открой https://x5.karada.kz/thank-you напрямую
3. В DevTools Console должно появиться:

   [karada-bp /thank-you] no submission in session — generate_lead suppressed

4. В GTM Preview generate_lead не firs
5. В Meta Events Manager Lead не появляется

→ Если так — баг с шумом починен, можно публиковать.

Шаг 3 · Publish (когда тесты зелёные)

1. GTM → Submit
2. Version Name: 2026-05-20 · Lead event (gated)
3. Description: Added Meta · Lead tag, fires only on real /thank-you conversion via dataLayer event_id
4. Publish

Что НЕ делаем на этом этапе

Эти события уже есть в dataLayer, но GTM-теги под них не создаём пока:

Принцип расширения: добавляем новый Pixel-тег только когда есть конкретный вопрос «который этот сигнал поможет ответить». Не «потому что Meta это поддерживает».

Conversion API (CAPI) · следующий шаг

Что это: серверная отправка тех же Pixel-событий с нашего бэкенда (Make webhook) в Meta API. Защищает от iOS 14+, AdBlock, ITP. Обычно повышает attribution на 20-30%.

Что нужно:

• Pixel ID (уже есть в analytics.ts: 662311819389495)
• Access Token из Meta Events Manager → Settings → Conversions API → Generate access token (новое окно)
• Нам — добавить один HTTP-модуль в Make, который шлёт Lead event в https://graph.facebook.com/v19.0/{pixel_id}/events
• Дедуп с пикселем — через event_id в payload (это наш submission_id, уже в payload)

Когда подключать: после того как 1-2 дня Pixel Lead стабильно firs и видна attribution в Ads Manager. CAPI = страховка, не первоочерёдная задача.

Сводка · что у тебя в GTM после этой настройки

Этого хватит для запуска и оптимизации холодных кампаний. Lead — это тот сигнал на который Meta Ads оптимизирует «конверсии». Всё остальное — оптимизация оптимизации.

Связанные документы

• /docs/14-meta-ads-attribution — UTM-параметры в кампаниях
• /team/13-tracking-events — все события в dataLayer (справочник)
• /team/17-data-flow-diagram — где какое событие срабатывает
• /team/15-test-scenarios — group G: Pixel + CAPI тестирование