Запланувати дзвінокСпробувати безкоштовно

Як налаштувати Facebook Conversions API + дедуплікацію подій і хешування даних користувача

Ira Holubovska

Ira Holubovska

Автор
Оновлено
24 берез. 2026 р.
Опубліковано
11 лют. 2021 р.
Також є

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

Протягом кількох років ми відстежували події на наших вебсайтах за допомогою коду JavaScript, SDK Facebook у додатках або завантаженням офлайн-подій. Але як відстежувати користувачів із блокувачами реклами, моніторити події за межами вашого вебсайту або продовжити термін дії cookies? Цього можна досягти, впровадивши Facebook Conversions API або Facebook Conversions API Gateway.

У цій статті ми розглянемо API API конверсії Facebook і покажемо, як налаштувати API конверсії Facebook через Google Tag Manager Server Container. Ви можете отримати більше інформації про Facebook Conversions API Gateway в нашому блозі. До речі, ознайомтеся з попередньо налаштованими шаблонами Stape для Meta CAPI. Тепер налаштувати ваш сетап простіше, ніж будь-коли: все вже зроблено і все готово для вас!

Що таке Facebook Conversions API?

Давайте подивимося, що таке Facebook Conversions API і як ми можемо використовувати його для покращення відстеження подій, атрибуції та збору даних у Facebook. Facebook Conversions API дозволяє надсилати будь-які події з вашого сервера на сервер Facebook.

Facebook CAPI має ту саму мету, що й Facebook Pixel, але базується на іншій технології. Політики та обмеження навколо FB CAPI роблять його більш придатним для потреб сучасного середовища відстеження. На відміну від Facebook Pixel, Conversions API не покладається на браузер користувача для надсилання інформації відстеження; все обробляється через хмарний сервер, підвищуючи безпеку та точність даних.

Якщо ми уважніше подивимося на посилання рекламних оголошень Facebook, то побачимо, що в кінці майже будь-якої URL-адреси FB додає свій додатковий параметр fbclid. Піксельний код на цільовій сторінці зберігає значення цього параметра у файлі cookie, а потім надсилає його разом з будь-якою подією Facebook. Поряд з ідентифікатором кліка (fbclid) Facebook використовує ідентифікатор браузера (fbp). Файли cookie fbp і fbc допомагають FB визначити, який користувач потрапив на ваш сайт і хто з них здійснив конверсію. 

FB може зіставляти користувачів за допомогою інших параметрів, таких як електронна адреса, номер телефону, ім’я/прізвище тощо. Чим більше даних користувачів ви надсилаєте до Facebook Conversions API, тим вище коефіцієнт відповідності ви отримуєте.

Які основні переваги Facebook Conversions API?

Відстеження на стороні сервера Facebook, або Facebook Conversions API, доступне вже кілька років. Однак починаючи з 2021 року, Facebook почав активніше просувати Conversions API. Якщо у вас є виділений представник Facebook, який керує вашим рекламним акаунтом, він, найімовірніше, порекомендує налаштувати Facebook Conversions API.

Ось найважливіші причини розглянути впровадження Facebook Conversions API. Деталі дивіться нижче.

Benefits of Facebook Conversions API
  1. Він може допомогти вам відстежувати користувачів, які встановили блокувачі реклами, тих, хто використовує Safari (або будь-який інший браузер з алгоритмами інтелектуального запобігання відстеженню), або людей, які відмовилися від відстеження FB в iOS 14/15. Це можливо, тому що запити надсилаються з сервера, а не з браузера користувача. І сторонні cookies не будуть заблоковані. З допомогою параметрів користувача, які ви надсилаєте разом із подіями FB CAPI, FB зіставить події з користувачами у своїй базі даних. У результаті ви матимете надійніші дані.
  2. Продовжений термін дії cookies. З Facebook Conversions API ви можете продовжити термін дії cookies Facebook до 6 місяців. Натомість, якщо ви не використовуєте FB Conversions API, Safari обмежує термін дії cookies до 1–7 днів.
  3. Conversions API надає вам більший контроль над вашими даними та краще розуміння шляху клієнта.
  4. Ви можете використовувати Facebook Conversions API для відстеження подій, що відбуваються за межами вашого вебсайту. Наприклад, телефонні дзвінки або офлайн-продажі.

