Теперь в рекламной рекламной офисе Telegram есть пиксель — инструмент для следования действий пользователя на сайте после перехода с помощью рекламы. Это означает, что вы можете:

• См. Приложения, покупки и другие действия непосредственно в объявлениях Telegram,

• Автоматически рассмотреть CPL и CPA,

• Не уменьшайте метрику, GA4 и другие системы систем.

Мы проанализируем, как это настроить — от установки кода до получения данных в интерфейсе Telegram.

Приветствую, Хабр! Сегодня я готовлю большой цикл статей на лейбле для менеджеров нашего рынка, решил опубликовать небольшие, но менее важные инструкции по урегулированию аналитиков для рекламы в телеграммах. Реклама в TG становится все более и более запрашиваемой, и чем точнее ваше выполнение менее точное, чем бюджет, который вы будете. =)

Что такое пиксель и как он работает

Telegram Ads Pixel — это небольшой сценарий JS, который вы публикуете на своем веб -сайте. Он передает информацию о действиях пользователя в рекламную фирму после перехода с помощью объявления. Например:

• Показать страницу,

• Отправка формы,

• Заказ и т. Д.

Важно: Pixel не хранит личные данные. Все собрано в совокупной форме.

Telegram Ads использует модель распределения после жизни. Это означает, что даже если пользователь только что увидел рекламу (но не щелкнул), а позже он нашел сам Сайт и выполнил действие — оно все еще учитывается.

Общая диаграмма параметров пикселя

Чтобы пиксель начал работать, вы должны сделать три вещи:

1. Установите базовый код на сайте.

2. Создайте событие (например, «Приложение») и получите код события.

3. Прочитайте мероприятие в объявлении, когда оно было создано.

Установка базового пикселя на сайте

Основной код является основным фрагментом кода, который должен быть размещен на всех страницах сайта. Он не следует за действиями, но готовит только сайт для их исправления.

Вот где это получить:

Перейдите в офис рекламы Telegram → Управление разделом мероприятия.

Нажмите «Создать пиксель».

Скопируйте базовый код, который появится в окне POP -UP.

Затем добавьте этот код в раздел

Ваш сайт. Мы проанализируем это с популярными примерами.

Примечание для крутых разработчиков =):

1. Сценарий принимает синхронно.

2. Инициализирует общее окно функции.tgp (…).

3. Задержанные вызовы (TGP., Которые) сохраняются до тех пор, пока сценарий не будет полностью загружен.

Основной сценарий должен быть размещен на всех страницах сайта, в противном случае события не будут отправлены (в SPA — рассматриваются отдельно, см. Ниже).

Очень простой вариант установки для сайта на Тильде

1. Идти в Tilda.ru/projectsВыберите нужный сайт → Настройки сайта.

2. Доступ к разделу снова → HTML -код для вставки в

   Полем

3. Вставьте код телеграммы в открытое поле.

4. Сохраните изменения и опубликуйте все страницы сайта.

Опция для продвижения через Google Tag Manager или непосредственно в код

Если вы используете GTM, вставьте базовый код в качестве пользовательского тега HTML, который работает на всех страницах.

Мы создаем событие для мониторинга действий (код события)

После установки базового кода пришло время создать событие, которое будет записывать необходимое действие — например, отправив форму или нажав кнопку «Поместить команду».

Меры:

В телеграмме рекламируются события.

Нажмите «Добавить событие».

В появлении окна определите:

• Название события (например,, Запрос) ,,,

• Тип события (например, Direct / Register — Это влияет только на название, а не на работу пикселя),

• Сохраните вершины.

Как передаются события

Telegram не раскрывает детали пикселя, но, согласно опыту, эти технологии используют один из стандартных протоколов отправки данных — скорее всего, Navigator.sendbeacon или Fetch. События доставки происходят на заднем плане, не блокируя основной поток.

Формат запроса, судя по названиям Devtools, минимальному JSON с идентификатором пикселя, событиями идентификаторов и, возможно, информации о браузере и сессии.

Мы настроили последующее событие на сайте

После создания события Telegram отобразит два кода:

• Базовый код (мы уже установили),

• Код события — это все, что необходимо для исправления конкретного действия на сайте.

Из кода события нам нужны идентификационные события — это набор символов, который следует сразу после TGP (‘Event’, ‘…’).

Как «прикрепить» событие к кнопке, чтобы отправить форму (например, Тильда):

