Перейти до основного контенту
Усі колекціїAPI та Webhooks
Відстежувані сутності
Відстежувані сутності
Mariia Lobchenko avatar
Автор: Mariia Lobchenko
Оновлено протягом останнього тижня

Відстежувані сутності - це спеціальний функціонал, що дозволяє перехоплювати додаткові дані з вашого сайту за допомогою скрипту підміни та прив'язувати їх до сесії користувача. Завдяки цьому можна налаштувати передачу цих перехоплених параметрів у вашу CRM-систему або інші сервіси за допомогою методу Webhooks.

Давайте розглянемо приклад такої ситуації: припустимо, вам потрібно, крім ідентифікатора відвідувача Google Analytics, прив'язувати до сесії відвідувача також додатковий id, який генерує ваш скрипт.

Це працюватиме наступним чином:

  1. Для перехоплення сутності необхідно виконати налаштування ЛК Ringostat.

    Вкажіть назву даного ідентифікатора (параметра) та його налаштування в розділі "Коллтрекінг" - "Відстежувані сутності".

    Далі, при переході клієнта на сайт, скрипт підміни перехоплює цей параметр згідно з вказаною назвою та налаштуваннями. Наприклад, це ідентифікатор відвідування, який генерує ваш скрипт – r7k12_si (значення знаходиться у змінній).

  2. Перехоплений параметр r7k12_si передається до нашого сервісу та прив'язується до відвідувача в нашій системі.

  3. Після налаштування перехоплення сутності з вашого сайту, є можливість цю сутність передавати на зовнішні системи. Це можна зробити за допомогою вебхуків.

  4. Таким чином, Ringostat передає дані про дзвінок та відвідування вашого клієнта у зовнішню систему разом із додатковим параметром.


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


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

Тип Simple дозволяє задавати певне статичне значення додаткового параметра для кожного дзвінка. У цьому випадку значення, що задається в налаштуваннях сутності та кріпитиметься за кожним відвідуванням/дзвінком.

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

Налаштувати необхідну вам відстежувану сутність можна в кілька кліків:

  1. У розділі “Коллтрекінг” - “Відстежувані сутностіі” додайте нову сутність, натиснувши на відповідну кнопку.

  2. Введіть ім'я, тип і значення параметра, який хочете перехопити за допомогою скрипта.

    • Ім'я задайте відповідно до того, який параметр хочете перехоплювати.

    • Далі вкажіть Тип сутності: "Simple" або "Expression".

    • Встановіть Рівень збору* сутності: “Сесія” або “Перегляд сторінки”.

    • У полі Значення необхідно встановити параметр у тому вигляді, в якому він вказаний на вашому сайті.

*Значення перехопленої сутності, що відстежується, буде залежати від рівня збору, який ви встановили.
- При виборі перехоплення параметра на Рівні сесії його значення перезаписуватиметься при кожному перегляді сторінки. При дзвінку буде передано останнє перехоплене значення, якщо воно не дорівнює порожньому (наприклад, null). Використовуйте цей спосіб за замовчуванням.
- Рівень збору сутності Перегляд сторінки, що відстежується, на даний момент рекомендуємо не використовувати.


Далі ж цей параметр можна передавати на зовнішню систему за допомогою способу Webhooks, використовуючи його ім'я.

Щоб налаштувати передачу параметра вебхука, перейдіть до розділу "Інтеграції" - "Webhooks". Далі додайте новий або відредагуйте раніше створений вебхук, вказавши в ньому новий параметр.

Для цього:

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

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

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

Ви отримали відповідь на своє запитання?