Инструкция

Как подключить канал в Telegram или Max, связать подписки с рекламой в Яндекс.Директе и где смотреть, откуда пришёл каждый подписчик или лид. Бот в Telegram: @jointrack_bot, в Max: «ТочкаВхода».

1Как это работает

Скрипт на лендингеЗапоминает переход: из какой рекламы пришёл человек и когда нажал кнопку канала.

Бот в каналеДобавлен администратором и видит, кто подписался и кто отписался.

СвязкаСервис находит переход, после которого человек подписался, и узнаёт источник.

Цель в МетрикеПодписка уходит в Яндекс.Метрику, и Директ может учиться на подписках, а не на кликах.

2Быстрый старт

Добавьте бота администратором в свой канал. Как это сделать
Отправьте боту /add_integration, войдите через Яндекс ID и выберите счётчик Метрики. Бот создаст цель подписки и пришлёт скрипт.
Вставьте скрипт в <head> лендинга.
Пришлите боту адрес лендинга и нажмите «Проверить лендинг».
В Директе добавьте цель подписки в стратегию кампании.

3Подключение канала

Канал в Max

Откройте канал, затем «Подписчики» и «Добавить подписчика». Найдите бота «ТочкаВхода» и добавьте.
В разделе «Администраторы» назначьте бота администратором. Из прав нужно только «добавлять подписчиков».
Канал появится в боте сам, бот напишет об этом.

Канал в Telegram

Откройте «Управление каналом», затем «Администраторы».
Добавьте администратором @jointrack_bot. Из прав достаточно «добавлять подписчиков».
Канал появится в боте сам. Если бот промолчал, нажмите «Канал добавлен»: он проверит, что видит канал и что вы в нём администратор.

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

4Интеграция с Яндекс.Директом

Отправьте боту /add_integration. Если каналов несколько, бот спросит, какой подключаем.
Нажмите «Войти через Яндекс ID». Сервис получает доступ к счётчикам Метрики, пароль он не видит.
Выберите счётчик лендинга или «Создать новый счётчик», тогда укажите домен лендинга, например example.ru.
Для канала Max по желанию отметьте «Кнопка через мини-апп». Что это даёт
Бот создаст в счётчике цель «Join Max · подписка в Max» или «Join TG · подписка в ТГ» и пришлёт по шагам: скрипт для лендинга, ссылку, на которую должна вести кнопка, и что проверить. Всё это потом есть и в личном кабинете во вкладке «Настройки».
Добавьте эту цель в стратегию кампании, чтобы Директ оптимизировался на подписки.

Подписка уходит в Метрику в течение минуты после того, как человек вступил в канал.

5Скрипт на лендинге

Скрипт выглядит так, у каждого канала свой номер. Бот присылает его при подключении интеграции, он же есть в личном кабинете во вкладке «Настройки»:

<script src="https://jointrack.ru/s/xxxxxxxxxxxx.js" defer></script>

Как поставить

Вставьте скрипт в <head> на каждой странице, где есть кнопка канала. Если у проекта канал и в Telegram, и в Max, скриптов два, вставьте оба.
Кнопка должна быть ссылкой на ваш канал:
Telegram: https://t.me/ваш_канал
Max, открытый канал: https://max.ru/имя_канала
Max, закрытый канал: ссылка-приглашение https://max.ru/join/... ровно такая, как в Max.
Кнопка может вести и на конкретный пост:
Telegram: https://t.me/ваш_канал/123
Max, открытый канал: ссылка на пост из «Копировать ссылку», вида https://max.ru/имя_канала/AaCmOgnmLIw.
У закрытого канала Max ссылок на посты нет, только ссылка на канал.
Пришлите боту адрес страницы и нажмите «Проверить лендинг»: бот покажет, видит ли он скрипт, кнопку и счётчик.

Кнопки конструкторов сайтов, которые открывают ссылку через JavaScript, тоже учитываются.
Не мешает переходу: человек сразу попадает в канал или на пост.
Если счётчик Метрики на странице не запущен, скрипт запустит его сам.
Подключается с defer и не задерживает загрузку страницы.

Поменяли ссылку на канал? Интеграцию пересоздавать не нужно. Поменяйте ссылку на кнопке лендинга и нажмите в боте «Проверить лендинг»: сервис сам подтянет новую ссылку канала.