1. Получите доступ к своему сайту и найдите кнопку, нажмите, к которой вы хотите следовать.

2. Нажмите на кнопку вправо → Показать код (в браузере).

3. Найдите значение внутри класса = «…» и запомните текст кнопки (например: t-submit, текст: Отправлять)

4. Доступ к настройкам сайта → плюс → HTML -код для головы.

5. Вставьте следующую модель кода, уже добавленную базовый код:

Заменять:

• ‘Event_id’ на идентификаторе вашего мероприятия,

• ‘ Class_knoka ‘в классе класса (с одной точкой в ​​начале),

• ‘Text_knoka’ — в тексту, отображаемом на кнопке.

7. Нажмите, чтобы сохранить. Вернитесь на «Мои сайты» и нажмите, чтобы опубликовать все страницы.

Проверьте, работает ли событие

Прежде чем мы начнем рекламу, мы позаботимся о том, чтобы событие действительно вызвано.

Метод через консоли браузера:

1. Откройте сайт.

2. Справа -клик → отображать вкладку «Код» → Консоль.

3. Заполните форму и нажмите кнопку.

Если все сделано правильно, сообщение появится в консоли: «Событие отправлено».

Вы также можете проверить рекламу Telegrams:

• Доступ к разделу Manage Events.

• Последний столбец события появится во время последней операции.

Для достижения, вот еще один список более точных методов проверки:

Проверьте вкладку сети

1. Откройте Devtools (F12) на нужной странице.

2. Доступ к вкладке сети.

3. Фильтр по ключевым словам: TGP, Event, Tag, Collection, Telegrampixel, Pixel, Event.

4. Выполните целевое действие (например, нажмите кнопку).

5. Посмотрите в списке Causion или Beacon, отправленный на сервер Telegram.

Как это выглядит:

• Тип запроса: тег или восстановление.

• Адрес: может быть тип https://ads-telegram-collect.telegram.org/…

• Статус: 200 OK или 204 Нет контента.

• Тело запроса будет содержать идентификационные события, идентификатор пикселя и метаданные.

Если вы не видите такие запросы, сценарий, вероятно, не загружался или что событие не вызвало.

Локальный моделируемый режим (эмуляция без отправки)

Если вы действительно не хотите отправлять события в Telegram (например, на этапе разработки), вы можете Zakhardkui влажную функцию, которая имитирует отгрузку, но ничего не делает.

Пример:

if (typeof window.tgp !== 'function') {
  window.tgp = function (...args) {
    console.log('📦 MOCK: tgp called with:', args);
  };
}

Это полезно, если вы работаете локально, не подключая сценарий телеграммы или в среде стадиона.

Уверенная упаковка для спа -салона

Создайте функцию, которая будет надежно и безопасно, чтобы вызвать событие:

export function sendTelegramEvent(eventId: string) {
  if (typeof window !== 'undefined' && typeof window.tgp === 'function') {
    window.tgp('event', eventId);
    console.log(`[Telegram Pixel] Sent event: ${eventId}`);
  } else {
    console.warn(`[Telegram Pixel] Not ready. Event "${eventId}" not sent`);
  }
}

Мы связываем мероприятие с рекламой телеграмм

Что ж, мы поняли все серьезные правила, чтобы установить пиксель, теперь мы должны связать событие в объявлении, иначе ничего не сработает. Для этого остается указать ИМЕЕТЭто событие, которое событие считается конверсией в начале рекламы.

Меры:

1. В рекламном офисе телеграммы, щелкните Создать новое объявлениеПолем

2. Наполнять:

   • URL, который вы хотите продвигать — Ссылка на сайт (не забудьте теги UTM),

   • Название веб -сайта — Название отображения в рекламе.

     

3. Прокрутите страницу почти до конца и найдите поле Конверсионное событиеПолем

   

4. В списке Drop -Down выберите желаемое событие (например, «приложение»), которое вы создали ранее.

Важный: Вы можете выбрать только одно событие для объявления.

После начала объявлений объявления Telegram начнут автоматически регистрировать все действия, выполненные на данном событии — прямо в статистике рекламы.

Что дальше: данные, оптимизация и тесты

Поздравляю! Вы будете настроить Telegram Ads Pixel, а теперь данные о приложениях, покупках и действиях других пользователей отображаются непосредственно в офисе Telegram, без необходимости использовать аналитические системы третьей части. События могут использоваться не только для статистики, но и в будущем — для оптимизации выбросов (если Telegram вводит самопропеллер).