Реклама и пиксели

Вкладка «Реклама и пиксели» (в интерфейсе — Pixel Connections,
«библиотека трекеров и диагностика отправки событий») собирает все рекламные
пиксели проекта, привязывает их к сайтам и показывает журнал доставок событий в
рекламные кабинеты.

Что здесь естьЧто здесь есть

• Фильтр по сайту — показать трекеры всех сайтов или конкретного.
• Библиотека трекеров — карточки подключений с провайдером, ID, статусом и
  привязкой к сайту.
• Лог событий — таблица событий (telegram_subscribe, оплаты и т. д.) с
  идентификатором, временем и статусом доставки в каждый пиксель.
• Кнопка Добавить connection — новое подключение.

ПровайдерыПровайдеры

Поддерживаются четыре рекламные системы. У каждой — свой идентификатор:

• Meta — Meta Pixel ID; опционально серверные конверсии (Meta: Conversions API).
• VK — VK Pixel / VK Ads counter ID.
• TikTok — TikTok Pixel Code + TikTok Events API token (серверные
  конверсии). Отдельное руководство — TikTok CAPI.
• Google — Measurement ID / Tag ID (G-XXXXXXXXXX).

Как добавить трекерКак добавить трекер

1. Откройте Технический блок → Сайты → вкладка Реклама и пиксели.
2. Нажмите Добавить connection.
3. Выберите сайт (или оставьте Без привязки).
4. Выберите провайдер (Meta, VK, TikTok, Google).
5. Введите ID пикселя и, при желании, название.
6. Для Meta/TikTok включите Server-side events / CAPI, если нужны серверные
   конверсии, и вставьте Access Token.
7. Оставьте переключатель Активен включённым и нажмите Сохранить.

Статусы и индикаторы трекераСтатусы и индикаторы трекера

В карточке трекера видно:

• Активен / Отключена — включена ли отправка.
• Метки провайдера и режима (например Meta [Pixel + CAPI]).
• Состояние CAPI: CAPI активен, CAPI выкл. или CAPI: токен не задан /
  Token: не задан.
• Действия: Тест (для Meta/TikTok), редактирование, удаление.

Проверка доставкиПроверка доставки

• Кнопка Тест отправляет тестовое событие (PageView) через тот же серверный
  канал, что и реальные доставки, и показывает ответ рекламной системы прямо в
  карточке (PageView отправлен в TikTok, событие отправлено в Meta или текст
  ошибки).
• Лог событий внизу вкладки показывает реальные доставки: событие, ID,
  время и статус для каждого пикселя. Типовые статусы: sent (принято),
  skipped (не отправлено — например, у события нет ttclid), failed
  (отклонено, с кодом и текстом ошибки).

Серверные события MetaСерверные события Meta

С включённым CAPI в Meta уходят события, привязанные к рекламному клику лида:

Событие Napulse	Событие Meta	Когда
telegram_subscribe	Subscribe	лид пришёл в Telegram по ссылке-воронке
dialog_started	Contact	лид из воронки впервые сам написал в диалог
payment_success	Purchase	подтверждена оплата по сделке

Диалог (dialog_started → Contact). У Meta нет стандартного события
«диалог» для сайтов; Contact по определению Meta — «человек связался с
бизнесом, в том числе через чат». Событие отправляется один раз на контакт:

• засчитывается только то, что клиент отправил сам: текст, эмодзи, фото, видео,
  голосовое, файл, стикер — в Telegram-ботах, личных Telegram-аккаунтах и
  сообществах VK;
• не засчитываются: /start и другие команды бота, нажатия любых кнопок
  (под сообщением и под полем ввода, в том числе «Начать» в VK) и сообщение с
  кодом, которое сайт подставил в личный Telegram-аккаунт;
• контакт должен прийти по рекламному клику и не писать в проект до этого клика;
• засчитывается только первое собственное сообщение после клика: если лид уже
  писал раньше (в том числе до появления этого события), его следующие ответы —
  например, на рассылку — событие не создают;
• первое сообщение должно прийти не позже 7 дней после клика (окно атрибуции
  Meta по клику); подписчик, который впервые написал через месяц, — не диалог
  с этой рекламы;
• сообщения старше 7 дней (импорт истории) событие не создают — Meta такие
  события не принимает.

Браузерный пиксель на странице Contact не отправляет. Открытие Telegram с
лендинга (автооткрытие приложения и нажатие кнопки) уходит как ViewContent,
поэтому Contact в Meta — это только диалоги, а не переходы.

Строку dialog_started → Contact можно выключить переключателем в карточке
трекера.

Meta: событие принято, но конверсия не видна в рекламеMeta: событие принято, но конверсия не видна в рекламе

Принято Meta подтверждает приём события рекламной системой. Это не подтверждение,
что конверсия зачтена конкретной кампании. В журнале Napulse эти состояния разделены.

Для доставки Meta откройте диагностику данных сопоставления. Она показывает
наличие fbc, fbp, IP, User-Agent, ID пользователя, email, телефона, URL страницы
и времени события, а также помечает тестовые события. Значения идентификаторов
в этом блоке не раскрываются.

При рекламном переходе Napulse сохраняет исходный fbclid и формирует fbc со
временем исходного клика либо использует подходящую cookie _fbc. Эти данные
передаются дальше к связанной конверсии; время отправки CAPI не заменяет время
клика. Для органического перехода рекламный идентификатор искусственно не создаётся.

Если приём есть, а атрибуции нет:

1. Проверьте, что тестируете ссылку именно нужной подписной и нужного проекта.
2. Сверьте трекер сайта с Pixel ID рекламной кампании.
3. Проверьте наличие рекламного клика (fbc) в диагностике отправленного события.
4. Убедитесь, что событие не отмечено как тестовое.
5. Сравните событие и время с данными рекламной системы. При отсутствии fbc
   проверьте, пришёл ли исходный переход из рекламы и сохранились ли метки на редиректах.

Кнопка Тест проверяет канал серверной отправки. Для проверки связи с рекламой
нужен отдельный проход по рекламной ссылке до целевого действия.

UTM-ссылкиUTM-ссылки

Из меню карточки сайта (… → сгенерировать ссылку с UTM) открывается
Сгенерировать UTM-метку — генератор рекламных ссылок с метками.

• Заполните utm_source, utm_medium, utm_campaign и, при необходимости,
  utm_content, utm_term, utm_id.
• Готовые пресеты подставляют значения под систему: Google Ads,
  Яндекс.Директ, ВКонтакте, Facebook Ads, Target My.com, Telegram Ads
  или Свои значения.
• Опционально можно указать Pixel ID (активная Meta-привязка подставляется
  автоматически) и личный Telegram-аккаунт для MTProto-трекинга.
• На выходе — Ссылка для рекламы (полный URL) и Короткая ссылка с кнопками
  копирования.

Частые проблемыЧастые проблемы

• Нет трекеров: добавьте подключение кнопкой Добавить connection.
• События не доходят: проверьте статус трекера, CAPI/Access Token и Лог событий.
• События дублируются: не вешайте один и тот же пиксель и браузерным
  сниппетом, и через CAPI без дедупликации по event_id.
• TikTok skipped: missing_ttclid: трафик пришёл без ttclid — см.
  TikTok CAPI.

Связанные разделыСвязанные разделы

• TikTok CAPI: серверные конверсии
• Редактор сайта
• Визиты и аналитика