Несколько лендингов на один канал

Лендингов может быть сколько угодно: основной, копии под разные кампании, тесты. Отдельная интеграция для этого не нужна, и заводить её не надо: поставьте на новую страницу тот же самый скрипт. Страница появится в отчётах сама после первых переходов, отдельно от других, в разделе «Лендинги».

Кнопка через мини-апп включается у каждой страницы отдельно, в кабинете, во вкладке «Настройки». Можно включить на одном лендинге и сравнить с обычной кнопкой на другом.
Настройка у адреса раздела, например сайт.ру/catalog, действует на весь раздел.
Новая интеграция нужна только тогда, когда у лендинга свой счётчик Метрики. Тогда в кабинете будет несколько скриптов, каждый для своего сайта, а статистика по каналу останется общей.

6Кнопка через мини-апп

Обычная кнопка ведёт человека с лендинга сразу в канал. Кнопка через мини-апп сначала на секунду открывает мини-приложение сервиса внутри Max, а оно уже открывает канал. Работает для каналов Max: в Telegram перед мини-приложением появляется экран предпросмотра, и переход получается слишком долгим.

Видно каждого, кто нажалМессенджер сам передаёт мини-приложению id человека. Подписка привязывается к рекламе точно, без подбора по времени.

Видно лидов без подпискиЧеловек нажал кнопку, не подписался и написал вам: перешлите его сообщение боту, и будет видно, из какой он рекламы.

Цель для обученияВ Метрику уходит цель «Join Max · открыл мини-апп». Её можно добавить в стратегию, если подписок мало.

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

Как включить

при подключении интеграции канала Max: галочка «Кнопка через мини-апп» на странице выбора счётчика;
для уже подключённого канала: личный кабинет, вкладка «Настройки», у нужной страницы кнопка «Включить мини-апп».

Кнопка у страницы меняет только эту страницу. Под таблицей есть общая настройка для всех остальных страниц с этим скриптом, в том числе новых. Перед её включением кабинет спросит подтверждение.

Цель в счётчике создаётся сама при первом включении. Скрипт на лендинге менять не нужно. Если кнопка вела на конкретный пост, после мини-приложения откроется этот пост.

Попробовать кнопку через мини-апп Откройте с телефона, где установлен Max: на секунду появится мини-приложение, потом откроется канал.

7Проверка лендинга

Пришлите боту адрес страницы, например example.ru, и нажмите «Проверить лендинг». В Telegram можно сразу командой: /check example.ru. Бот покажет:

стоит ли скрипт и к какому каналу он относится;
есть ли на странице кнопка канала и сколько таких кнопок; если кнопки нет, бот напишет, на какую ссылку она должна вести;
видно ли счётчик Метрики;
переходы, подписки и переданные в Метрику цели за последние три дня.

Кнопка «🔄 Обновить» проверяет страницу заново и обновляет то же сообщение.

8Как подписка связывается с рекламой

С лендинга

Ни Telegram, ни Max не сообщают сайту, кто нажал кнопку. Поэтому, когда человек вступает в канал, сервис ищет переход с лендинга за последние 30 минут. Чем ближе переход по времени, тем выше его вес. Учитывается и язык браузера и приложения.

Через мини-приложение

Кнопка через мини-апп на лендинге (для каналов Max) и ссылки для посевов внутри мессенджера открывают наше мини-приложение. Мессенджер сам передаёт ему id человека, поэтому подписка привязывается точно, без подбора по времени.

Какие бывают источники

Источник	Что значит
Яндекс.Директ	подписка после перехода с лендинга с рекламными метками
посев: название	подписка после перехода по ссылке для посевов с этим названием
без ссылки	перехода с лендинга или ссылки для посевов для этой подписки не нашлось
по приглашению	человек пришёл по пригласительной ссылке, которую выдавал не сервис
начальная аудитория	подписался ещё до подключения бота, отписался уже при нём

В Метрику уходит только подписка, которая привязана к переходу с рекламы.

9Ссылки для посевов

Отправьте боту /link и выберите канал.
Напишите название ссылки до 25 символов, например «паблик Вечерний Город», «обзор на YouTube», «сторис у блогера». Оно будет видно в отчётах.
Бот пришлёт две ссылки.

