План статті
- Що таке Facebook Conversions API, навіщо його налаштовувати та чому не можна обійтись пікселем Facebook
- Як скласти ТЗ програмісту
- Як налаштувати Facebook (c)API на платформі Хорошоп
- Як налаштувати Facebook (c)API на платформі OpenCArt
- Як налаштувати Facebook (c)API на платформі WordPress (WooCommerce)
- Як налаштувати Facebook (c)API на платформі Prom.ua
Що таке Facebook Conversions API і як він допомагає бізнесу? Навіщо його налаштовувати та чому не можна обійтись пікселем Facebook
Почнемо з того, що чим більше ви маєте даних та чим якісніше вони, тим краще оптимізується ваша реклама, та тим вище стає її ефективність та окупність інвестицій. Facebook (c)API як раз допомагає покращити якість даних та впливає на ефективність оптимізації рекламних кампаній.
Для розуміння визначимо що собою являє та як працює Facebook Pixel.


Facebook (Meta) Pixel — це скрипт (фрагмент коду), який ви додаєте на свій сайт.
Facebook Pixel встановлює файли cookie й активує їх для моніторингу користувачів. Цей процес відбувається безпосередньо в браузері відвідувача, тому цей метод відомий як відстеження на стороні клієнта.
Це також є прикладом відстеження третьою стороною (third-party tracking), оскільки дані передаються третій стороні (Facebook), про що можливо ваш відвідувач не знає. Браузери намагаються блокувати відстеження третьою стороною для забезпечення приватності користувачів.
Facebook (c)API це метод відстеження подій Facebook на стороні сервера. Він забезпечує вищу якість даних і контроль над відстежуваною інформацією порівняно з пікселями Facebook.
За допомогою Facebook (c)API рекламодавець може обійти обмеження браузера та передає дані безпосередньо з сервера. Тобто сам процес відстеження відбувається не в браузері, а на сервері. Ви маєте повний контроль над даними про користувачів або події, які надсилаються через сервери.
AdBlockers або Intelligent Tracking Prevention (ITP) не можуть отримати доступ до даних на сервері тегів, який передає інформацію в Facebook за допомогою технології CAPI.
Ще однією значною перевагою FB CAPI є те, що він використовує файли cookie першої сторони, тоді як FB Pixel оперує з файлами cookie третьої сторони.
Кожного разу, коли користувач з рекламної кампанії Facebook відвідує ваш сайт, Facebook створює два типи cookie:
- fbp (ідентифікатор браузера)
- fbc (ідентифікатор кліка).
Ці файли cookie створюються з домену facebook.com і вважаються сторонніми (оскільки ваш домен не генерував ці файли cookie).
Коли користувач повертається на ваш сайт і здійснює конверсію, Facebook використовує файли cookie fbp і fbc для відстежування користувачів у межах кампаній.
Завдяки ITP термін життя таких сторонніх файлів cookie скорочується до 1 або 7 днів. Якщо користувач натисне на ваше оголошення і повернеться через 7 днів, щоб здійснити покупку, FB Pixel не зможе отримати доступ до куки fbc і fbp, оскільки ITP видалив їх.
У підсумку, хоча Facebook Pixel зможе простежити цю конверсію і показати її в менеджері подій Facebook, вона не буде пов’язана з кампаніями Facebook, які були відповідальні за конверсію.
Facebook Conversion API може встановлювати файли cookie першої сторони, якщо URL сервера тегів розташований на вашому домені.
У цьому випадку файли cookie fbp і fbc створюються з вашого домену, вважаються першою стороною і зберігаються до 2 років.
Це має значний вплив на атрибуцію кампаній FB.
Щоб підсумувати вищеописане, подивимось на наступну таблицю.
Принципова різниця між Facebook Pixel та Facebook (c)API
Як бачимо, Facebook (c)API потужний інструмент для відстежування та покращення ефективності реклами, то що ж обрати?
Facebook наполегливо рекомендує використовувати обидва способи відстеження. Так ви будете мати можливість отримати найбільш релевантні дані.
Але якщо ваш ресурс надсилає одні й ті самі дані двома методами: через Facebook Pixel та Facebook (c)API, події можуть дублюватись, через те, що система буде отримувати одні й ті сами дані.
Тому не варто забувати про налаштування такої важливої функції, як дедуплікація подій. Це дозволить відсіяти дублікати та покращити якість даних, які потрапляють в систему. Про неї розповімо далі.
Основна причина використовувати як Facebook Pixel, так і Facebook (c)API полягає в тому, що при комбінуванні методу сервер + браузер, ви будете мати 2 джерела даних. Але обов’язково переконайтесь, що всі налаштування виконані вірно. В протилежному випадку є ризик мати завищені показники у звітах.
Facebook Conversions API дозволяє бізнесам точно відстежувати дії користувачів на сайті, що дає можливість покращити таргетинг рекламних кампаній. Важливо налаштувати його відповідно до специфіки вашого бізнесу, адже для e-commerce важливо відслідковувати покупки, а для сервісів – реєстрації або підписки.
Як скласти ТЗ програмісту для налаштування Facebook (c)API
Типові помилки при налаштуванні Conversions API включають: некоректне визначення подій, неправильне налаштування серверних запитів або відсутність відповідних прав доступу до акаунта. Уникайте цих проблем, ретельно перевіряючи налаштування та тестуючи API перед запуском.
Частину статті про встановлення та налаштування Facebook (c)API почнемо з того, як скласти технічне завдання для вашого програміста у випадку якщо ваш сайт створено не на CMS/конструкторі.
Подивимося на обов’язкові пункти, які повинні бути в ТЗ, а саме:
- ID Facebook Pixel
- Токен
- Інформація про події, які необхідно передавати
- Інформація про необхідні параметри для передачі
- Інструкція з налаштування дедуплікаціі подій
- Інформація про fbp и fbc
Як знайти ID Facebook Pixel ви скоріш за все знаєте, але про всяк випадок додаємо інструкцію.
1-й варіант: Налаштування Facebook Business Manager → Джерела даних → Набори даних