Реальний приклад цінності Meta Conversions API

Інтегрувавши Conversions API разом із Meta Pixel, Ray-Ban змогла значно покращити свої рекламні результати. Поєднання призвело до збільшення охоплення на 36% у Facebook та Instagram порівняно з використанням лише Meta Pixel.

Ray-Ban case study results

Крім того, бренд зафіксував зниження вартості за 1 000 переглядів на 19% та зниження вартості за конверсію на 7%, що демонструє ефективність Conversions API в оптимізації кампаній та досягненні кращих результатів.

Способи налаштування відстеження на стороні сервера Facebook

Використання Meta Conversions API Gateway

Meta Conversions API Gateway — це найшвидше рішення для впровадження відстеження на стороні сервера Meta, яке не потребує спеціальних знань.

Використання серверного GTM

Один із найдоступніших способів — використання серверного Google Tag Manager (sGTM). З допомогою sGTM компанії можуть надсилати дані клієнтів безпосередньо на сервери Facebook.

Плюси налаштування Facebook CAPI через sGTM:

  • Гнучкі можливості налаштування
  • Можливість впровадження як чисто серверного, так і гібридного (веб + сервер) відстеження
  • Можливість збагачення даних

Мінуси налаштування Facebook CAPI через sGTM:

  • Потрібні технічні знання серверного Google Tag Manager
  • Потрібна хмарна інфраструктура для хостингу sGTM

У цій статті ми зосередимося на налаштуванні відстеження на стороні сервера Facebook через серверний GTM.

Як налаштувати Facebook Conversions API із серверним GTM?

Ми використовуватимемо серверний GTM для налаштування Facebook Conversions API. Для налаштування Facebook Conversions API вам знадобиться наступне:

Це відео показує, як налаштувати Facebook Conversions API за допомогою Google Analytics 4.

Як налаштувати Facebook Conversions API

2. Надішліть дані в серверний GTM-контейнер. Це можна зробити, налаштувавши серверний Google Analytics 4 або Data Tag/Data Client.

3. Перейдіть до серверного контейнера Google Tag Manager. Додайте тег Facebook Conversions API з Галереї шаблонів.

Facebook Conversions API tag for server GTM

4. Створіть тег Facebook Conversions API всередині sGTM. Виберіть Tag → Натисніть New → Оберіть тег Facebook, який ви додали у попередньому кроці.

Додайте ваш Facebook Pixel ID та Facebook API Access Token (ми рекомендуємо додати його як змінну, оскільки ці значення знадобляться для кожної події Facebook, яку ви хочете відстежувати). Якщо ви не знаєте свій Facebook API Access Token, зверніться до документації Meta.

Facebook Conversions API inherit from client

5. У вас є 2 варіанти налаштування нашого тегу Facebook Conversions API:

  • Override. У цьому випадку вам потрібно буде налаштувати події FB вручну. Ми розглянемо, як налаштувати події сервера FB вручну в шостому кроці. Це кращий варіант, але він вимагає більше часу і знань для його реалізації. Використовуючи його, ви зможете повністю контролювати корисне навантаження події і робити це відповідно до найкращих практик, щоб ваші веб-події FB і серверні події FB були ідентичними.
  • Inherit from client. У цьому випадку тег буде відповідати корисному навантаженню вашої події GA4/Data у стандартних подіях Facebook. Якщо тег не може зіставити подію GA зі стандартною подією FB, тег відправить її як кастомну подію. Все буде зроблено автоматично, вам не потрібно налаштовувати події FB.

