Facebook Conversions API: налаштування та використання
Facebook Conversions API – що це таке?
Зрозумів, тримаю структуру максимально наближеною до вашого початкового тексту, без зайвих роздільників:
Conversions API (раніше відомий як Server-Side API) — це функціонал Facebook, який дозволяє передавати дані безпосередньо з вашого сервера на сервер Facebook.
Conversions API є певною мірою альтернативою більш звичному підходу client-side, при якому для відправки даних про події, здійснені користувачами на сайті, використовується розміщення на сторінках сайту js-коду пікселя Facebook.
За допомогою Conversions API можна налаштувати відстеження події, яка відбувається за межами сайту, наприклад, дзвінок. Також, використовуючи Conversions API, можна надсилати у Facebook дані про:
- переведення заявки з ліда в клієнта на основі етапів воронки в CRM-системі;
- факт реальної оплати покупки, а не просто відправку транзакції на сайті.
На основі подій Conversions API, так само як і подій пікселя, можна проводити подальшу оптимізацію рекламних кампаній.
Особливо актуальним освоєння Conversions API стає зараз, коли посилюється політика відстеження даних користувачів (напевно, вже всі, хто працює в рекламному кабінеті Facebook, зіткнулися зі сповіщенням про зміни підходу Apple щодо збору даних користувачів пристроїв з iOS 14).
Підготовка до налаштування Conversions API
Перед тим, як розпочати налаштування, переконайтеся, що у вас є Business Manager та піксель Facebook.
Business Manager — це інструмент Facebook, що дозволяє централізовано керувати різними рекламними об’єктами: кабінетами, сторінками, каталогами та іншим. Якщо Business Manager відсутній, створіть його (інструкція).
Піксель Facebook (Facebook Pixel) — це код відстеження (фрагмент коду JavaScript), за допомогою якого можна збирати інформацію про відвідувачів сайту та використовувати її для створення аудиторій ремаркетингу й оптимізації реклами у Facebook/Instagram. Якщо пікселя немає, необхідно його створити та встановити на сайт (інструкція).
Налаштування Conversions API
В розділі Events Manager
потрібно додати нову подію, вибравши у списку «Використання API Conversions».
Далі з’явиться вікно з вибором способу налаштування Conversions API – вручну або з використанням партнерської інтеграції:
Проверить,Перевірити, чи доступна інтеграція для потрібної вам платформи, можна за цим посиланням. Якщо такої немає, вибираємо “Впровадження API вручну”. Далі покроково потрібно вказати, які події та які параметри з цими подіями ви хочете надсилати до Facebook.
На останньому кроці ви можете вибрати інструкції розробнику або виконати налаштування самостійно.
При виборі самостійного налаштування відкриється посібник з реалізації:
Генерація маркеру доступу
Для реалізації API запитів нам потрібно буде згенерувати маркер доступу. Маркер доступу надає доступ до Conversions API. Його потрібно використовувати під час кожного виклику API.
Згенеруйте маркер доступу, а потім скопіюйте його та збережіть, оскільки маркер доступу у Facebook не зберігається.
Якщо раптом ви закрили керівництво або не зберегли маркер, нічого страшного, у меню генерації маркера можна перейти також у розділі “Events Manager” – “Налаштування” – блок “API Conversions”.
Відправка подій через API
Щоб надіслати свою першу тестову подію, перейдіть у Facebook Graph API Explorer.
Graph API Explorer — це інструмент Facebook, за допомогою якого можна виконувати API-запити та перевіряти відповіді на них. Посібник по роботі з Graph API Explorer
Для відправки події потрібно створити новий POST-запит.
Далі слід вказати актуальну версію API (зазвичай її вже вибрано за замовчуванням).
Після версії API додаємо ідентифікатор пікселя та після нього сегмент /events:
Ідентифікатор пікселя можна переглянути в розділі налаштувань.
У поле «Маркер доступу» вставляємо згенерований на минулому кроці маркер:
Щоб сформувати тіло запиту, потрібно перейти на JSON
і в полі для введення тексту вставити свої дані. Щоб не помилитись при складанні тіла запиту, зручно використовувати Payload Helper. У меню зліва можна вказувати необхідні для вашої події параметри, а в меню праворуч автоматично формуватиметься потрібний код у форматі JSON.
Крім того, в Payload Helper дуже зручно, що при натисканні на «Отримати код» відкриваються згенеровані варіанти коду різними мовами.
Сформований JSON слід скопіювати у поле Graph API Explorer.
І щоб інформація про відправлену подію відобразилася в режимі тестування в Events Manager, після закриття квадратної дужки потрібно додати параметр “test_event_code” зі значенням, яке згенеровано на вкладці тестування серверних подій в Events Manager.
В моєму випадку:
Тиснемо «Відправимо».
Якщо запит складено коректно, то віконці посередині з’явиться інформація у тому, що подія отримано.
Також тестова подія з’явиться на вкладці «Тестування подій» у Events Manager
Після того, як ви створили та протестували відправку потрібної події, ви можете реалізувати передачу даних на реальному проєкті самостійно або скласти ТЗ для розробника, який підтримує ваш проєкт.
Важливо: для подій на сайті, що передаються через Conversions API, обов’язково потрібно вказувати параметри client_user_agent, action_source та event_source_url. Для інших типів подій достатньо вказати параметр action_source.
З прикладами відправки події покупки, реалізованими на різних серверних мовах, можна ознайомитися у цьому розділі для розробників.
Корисні посилання з довідковою інформацією щодо подій та параметрів:
- Перелік усіх стандартних подій
- Перелік параметрів подій
- Параметри даних про клієнта
- Параметри користувацьких даних
- Про налаштування передачі параметрів fbp та fbc
Дедуплікация подій
Якщо за допомогою пікселя Facebook та за допомогою Conversions API надсилаються однакові події, системою виконується дедуплікація, тобто видалення дублікатів.
Те, що події є ідентичними, визначається на основі параметрів «назва події» (event_name) та «ID події» (event_id). Тому, щоб уникнути дублювання даних, слід обов’язково передавати ці параметри в обох каналах зв’язку.
При відправці події, ідентичної тій, що вже була надіслана, дубль буде видалено. У режимі тестування ви можете побачити таке сповіщення:
Про обов’язкові для дедупликації подій
Корисні матеріали по Facebook Conversions API
Інструкція по використанню Conversions API + опис параметрів
Інструкція з використання Conversions API + опис обов’язкових параметрів з налаштування + приклад коду відправки події покупки на Python
Введення Conversions API за допомогою серверного Google Tag Manager