Подключение Telegram-канала

Это руководство покажет, как подключить ваш Telegram-канал к AdTarget для автоматического отслеживания конверсий.

Предварительные требования

• Создан Telegram-бот
• Telegram-канал (вы должны быть администратором)
• Токен бота добавлен в AdTarget

Шаг 1: Добавьте бота в канал

Шаг 2: Подтвердите обнаружение канала в AdTarget

AdTarget автоматически обнаруживает ваш канал, когда вы добавляете бота администратором. Не нужно вручную вводить название или идентификатор канала.

1. После добавления бота администратором (Шаг 1) перейдите в панель управления AdTarget 
2. Перейдите в Settings вашего сайта и выберите вкладку Channels — ваш канал должен появиться автоматически в течение нескольких секунд
3. Отметьте галочку рядом с каналом и нажмите Save для привязки к сайту

4. При необходимости измените тип события конверсии (по умолчанию Lead)

Канал не отображается? Попробуйте удалить бота из списка администраторов канала и добавить его заново. Это повторно вызовет Telegram webhook, который AdTarget использует для обнаружения. Дополнительные советы см. в разделе Устранение неполадок ниже.

Шаг 3: Проверьте подключение

После добавления бота администратором канал появляется во вкладке Settings > Channels вашего сайта. Если бот будет удалён из канала, статус канала изменится на removed.

Для проверки подключения:

1. Вступите в канал с другого аккаунта
2. Проверьте AdTarget в течение 30 секунд
3. Вы должны увидеть событие вступления

Несколько каналов

Вы можете подключить несколько каналов к одному сайту AdTarget:

1. Добавьте бота администратором в каждый канал — каждый будет обнаружен автоматически
2. Перейдите в Settings вашего сайта, выберите вкладку Channels и отметьте каждый канал, который хотите привязать
3. Конверсии каждого канала отслеживаются отдельно

Совет: Используйте одного бота для всех каналов для упрощения управления.

Закрытые и открытые каналы

Закрытые каналы (Рекомендуются)

• Пользователи обязаны использовать инвайт-ссылку для вступления — другого способа нет
• AdTarget генерирует уникальную отслеживаемую инвайт-ссылку для каждого посетителя
• Когда пользователь вступает, Telegram включает инвайт-ссылку в webhook, позволяя AdTarget сопоставить вступление с исходным кликом по рекламе
• Результат: точность атрибуции близка к 100% и надёжные события CAPI для Meta

Открытые каналы

• Пользователи могут вступить через t.me/channelname, поиск в Telegram или пересланные сообщения — без использования вашей отслеживаемой инвайт-ссылки
• AdTarget по-прежнему генерирует уникальные инвайт-ссылки для каждого посетителя, но даже когда пользователь нажимает на них, приложение Telegram (особенно на Android) может молча преобразовать это в “прямое вступление”
• Когда это происходит, webhook Telegram не включает инвайт-ссылку, поэтому AdTarget не может сопоставить вступление с кликом по рекламе
• Такие вступления отображаются как органические в вашей панели управления — событие CAPI не отправляется в Meta

Почему это важно

Это известное ограничение Telegram Bot API : для открытых каналов поле invite_link в webhook ChatMemberUpdated часто отсутствует, даже когда пользователь действительно нажал на отслеживаемую ссылку. Клиент Telegram определяет открытый канал и выполняет прямое вступление вместо вступления по инвайт-ссылке.

На практике это означает:

• Атрибуция в открытых каналах может быть ненадёжной, особенно для пользователей Android
• Вступления, которые должны быть отнесены к вашей рекламе, могут отображаться как органические
• Алгоритм Meta не получит эти сигналы конверсий, что снизит оптимизацию рекламы

Наша рекомендация

Если точная атрибуция и отправка данных через Meta CAPI важны для ваших кампаний (обычно это так), используйте закрытый канал. Вы всегда можете разместить отслеживаемые инвайт-ссылки на посадочной странице — пользовательский опыт будет идентичным, но атрибуция будет гарантирована.

Настройки канала

Изменение конфигурации канала

1. Перейдите в Settings вашего сайта и выберите вкладку Channels
2. Нажмите кнопку Setup (или Edit) в строке канала, чтобы открыть диалог настройки
3. Обновите настройки по необходимости
4. Нажмите Save

Отвязка или удаление канала

Чтобы отвязать канал от сайта, снимите галочку во вкладке Channels и нажмите Save. Канал останется в вашем аккаунте, но перестанет отслеживаться для этого сайта.

Устранение неполадок

“Bot is not an administrator”

• Добавьте бота администратором канала
• Убедитесь, что разрешение “Пригласить пользователей по ссылке” включено
• Подождите 30 секунд и попробуйте снова

Канал не отображается в панели управления?

• Удалите бота из списка администраторов канала, затем добавьте заново
• Убедитесь, что бот добавлен как администратор, а не просто как участник
• Подождите до 30 секунд для получения webhook-уведомления

Вступления не обнаруживаются?

• Проверьте, что у бота есть права администратора
• Проверьте, вступив с другого аккаунта

Задержки событий?

• Telegram-вебхуки иногда имеют задержки
• Обычно события появляются в течение 5 секунд
• Если задержки постоянные, обратитесь в поддержку

Лучшие практики

Используйте понятные названия каналов: Давайте каналам понятные названия в AdTarget, чтобы легко идентифицировать их в отчётах.

Тестируйте перед запуском рекламы: Убедитесь, что отслеживание работает, вступив с тестового аккаунта, прежде чем тратить бюджет на рекламу.

Следите за статусом каналов: Периодически проверяйте вкладку Settings > Channels вашего сайта, чтобы убедиться, что каналы остаются активными.

Хранение инвайт-ссылок: Каждая инвайт-ссылка одноразовая и действительна в течение 7 дней после создания. Ссылки остаются активными в этот период, чтобы пользователи, которые кликнули на рекламу, но присоединились позже, всё равно были корректно атрибутированы. Через 7 дней Telegram автоматически деактивирует ссылку.

Следующие шаги

После подключения канала настройте интеграцию Meta Pixel для отправки событий конверсий обратно в Meta.