Все коллекции
API и Webhooks
Отслеживаемые сущности
Отслеживаемые сущности
Katerina Tverdochleb avatar
Автор: Katerina Tverdochleb
Обновлено больше недели назад

Отслеживаемые сущности — это специальный функционал, позволяющий перехватывать дополнительные данные с вашего сайта с помощью скрипта подмены и привязывать их к сессии пользователя. Впоследствии можно настроить передачу этих перехваченных параметров в вашу CRM-систему или другие сервисы с помощью метода Webhooks.

Давайте рассмотрим пример такой ситуации: допустим, вам нужно помимо идентификатора посетителя Google Analytics привязывать к сессии посетителя также дополнительный id, который генерирует ваш скрипт.


Это будет работать следующим образом:

  1. Для перехвата сущности необходимо выполнить настройку в ЛК Ringostat. Укажите название данного идентификатора и его настройки в разделе “Коллтрекинг” — “Отслеживаемые сущности”. Далее, при переходе клиента на сайт, скрипт подмены перехватывает этот параметр согласно указанному названию и настройкам. Например, это идентификатор посещения, который генерирует ваш скрипт - r7k12_si (значение находится в переменной).

  2. Перехваченный параметр r7k12_si записывается в наш сервис и привязывается к посетителю в нашу систему.

  3. После настройки перехвата сущности, есть возможность эту сущность передавать на внешние системы. Это можно сделать с помощью вебхуков.

  4. Впоследствии, Ringostat передаёт данные о звонке и посещении на внешнюю систему вместе с дополнительным параметром.


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


Настраиваемый параметр в отслеживаемых сущностях может быть двух типов: Simple и Expression.

Тип Simple позволяет задавать определённое статическое значения дополнительного параметра для каждого звонка. В этом случае значение, которые задаётся в настройках сущности и будет крепиться за каждым посещением/звонком.

Тип Expression даёт возможность перехватывать динамически изменяемую переменную из внешней системы/скрипта и крепить их за соответствующим звонком. Если во время посещения пользователя значение данного параметра изменится, Ringostat перехватит его и обновит его на новое.

Настроить необходимую вам отслеживаемую сущность возможно в несколько кликов:

  1. В разделе “Скрипт подмены” - “Отслеживаемые сущности” добавьте новую сущность, нажав на соответствующую кнопку.

  2. Задайте имя, тип и значение параметра, которое хотите перехватить с помощью скрипта.

    1. Имя задайте в соответствии с тем, какой параметр хотите захватывать.

    2. Далее укажите тип сущности: “Simple” или “Expression”.

    3. Задайте уровень сбора* отслеживаемой сущности: “Сессия” или “Просмотр страницы”.

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

*Значение перехваченной отслеживаемой сущности будет зависеть от уровня сбора, который вы установили.

  • При выборе перехвата параметра на уровне сессии его значение будет перезаписываться при каждом просмотре страницы. При звонке будет передано последнее перехваченное значение, если оно не равно пустому (например, null). Используйте данный способ по умолчанию.

  • Уровень сбора отслеживаемой сущности "Просмотр страницы" на данный момент рекомендуем не использовать.


Далее же данный параметр возможно передавать на внешнюю систему с помощью метода Webhooks, используя его имя.

Для настройки передачи параметра по веб-хуку перейдите в раздел “Интеграции” - “Webhooks”. Далее добавьте новый или же отредактируйте ранее созданный веб-хук, указав в нём новый параметр.

  1. В имени параметра задайте название, схожее с отслеживаемой сущностью, однако не аналогичное.

  2. Задайте значение параметра “custom” и в выделенном поле ниже укажите название отслеживаемой сущности.

После данных манипуляций необходимый вам дополнительный параметр будет так же передан системой Ringostat на внешнюю систему.

Нашли ответ на свой вопрос?