Для посевов внутри мессенджераОткрывает мини-приложение и сразу канал. Сервис точно знает, кто перешёл.

Для всего остальногоСоцсети, статьи, чужие сайты: jointrack.ru/r/код. Переход считается, подписка привязывается по времени.

Ссылка на конкретный пост

Telegram: добавьте в конец ссылки номер поста, например ?post=123.
Max, открытый канал: скопируйте в Max ссылку на пост («Копировать ссылку»). Она выглядит как max.ru/ваш_канал/AaCecyRoZKs. Добавьте её последнюю часть в конец ссылки: ?post=AaCecyRoZKs.
Max, закрытый канал (ссылка вида max.ru/join/...): ссылок на посты у него нет, переход ведёт в канал.

Ссылку можно создать и в личном кабинете, во вкладке «Настройки».

10Статистика в боте

Отправьте /stats и выберите канал или «Все каналы». Бот пришлёт сводку за последние 24 часа: сколько подписались и отписались, по каким источникам, какая конверсия из перехода в подписку и сколько целей передано в Метрику.

За другие периоды и с подробными разрезами статистика есть в личном кабинете.

11Утренний отчёт

Каждый день в 09:05 по Москве бот присылает администраторам канала отчёт за вчера. Отчёт получают те администраторы, которые запускали бота.

Если подписок за день не было, отчёт всё равно придёт с кнопкой «Больше не присылать пустых отчётов». Кнопка отключает пустые отчёты только для того, кто её нажал.

12История подписчика

Отправьте /user_info, затем id человека, его ник или перешлите боту любое его сообщение. Бот покажет:

в какие ваши каналы и когда человек подписывался, когда отписался;
откуда пришёл и с какими метками;
по кнопке «Подробнее»: город, источник по данным Метрики, сколько страниц посмотрел и сколько времени провёл на сайте, устройство.

Если человек не подписался, но переходил через мини-приложение, бот покажет и этот переход.

Видны только каналы, где вы сами администратор. Историю чужого канала бот не покажет.

13Личный кабинет

Отправьте боту /lk в Telegram или в Max. В Telegram ссылка на кабинет есть и в утреннем отчёте. Кабинет показывает каналы той платформы, из бота которой вы его открыли. По /lk он открывается на канале, где больше всего подписок за последние 7 дней, а по ссылке из отчёта на канале этого отчёта.

Ссылка личная, пересылать бесполезно. Перестала работать - отправьте боту команду ещё раз, придёт новая. Понадобится новая, снова отправьте /lk.

Если каналов несколько, они переключаются списком сверху. Рядом всегда видно, сколько сейчас подписчиков в канале. Разделы:

Раздел	Что показывает
Подписчики	кто подписался и отписался, поимённо, со временем и источником
Переходы	открытия лендинга, переходы в канал, подписки и отписки. Шаг таблицы выбирается: от 5 минут до дня, свежее время сверху. Ниже то же по устройствам
Лендинги	каждая страница: открытия, переходы в канал, открытия мини-аппа, процент перехода, подписки, процент подписки, отписки. Тестовые запуски и единичные срабатывания на чужих сайтах собраны в серую строку внизу
Метки	кампании, группы, объявления, ключевые фразы, регионы, устройства, тип площадки и любые другие ваши метки. Нажмите на значение, чтобы оставить только его и разобрать дальше, например кампанию по регионам
Источники	подписки по источникам и сколько человек осталось в канале, сайты, с которых пришли на лендинг, посевы
Поиск по id	до 200 id или ников за раз: канал, статус, источник, кампания, регион, страница, устройство
Настройки	счётчик Метрики, скрипт для лендинга и ссылка для кнопки (с копированием), цели, которые передаёт сервис, кнопка через мини-апп для каждой страницы (каналы Max), ссылки для посевов: создать, переименовать, удалить

Статистика по списку

Во вкладке «Поиск по id» вставьте id своих клиентов или лидов и нажмите «Показать статистику только по ним». Все разделы пересчитаются только по этим людям: из каких кампаний, объявлений и регионов они пришли, на каких лендингах были. Список нигде не сохраняется, он есть только в открытой вкладке браузера.

Ссылки для посевов в кабинете