6. Якщо ви обрали варіант override, вам потрібно буде використовувати події в GA4 або Data Tag/Data Client для запуску серверних подій Facebook. Подія pageview Facebook повинна спрацьовувати за кастомною подією page_view, заявленою певним клієнтом (наприклад, якщо ви обрали GA4 як джерело даних для серверного GTM, то потрібно використовувати подію page_view, коли ім'я клієнта дорівнює GA4).

Щоб налаштувати інші події, перейдіть у режим попереднього перегляду sGTM, виконайте дію на вашому вебсайті, яку хочете відстежувати у Facebook, та перевірте назву події, яку GA4 або Data Tag надсилає у ваш серверний контейнер.

На скриншоті нижче ми хочемо налаштувати подію Facebook ViewContent, коли хтось відкриває сторінку продукту на нашому вебсайті. Переконайтеся, що ви також надсилаєте разом із подією GA4 / Data Tag з веб-контейнера будь-які додаткові дані, які хочете використати для серверної події. У наведеному нижче прикладі також використовуються стандартні параметри Facebook eCommerce та дані користувача.

Для цього ми створили новий тег всередині серверного контейнера, встановили його на override, обрали стандартну подію ViewContent, додали API Access Token та Facebook Pixel ID. Ми також додали User Data та створили новий тригер із назвою події, що дорівнює view_item, та Client Name, що дорівнює GA4.

Tag configuration
Trigger configuration

7. Ви можете передавати кастомні параметри через поля Server Event Data Override, User Data та Custom Data. Ви можете надсилати дані користувача для збільшення показника збігу у Facebook через поле User Data. Зверніть увагу, що інформація про користувача, яку ви хочете надіслати у Facebook Conversions API, повинна бути хешованою. Наш тег Facebook автоматично хешує необхідні дані.

Ви також можете увімкнути Event Enhancement для використання HTTP-only secure cookie (gtmeec) з метою збагачення даних події. Коли ця функція увімкнена, тег зберігає дані користувача в cookies та збагачує події даними користувача, коли вони недоступні. Таким чином, ви можете підвищити якість збігу подій, що може покращити атрибуцію конверсій до кампаній.

Enable Event Enhancement in Facebook CAPI tag

8. Після завершення налаштування всіх подій Facebook відкрийте режим відлагодження Google Tag Manager та перевірте, чи правильно працюють події Facebook. Ви також можете перейти до тегу Facebook всередині серверного контейнера та додати Facebook test ID. Знайти test ID можна в Meta Events Manager на вкладці Test Events.

Test Facebook Conversions API

9. Після того, як ви налаштували та переконалися, що Facebook Conversions API працює правильно, вам потрібно видалити відстеження браузера FB або налаштувати дедуплікацію подій. Інакше ваші події будуть дублюватися.

Тестування Facebook Conversions API

Ви також можете налаштувати Facebook CAPI за допомогою шаблонів GTM

За допомогою Stape ви можете підвищити точність відстеження та покращити результати кампанії за допомогою тегів на стороні сервера.

Залежно від платформи, яку ви використовуєте, ви можете швидко та ефективно налаштувати відстеження за допомогою наших кастомних шаблонів. Дотримуйтесь покрокових інструкцій, щоб налаштувати Meta CAPI за допомогою серверного GTM для:

Незабаром з'являться шаблони та посібники для Wix, Shopware, Prestashop та інших. Дайте нам знати, якщо вам потрібен шаблон для іншої CMS.

Дедуплікація подій для Facebook Pixel та подій Conversions API

Facebook рекомендує використовувати і Pixel, і Conversions API для відстеження подій, але без дедуплікації подій дубльовані дані з браузера та сервера можуть спотворити результати. Дедуплікація гарантує збереження лише однієї події за рахунок використання унікальних ID подій, спільних для обох джерел. Правильне налаштування вимагає генерації та синхронізації цих ID між браузерними та серверними подіями, що можна перевірити в Events Manager Facebook.

Крім того, надсилання даних користувача через Conversions API покращує якість збігу та показники збігу подій, підвищуючи ефективність реклами. Дані користувача в ідеалі повинні надходити з data layer та відповідати політикам конфіденційності. Інструменти, такі як плагіни Stape, спрощують інтеграцію даних користувача для кращої оптимізації кампаній Facebook.

Надсилання параметрів користувача за допомогою Facebook Conversions API

Для зіставлення користувачів, які відвідують ваш вебсайт, з їхньою базою даних Facebook використовує User Data для Conversions API.

Facebook вимагає хешувати деякі параметри перед надсиланням, але вам не потрібно про це турбуватися; тег Facebook автоматично хешує всі дані перед надсиланням.

Чим більше параметрів користувача ви надсилаєте у Facebook, тим вищі шанси на збіг з користувачем, що призводить до вищого показника збігу подій.

Надсилання параметрів користувача з вашого вебсайту у Facebook — це делікатна тема, оскільки ви ділитиметеся даними користувача зі стороннім сервісом. Тому перед надсиланням цих даних у Facebook переконайтеся, що вони відповідають вашій політиці конфіденційності.

В ідеалі дані користувача повинні бути додані до data layer. Якщо це неможливо, спробуйте зібрати їх зі сторінки за допомогою кастомного коду JavaScript та надіслати разом із конверсіями або подіями, які вас цікавлять.

Наприклад, усі плагіни Stape для CMS (для Facebook CAPI для Shopify, відстеження на стороні сервера для WordPress, Magento 2 Google Tag Manager, додаток GTM для BigCommerce) додають data layer, який також містить дані користувача.

Ви можете легко отримати дані з data layer та додати їх до подій Facebook у веб-контейнері. 

Add data to Facebook events in a web container

Потім перенесіть необхідні дані до серверного контейнера (у payload GA4 або Data tag, залежно від того, що ви використовуєте). 

Transfer data to the server container

Нарешті, додайте ці дані до вашої серверної події Facebook.

Add data to the server-side Facebook event

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

Які найпоширеніші помилки Facebook Pixel та Conversions API і як їх виправити?

Зіставлення Event Name

За замовчуванням тег намагається зіставити стандартні події GA зі стандартними подіями Facebook. Якщо зіставлення неможливе, буде використано необроблену назву події з клієнта GA. Наприклад, якщо ви надсилаєте назву події на кшталт: gtag(‘event’, ‘UserLikedProduct’), ви побачите подію UserLikedProduct у менеджері подій Facebook.

Нижче наведено схему зіставлення подій GA з подіями Facebook, яку ми використовуємо в цьому тезі за замовчуванням:

page_viewPageView
add_payment_infoAddPaymentInfo
add_to_cartAddToCart
add_to_wishlistAddToWishlist
sign_upCompleteRegistration
begin_checkoutInitiateCheckout
generate_leadLead
purchasePurchase
searchSearch
view_itemViewContent
contactContact
customize_productCustomizeProduct
donateDonate
find_locationFindLocation
scheduleSchedule
start_trialStartTrial
submit_applicationSubmitApplication
subscribeSubscribe

Відстеження на стороні сервера Facebook: вирішені проблеми реальних користувачів Stape

1. Користувач у Спільноті помітив, що після переходу на відстеження на стороні сервера Facebook його аудиторія ретаргетингу була значно меншою за трафік GA4 (приблизно 15% match rate). Проблема полягала не в несправному відстеженні, а в нереалістичних очікуваннях: Facebook не може надійно зіставляти користувачів, використовуючи лише IP та User Agent. Рішенням стало дотримання рекомендованого Meta гібридного налаштування (браузер + сервер з дедуплікацією) та надсилання всіх доступних даних користувача (таких як email або ім'я, коли це можливо). Цей підхід покращує якість збігу та розмір аудиторії, тоді як чисто серверне відстеження обмежує потенціал ретаргетингу.

2. Багато користувачів у цій темі стикаються з проблемами відстеження на стороні сервера Facebook та зіставлення FBP/FBC, особливо при використанні сторонніх чекаутів. Використання шаблону Facebook CAPI від Stape на власному піддомені, запуск ключових подій на основному домені, впровадження гібридних браузерних+серверних подій для дедуплікації та, за потреби, використання webhooks вирішує більшість проблем. Завжди перевіряйте дані через мережеві інструменти браузера, а не покладайтеся виключно на Tag Assistant.

Висновок

Ось і все. Ми сподіваємося, що ви успішно перенесли відстеження Facebook на серверну сторону. Facebook Conversions API — це потужний інструмент для розуміння ваших клієнтів, відстеження їхнього шляху до конверсії та надання більшої кількості даних для оптимізації алгоритмів машинного навчання Facebook.

author

Ira Holubovska

Author

Ira має понад 10 років досвіду в цифровому маркетингу, з яких останні 5 років зосереджені на серверному відстеженні. Вона знає, як і коли використовувати це в різних маркетингових ситуаціях.

Коментарі

Спробуйте Stape для серверного трекінгу

Що відбувається?

Куди ми йдемо?

Увага!
Це зона для стендапу від песика.