Колтрекинг: подмена номера и источники звонков

Колтрекинг (Call Tracking) это динамическая подмена номера (DNI, Dynamic Number Insertion) для маркетинговой атрибуции. Платформа показывает каждому посетителю сайта отдельный номер из вашего пула и затем связывает входящий звонок с тем источником трафика, из которого пришел этот посетитель. Так вы видите не просто «звонков было 40», а из какой рекламы, кампании и ключевого слова пришел конкретный звонок.

К звонку привязываются UTM-метки, идентификаторы кликов рекламных систем (gclid, yclid, fbclid), roistat, реферер, страница входа и текущая страница, а также устройство и браузер посетителя.

Что такое колтрекинг и зачем он нужен

Обычная схема «один номер на весь сайт» не дает понять, какая реклама приносит звонки: все вызовы выглядят одинаково. Колтрекинг решает это так:

1. посетитель открывает ваш сайт, скрипт собирает данные о его источнике;
2. посетителю показывается персональный номер из пула;
3. посетитель звонит на этот номер;
4. входящий вызов сопоставляется с сессией посетителя, и в отчете появляется источник звонка.

В результате вы можете честно сравнить каналы и кампании по реальным звонкам, а не по кликам.

Как включить колтрекинг

Фича выключена по умолчанию у всех тенантов. Включить ее может только платформенный администратор 4phone (роль SUPERADMIN или ADMIN) галкой Call Tracking в карточке тенанта, в разделе «Основная информация».

После включения вся настройка выполняется тенантом самостоятельно в кабинете на странице Колтрекинг (/dashboard/call-tracking).

Из чего состоит настройка

Колтрекинг строится из трех сущностей:

1. Сайт. Описывает площадку, на которой работает подмена: домен, CSS-селектор номера для замены, fallback-номер, время жизни назначения (TTL) и окно атрибуции в днях.
2. Пул номеров. Группа номеров DID, которые по очереди выдаются посетителям сайта.
3. Номера в пуле. Свободные номера DID, добавленные в пул. Именно их платформа показывает посетителям вместо статичного номера.

Пошаговая настройка

Шаг 1. Создайте сайт

На странице Колтрекинг добавьте сайт и заполните параметры:

Шаг 2. Создайте пул номеров

Пул это набор номеров, которые платформа выдает посетителям. Дайте пулу понятное имя: оно же будет использоваться как название кампании при прямых звонках (см. раздел про типы атрибуции).

Шаг 3. Добавьте номера DID в пул

Добавьте в пул свободные номера DID. Чем больше одновременных посетителей вы ожидаете, тем больше номеров нужно в пуле, потому что один номер в один момент закреплен максимум за одним посетителем.

Шаг 4. Установите скрипт на сайт

На странице Колтрекинг в кабинете есть готовый сниппет для копирования. Вставьте его на все страницы сайта перед закрывающим тегом </body>:

<script async src="https://api.4phone.uz/api/call-tracking/script.js?siteId=ВАШ_ID"></script>

Здесь siteId это идентификатор вашего сайта в колтрекинге. В кабинете сниппет уже содержит правильный siteId, поэтому проще скопировать его оттуда.

Как работает подмена номера

Когда посетитель открывает страницу, скрипт собирает данные о его источнике (UTM-метки, идентификаторы кликов, реферер, страницу входа, устройство и браузер) и запрашивает у платформы персональный номер. Затем происходит следующее:

1. Закрепление номера. Свободный номер из пула закрепляется за сессией посетителя на время TTL. Номера выдаются по приоритету.
2. Повторные визиты. Если тот же посетитель снова обращается за номером, ему отдается тот же номер, а его TTL продлевается.
3. Продление сессии. Пока вкладка открыта, скрипт примерно раз в 90 секунд продлевает сессию (keepalive). На скрытой вкладке продление ставится на паузу и возобновляется, когда посетитель вернется.
4. Защита от гонок. Выдача номера атомарна: один и тот же номер не будет одновременно показан двум разным посетителям.

Особые ситуации:

1. Все номера заняты. Если в пуле не осталось свободных номеров, посетителю отдается fallback-номер (ситуация POOL_OVERFLOW). Такой звонок не получит источник.
2. Колтрекинг выключен. Если фича отключена, скрипт отдает статичный fallback-номер (TRACKING_DISABLED) и ничего не записывает.

Окно атрибуции и типы атрибуции

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

Атрибуция работает по принципу last-touch (последнее касание). Звонок связывается с последним назначением номера, даже если TTL уже истек, но визит был в пределах окна атрибуции. По умолчанию окно равно 30 дням и настраивается в диапазоне от 1 до 180 дней. При совпадении назначение помечается сконвертированным.

Какие источники поддерживаются

К звонку привязывается широкий набор параметров атрибуции:

Где смотреть результаты

Данные трекаемых звонков попадают в два места:

1. Отчет колтрекинга на странице Колтрекинг (/dashboard/call-tracking). Здесь видно число звонков, отвечено и пропущено, с группировкой по источнику, каналу, кампании, ключевому слову, странице входа и номеру DID за выбранный период.
2. CRM. Источник звонка добавляется в заметки сделок и лидов в Bitrix24 и amoCRM, а также в переменные сценариев amoCRM (tracking_source, tracking_campaign и другие). Подробнее про подключение CRM в статье CRM-интеграции: amoCRM, Bitrix24, Webhook.

Частые вопросы и ограничения

1. Колтрекинг не показывает номера. Проверьте, что платформенный администратор включил Call Tracking, скрипт установлен на сайт, а CSS-селектор указывает на реальный элемент с телефоном.
2. Звонок без источника. Скорее всего, все номера пула были заняты в момент визита (показался fallback) либо звонок пришел на номер вне активного пула.
3. Источник «прилип» к пулу, а не к рекламе. Это атрибуция STATIC: посетитель позвонил без сессии (например, набрал номер вручную), поэтому кампанией стало имя пула.

Следом полезно открыть Как настроить номер DID и маршрут и CRM-интеграции: amoCRM, Bitrix24, Webhook.