Що таке вебхуки та їх використання в відстеженні на стороні сервера

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

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

Якщо коротко, то вебхук (webhook) - це програмний код. Зазвичай він складається з двох частин - змінної та власне даних.

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

Щоб почати роботу з вебхуками на стороні сервера, ви повинні спочатку вирішити, який додаток ви хочете запустити і який додаток буде їх отримувати. Як правило, програма-відправник називається "джерелом", а програма-одержувач - "пунктом призначення". Після того, як ви вибрали обидві програми, наступним кроком буде налаштування параметрів вебхука для кожної з них.

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

Використовувати вебхуки для відстеження на стороні сервера напрочуд просто. За допомогою веб-хуків дані можуть автоматично відправлятися в серверний контейнер Google Tag Manager кожен раз, коли на вашому сайті відбувається подія або дія.

Найпоширеніший випадок використання веб-хука в серверному тегуванні - це відправка веб-хуків з CRM або CMS. Наприклад, при створенні, оновленні користувача, оформленні замовлення і т.д. можна відправляти ці дані на серверний GTM.

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

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

У цьому випадку за замовлення відповідає одна конкретна кампанія, але як її відстежити? Найочевидніший спосіб - запитати клієнтів, як вони знайшли ваш сайт. Вони можуть сказати щось на кшталт онлайн-реклами або назвати платформу, де вони його побачили. Але ця інформація не допоможе зрозуміти, яка саме кампанія або набір оголошень відповідальний за конверсію.

Відстеження таких замовлень можливе за допомогою вебхуків та тегів на стороні сервера. Щоразу, коли в CRM створюється нове телефонне замовлення, можна відправити на серверний Google Tag Manager вебхук з усіма даними про замовлення та клієнта. Після того, як серверний GTM отримає ці дані, ви можете поширювати їх в рекламній мережі. Якщо рекламна мережа зможе зіставити користувача, який здійснив офлайн покупку, з користувачем, який побачив ваше оголошення, то це замовлення буде відображено як офлайн-конверсія у відповідну кампанію.

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

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

1. Як відправити вебхуки на sGTM

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

У моєму випадку:

https://ss.wp-demo.stape.io - це server-side tagging URL 

/order_created - це шлях, який відрізняє мій вебхук, який надсилає дані щоразу, коли розміщується замовлення.

2. Як переглянути дані webhook в sGTM

Відправлення даних вебхука з CRM або CMS є відносно простим. Однак для точного налаштування тегів необхідно бачити дані вебхука в відладчику sGTM. Ймовірність того, що можна налаштувати теги без використання відладчика, низька.

За замовчуванням дані webhook в sGTM не відображаються. Для того, щоб зробити їх видимими, нам потрібно використовувати функціонал Preview HTTP header в відладчику sGTM та Stape. 

Для включення sGTM preview header відкрийте серверний контейнер Google Tag Manager -> натисніть preview -> натисніть три крапки в правому верхньому куті -> натисніть відправляти запити вручну -> скопіюйте X-Gtm-Server-Preview HTTP header.

Увійдіть до свого облікового запису Stape.io, відкрийте контейнер sGTM, перейдіть до Power-Ups та натисніть Use HTTP Header Config. 

Вставте скопійований Preview HTTP header з відладчика серверного Google Tag Manager і натисніть кнопку Зберегти.

Вищевказані дії дозволять вам бачити дані вебхука в відладчику сервера Google Tag Manager. Після того, як ви виконали налаштування, видаліть Preview Header з панелі power-ups stape sGTM. Наша система автоматично видаляє Preview Header через 1 годину після того, як ви його ввімкнули.

3. Як обробляти дані вебхука в серверному Google Tag Manager

Останнім етапом підготовки перед тим, як ви зможете в кінцевому підсумку відправити дані вебхука на рекламну або аналітичну платформу, є обробка даних вебхука в sGTM. Ми зробимо це за допомогою Data Client від stape. 

У sGTM клієнти несуть відповідальність за заявлення запитів та обробку даних запитів до даних подій.

Імпортуйте Data Client у контейнер sGTM. Першим кроком буде завантаження Data Client з GitHub. Після цього перейдіть до контейнера sGTM, відкрийте розділ "Шаблони" та натисніть "Новий клієнт". 

Натисніть три крапки та Імпорт. Далі оберіть шаблон Data Client, який ви завантажили з GitHub, та збережіть його.

Перейдіть на вкладку Клієнти та створіть нового клієнта. Виберіть тип клієнта - Data Client, додайте ім'я клієнта і перейдіть до пункту Налаштування прийнятого шляху. Додайте шлях, який відрізняє ваш вебхук. У моєму випадку це /order_created і натисніть зберегти.

Після цього відкрийте sGTM і перевірте, що вебхук був відправлений і Data Client успішно обробив запити.

4. Як використовувати дані webhook для встановлення sGTM-тегів

Цей крок дуже залежить від ваших цілей та технологічного стеку. Наприклад, ви можете надсилати офлайн-події в Facebook або Google Ads. Або ви можете повідомляти свій відділ продажів або маркетингу про нові замовлення, використовуючи Slack або Telegram тег для sGTM. 

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

Якщо ви відчуваєте, що заплуталися - звертайтеся до служби підтримки stape. Ми будемо раді Вам допомогти.