Отслеживание рекламных звонков
Показывайте каждому посетителю сайта, пришедшему по клику из Google Ads или Meta Ads, номер телефона из пула, относите звонок к кампании, ключевому слову и объявлению.
Откройте Админ > Подключения > Отслеживание рекламных звонков (/admin/ad-tracking). Для просмотра нужно integrations:read, для изменений — integrations:write. Для отчёта нужно reports:read.
Настройка пула
- В разделе Пулы номеров нажмите Добавить пул. Пул относится к одной кампании или сайту. Задайте:
- Название и Платформа (Реклама Google, Реклама Meta или любая платформа).
- Резервный номер (когда пул занят) в формате E.164.
- Длительность сессии (секунды): как долго посетитель сохраняет номер, от 60 до 86400, по умолчанию 1800.
- Дополнительное время после сессии (секунды): как долго номер остаётся занятым, чтобы поздний звонок всё равно был засчитан, от 0 до 86400, по умолчанию 300.
- Пул включён.
- В разделе Номера нажмите Добавить номер и введите каждый DID, например
+525510000001. Номер принадлежит одному пулу. - Скопируйте Код для сайта на свой сайт:
<script async src="https://<ваш PBX>/api/v1/ad-tracking/public/<site_key>/snippet.js"
data-default-number="+525510000000"></script>
data-default-number — номер, который страница показывает сейчас. Скрипт заменяет его в ссылках tel: и в тексте, а также в любом элементе с data-mpbx-number на номер посетителя из пула.
Как назначаются номера
- Номер из пула получает только визит, в адресе которого есть идентификатор клика по рекламе (
gclid,gbraid,wbraid,fbclid) или параметры кампании (utm_campaign,utm_termкак ключевое слово,utm_contentкак объявление,utm_adgroupилиadset,utm_source). Остальные посетители видят номер страницы, поэтому поисковые роботы не могут исчерпать пул. - Посетитель сохраняет один и тот же номер, пока длится визит. Пока номер занят, он не выдаётся второму посетителю.
- Когда пул занят, показывается резервный номер, а звонки на него не относятся ни к какой кампании.
Отчёт
Звонки по кампаниям, ключевым словам и объявлениям группирует отслеживаемые звонки по полю Группировать по: Кампания, Кампания и ключевое слово или Кампания и объявление. Столбцы: звонки, отвеченные, время разговора (секунды). Звонки без атрибуции относятся к кампании (direct). Те же данные: GET /api/v1/reports/ad-tracking?by=campaign|keyword|ad&from=&until=.
Запись звонков через API
Завершённый звонок учитывается вызовом POST /api/v1/ad-tracking/calls (id звонка, набранный номер, звонящий, время начала, отвечен ли звонок и секунды разговора). Звонок сопоставляется с визитом, который в тот момент занимал набранный номер.
Что важно знать
- У публичного маршрута сессий нет ограничения частоты по адресу. Скрипт, добавляющий
?gclid=..., может занять номера пула до истечения визитов.