2-й варіант: Усі інструменти → Менеджер подій → Налаштування → Ідентифікатор набору даних




Інструкція — як створити Facebook Токен?
Для цього переходимо в розділ Усі інструменти → Менеджер подій → Налаштування прямої інтеграції → Generate access token




Після того, як токен буде згенеровано, натисніть на нього для копіювання.


Далі в ТЗ зазначаємо наступну інформацію:
Щоб надіслати нові події, зробіть POST-запит до цього API-інтерфейсу / events за цим шляхом:
https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events?access_token={TOKEN}.
Коли ви публікуєте, Facebook створює нові серверні події.
Приклади POST-запиту можна переглянути за посиланням: посилання
Які події та параметри слід передавати?
Ви можете налаштувати відстеження будь-якої події, як стандартних подій (Purchase, Add to Cart, Initiate Checkout, Complete Registration, Lead, Search, Contact), так і кастомних подій. Оберіть ті події, які відповідають специфіки вашого сайту. Розглянемо 2 приклади:
Lead:
тригер: відправка форми реєстрації
Event parameters:
- Event time
- Event name
- Event source URL
- Action source
- Event ID
Customer information parameters:
- Email address / Phone nubmer
- First name
- Client IP address – do not hash
- Client user agent – do not hash
- Browser ID (fbp) cookie – do not hash
- Subscription ID – do not hash
- Click ID (fbc) cookie – do not hash
Purchase:
тригер: спрацьювує при переході на “thank you page” та спрацьовує для усих типів покупки (наприклад: покупка в 1 клік і т.д.)
Event parameters:
- Content type
- Content IDs
- Event time
- Event name
- Event source URL
- Action source
- Event ID
- Number of items
- Currency
- Value
Customer information parameters:
- Email address
- First name
- Surname
- Phone number
- Client IP address – do not hash
- Client user agent – do not hash
- Browser ID (fbp) cookie – do not hash
- Subscription ID – do not hash
- Click ID (fbc) cookie – do not hash
Відповідно до цих прикладів ви можете налаштувати необхідні вам події, а параметри, які потрібно передавати, визначайте відповідно до даних, які ви можете передати.
Посилання на інформацію від Facebook: посилання
Дедуплікація подій
Наступний важливий пункт ТЗ — дедуплікація подій. Як ми уже зазначили в першій частині статті, передача одних і тих самих подій комбінацією методів браузер + сервер може призвести до їх дублювання.
Щоб цього не сталось, треба обов’язково треба налаштувати дедуплікацію. Як це зоробити, детально описано в мануалі від Facebook за посиланням: посилання
Хочемо лише зазначити декілька моментів, а саме:
Для уникнення подвійних подій, що надсилаються через браузерний піксель Facebook та серверний Conversions API, необхідні параметри EventID та назва події (Event name). Значення eventID, отримане від пікселя, має співпадати з event_id, отриманим від сервера.
Дедуплікація відбувається у таких випадках:
- Значення eventID події пікселя Facebook співпадає з event_id на сервері.
- Значення event події пікселя Facebook співпадає з event_name на сервері.
Якщо обидві ці умови виконані для пари подій, перша подія зберігається, а наступна, що була відправлена після неї, видаляється.
Якщо події з сервера та браузера отримані приблизно в один і той же час (з інтервалом не більше ніж п’ять хвилин), перевага надається події браузера.
Додатково можна прикріпити посилання на інформацію про fbp та fbc Parameters: посилання
Додаткові корисні посилання для вашого програміста з налаштування Facebook (c)API:
- Документація Conversions API (Server-Side API) — посилання
- Інструкція з надсилання подій через Conversions API (Server-Side API) — посилання
- Дедуплікація подій сайту і сервера — посилання
- Payload Helper для Server-Side API — посилання
Як налаштувати Facebook (c)API на самописному сайті без програміста
Але якщо у вас немає бажання впроваджувати Conversions API на ваш сайт через програміста, тобто більш просте рішення – налаштування Conversions API Gateway за допомогою Stape.
Stape коштує всього 10 доларів на місяць за один піксель, а налаштування дуже просте. Для цього вам необхідно:
- Зареєструватися в Stape
- Перейдіть за посиланням, щоб прийняти запрошення на налаштування API-шлюзу
- Створіть пароль для API-шлюзу
- Пройдіть кроки мета-авторизації (виберіть свій піксель)
- Зачекайте до 30 хвилин, поки з’являться дані
Як налаштувати Facebook (c)API на платформі Хорошоп
В цій частині статті розглянемо як налаштувати Facebook (c)API, якщо ваш сайт створено на платформі Хорошоп.
Перед тим, як переходити до налаштування Facebook (c)API, переконайтесь що на вашому сайті підключений Facebook Pixel. Якщо його нема, встановіть його через розділ Маркетинг → Маркетингові сервіси