У каждой ссылки есть «изменить»: там можно поменять название или удалить ссылку. После переименования статистика по ссылке сохраняется под новым названием. Удалённая ссылка перестаёт открывать канал, а те, кто уже пришёл по ней, остаются в статистике.

Сортировка и Excel

Любую таблицу можно отсортировать по любому столбцу: нажмите на заголовок, повторное нажатие меняет направление. Кнопка «Скачать в Excel» выгружает таблицы раздела файлом.

14Метки в объявлениях

Чтобы в кабинете были кампании, объявления, регионы и площадки, добавьте в Директе в параметры URL кампании такой шаблон:

utm_source=yandex&utm_medium={source_type}&utm_campaign={campaign_id}_{campaign_name}&utm_content={ad_id}_{gbid}_{device_type}_{region_name}&utm_term={keyword}&place={source}

Часть шаблона	Что появится в кабинете
`{source_type}`	тип площадки: поиск или РСЯ
`{campaign_id}_{campaign_name}`	кампания: название и номер
`{ad_id}_{gbid}`	объявление и группа объявлений
`{device_type}`	устройство: телефон, компьютер, планшет
`{region_name}`	регион, где показано объявление
`{keyword}`	ключевая фраза или автотаргетинг
`{source}`	площадка: сайт или приложение, где показано объявление

Другие метки вида utm_... тоже появятся в кабинете под своим именем.

15Telegram и Max одного проекта

Если у проекта есть канал и в Telegram, и в Max, подключите оба. После интеграции бот предложит объединить их в одну кнопку статистики, и в /stats они будут рядом.

16Имена подписчиков

Всё, что бот отправляет через Telegram (отчёты, статистика, история подписчика), приходит без имён и ников подписчиков. Имена видны в личном кабинете на jointrack.ru и в боте в Max. Так устроено по политике конфиденциальности сервиса.

Политика конфиденциальности · Согласие на обработку данных · Оферта

17Все команды бота

В Max те же действия вынесены кнопками под сообщением бота.

Команда	Что делает
`/stats`	статистика за последние 24 часа по каналу или по всем
`/channels`	каналы на трекинге и подключён ли у них лендинг
`/link`	ссылка для посевов
`/lk`	ссылка в личный кабинет
`/add`	как подключить новый канал
`/add_integration`	интеграция с Яндекс.Директом
`/user_info`	история подписчика по id, нику или пересланному сообщению
`/check адрес`	проверка лендинга (можно просто прислать адрес)
`/support`	связаться с поддержкой
`/help`	что умеет бот

18Частые вопросы

Почему переходов больше, чем подписок?

Переход это нажатие кнопки канала на лендинге. Часть людей открывает канал, смотрит и не подписывается.

Почему у подписки источник «без ссылки»?

Для неё не нашлось перехода с лендинга или ссылки для посевов за 30 минут до вступления. Такое бывает, когда человек нашёл канал сам.

Работает ли с Тильдой и другими конструкторами?

Да. Скрипт вставляется в <head>, а кнопки, которые конструктор открывает через JavaScript, тоже учитываются. После вставки проверьте страницу в боте.

Когда подписка появится в Метрике?

Сервис отправляет цель в течение минуты после вступления. Дальше отчёты Метрики обновляются в своём темпе.

Человек написал менеджеру, но не подписался. Можно узнать, откуда он?

Если он переходил через мини-приложение, да: перешлите его сообщение боту. Если нажимал обычную кнопку на лендинге и в канал не вступил, связать его сообщение с переходом нечем. Поэтому для таких лендингов есть кнопка через мини-апп.

Почему в списке лендингов оказался чужой сайт?

Скрипт сообщает адрес страницы, который присылает браузер. Изредка браузер присылает чужой адрес: предпросмотр конструктора, рекламный сервер, другой сайт. Это единичные срабатывания без нажатий кнопки. В разделе «Лендинги» они собраны в серую строку внизу, а в настройках не показываются.

Нажал кнопку, мессенджер не открылся. Можно нажать ещё раз?

Да, кнопка открывает канал при каждом нажатии. Переход при этом засчитывается один раз.

Кто видит данные моего канала?

Администраторы канала и сервис. Бот проверяет права при каждом запросе истории и при входе в кабинет.

19Поддержка

Что-то не работает или есть вопрос: команда /support в боте или напрямую в Telegram и Max.