Перейти к основному содержимому

Отслеживание рекламных звонков

Показывайте каждому посетителю сайта, пришедшему по клику из Google Ads или Meta Ads, номер телефона из пула, относите звонок к кампании, ключевому слову и объявлению.

Откройте Админ > Подключения > Отслеживание рекламных звонков (/admin/ad-tracking). Для просмотра нужно integrations:read, для изменений — integrations:write. Для отчёта нужно reports:read.

Настройка пула​

  1. В разделе Пулы номеров нажмите Добавить пул. Пул относится к одной кампании или сайту. Задайте:
    • Название и Платформа (Реклама Google, Реклама Meta или любая платформа).
    • Резервный номер (когда пул занят) в формате E.164.
    • Длительность сессии (секунды): как долго посетитель сохраняет номер, от 60 до 86400, по умолчанию 1800.
    • Дополнительное время после сессии (секунды): как долго номер остаётся занятым, чтобы поздний звонок всё равно был засчитан, от 0 до 86400, по умолчанию 300.
    • Пул включён.
  2. В разделе Номера нажмите Добавить номер и введите каждый DID, например +525510000001. Номер принадлежит одному пулу.
  3. Скопируйте Код для сайта на свой сайт:
<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=..., может занять номера пула до истечения визитов.