Після цього, можна переходити до налаштування Facebook (c)API.
Переходимо у Events Manager. У розділі API Conversions згенеруйте та скопіюйте маркер доступу.




Повертаємось в адмінку Хорошоп та переходимо Налаштування → Загальні налаштування → Facebook Conversion API. Додаємо маркер (токен) у спеціальне поле та тиснемо Зберегти.


Як налаштувати Facebook (c)API на платформі OpenCart
Для цього нам знадобиться спеціальний плагін, який можна встановити за посиланням: посилання
Базова вартість плагіну – $27.99. Але ми рекомендуємо також обрати ще додаткові опції:
- Адаптація замовлення в 1 клік (якщо у вас це є на сайті)
- Довічний доступ к підтримці та оновленням
Після встановлення плагіна переходимо в адмін-панель сайту → розширення → модулі


Знаходимо Remarketing All In One Pro та тиснемо на олівець.


Далі діємо за інструкцією на скрінах.










Зберігаємо зміни:


Як налаштувати Facebook (c)API на платформі WordPress (WooCommerce)
Щоб налаштувати Facebook Conversion API спершу вам треба встановити плагін посилання (якщо це ще не зроблено).
Далі переходимо в розділ Маркетинг → Facebook → тиснемо Get Started


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


Якщо все пройшло успішно, ви побачите дані вашого акаунту.
Як налаштувати Facebook (c)API на платформі Prom.ua
Переходимо у Events Manager. У розділі API Conversions згенеруйте та скопіюйте маркер доступу.




Авторизуйтесь в адмін-панелі prom.ua. Перейдіть у розділ Ретаргетинг на Facebook/Instagram. Вставляємо наш скопійований маркер доступу у поле Маркер доступу API Conversions.
Післямова (замість висновків)
Як ви вже встигли зрозуміти, Facebook Conversion API важливий елемент для відстежування подій та подальшої оптимізації рекламних кампаній.
Ви звісно можете обійтись лише пікселем, але, як бачимо, до такої передачі даних є багато питань стосовно кукіс та спрацьовування за умови присутності блокувальників реклами у браузері тощо.
Тому наша рекомендація — використовувати методи сервер + браузер спільно, якщо звісно є така можливість.
У цій статті ми намагались дати якомога більше корисної інформаціі стосовно Facebook Conversion API. Сподіваємося нам це вдалося.
Якщо у вас залишились питання чи якщо ви хочете обговорити ваш проєкт, обов’язково напишіть нам або скористайтеся формою зворотного зв’язку.
Дякуємо за ваш час та високих вам конверсій!







