Що таке Facebook Conversion API (CAPI)?
Facebook Conversion API (CAPI) – це серверний трекінговий інструмент, який дозволяє напряму передавати події на сервери Facebook, минаючи клієнтську частину. Цей підхід набув особливої актуальності після впровадження iOS 14.5 та посилення правил приватності, коли традиційний піксель перестав ефективно збирати дані, а конверсії почали зникати. Саме тому сьогодні CAPI є незамінним інструментом для арбітражників, які прагнуть отримати достовірну інформацію про дії користувачів.
Використання CAPI дозволяє обійти численні блокування – адблокери та захист від відстеження в iOS не впливають на серверний запит, який надходить безпосередньо до Meta. Це гарантує, що дані про реальні події не будуть втрачені через відмову клієнтських технологій, таких як кукі або раптове закриття вкладки. Завдяки цьому Facebook отримує повну інформацію, що допомагає алгоритмам оптимізації працювати ефективніше, знижуючи вартість залучення клієнта (CPA) та підвищуючи рентабельність рекламних кампаній (ROAS).
Механізм роботи Conversion API
Процес впровадження CAPI можна умовно розбити на кілька етапів:
- Фіксація події на сервері
Коли користувач потрапляє на ваш лендинг, на сервері фіксується певна подія – це може бути покупка, генерація ліда, додавання товару в кошик або початок оформлення замовлення. - Формування та відправка запиту
Сервер створює JSON-запит із зазначенням параметрів події (назва, час, унікальний event_id, зашифровані дані користувача тощо) та відправляє його до API Facebook. - Обробка даних Facebook
Платформа зіставляє подію з користувачем і використовує отриману інформацію для оптимізації рекламних кампаній.
Приклад реалізації Conversion API на PHP
Для арбітражників, які працюють з вертикалями МФО чи гемблінг, критично важливо забезпечити коректне співставлення подій. Facebook вимагає наявності певних даних про користувача для точного аналізу. Найчастіше це – хешований email або номер телефону, але також рекомендується передавати додаткові параметри для підвищення точності співставлення, такі як ім’я, прізвище, user agent, user ip, а також параметри, що отримуються з cookie та клієнтських даних.
Обов’язкові та додаткові параметри
- Обов’язкові дані
Для успішного співставлення подій Facebook потребує хоча б один з обов’язкових параметрів у поліuser_data– хешований email (em) або номер телефону (ph). - Надважливі параметри для покращення співставлення
- fbp – значення cookie, яке зберігає інформацію про відвідування сайту користувачем. Цей параметр допомагає Facebook відслідковувати дії користувача та підвищувати точність співставлення.
- fbc – значення, яке містить дані про рекламну сесію (ідентифікатор кліку), що допомагає визначити, через яке оголошення користувач зайшов на сайт.
- Дані клієнта
- User Agent – інформація про браузер та пристрій користувача, що може бути використана для додаткового співставлення подій.
- User IP – IP-адреса користувача, яка також додає додатковий рівень перевірки та безпеки.
Перед інтеграцією переконайтеся, що дані надходять у відповідному форматі (наприклад, номер телефону без пробілів та спеціальних символів, email у нижньому регістрі).
<?php
// Обов'язкові параметри для роботи CAPI
$pixel_id = "YOUR_PIXEL_ID";
$access_token = "YOUR_ACCESS_TOKEN";
// Дані користувача, отримані з постбеку (наприклад) від CPA мережі або партнерки
$user_email = "user@example.com"; // Email користувача
$user_phone = "1234567890"; // Номер телефону користувача
$user_firstname = "Ім'я"; // Ім'я користувача
$user_lastname = "Прізвище"; // Прізвище користувача
// Додаткові параметри для покращення співставлення
$fbp = "fb.1.1558571054389.AbCdEfGhIjKlMnOpQrStUvWxYz"; // Значення cookie fbp (відстежує відвідування)
$fbc = "fb.1.1558571054389.IwAR2QX0xxxxx"; // Значення cookie fbc (ідентифікатор рекламного кліку)
// Дані клієнта: IP адреса та User Agent
$user_ip = $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
$user_agent = $_SERVER['HTTP_USER_AGENT'] ?? 'UserAgentPlaceholder';
// Формування даних для відправки події
$data = [
"data" => [[
"event_name" => "Purchase", // Наприклад, 'Purchase' для генерації ліда або 'Lead' для покупки
"event_time" => time(),
"event_id" => uniqid(), // Унікальний ідентифікатор події для уникнення дублювання
"user_data" => [
// Обов’язкові параметри (хешовані за допомогою SHA-256)
"em" => hash("sha256", strtolower(trim($user_email))),
"ph" => hash("sha256", preg_replace('/\D/', '', $user_phone)),
"fn" => hash("sha256", strtolower(trim($user_firstname))),
"ln" => hash("sha256", strtolower(trim($user_lastname))),
// Додаткові параметри для співставлення
"fbp" => $fbp,
"fbc" => $fbc,
],
"custom_data" => [
"currency" => "UAH",
"value" => 1500.00, // Наприклад, сума виплати по оферу
],
"event_source_url" => "https://yourwebsite.com/landing-page", // URL сторінки, де сталася подія
// Додаткові дані клієнта для підвищення точності співставлення
"client_ip_address" => $user_ip,
"client_user_agent" => $user_agent,
]]
];
// Виконання запиту до API Facebook за допомогою cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://graph.facebook.com/v12.0/{$pixel_id}/events?access_token={$access_token}");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$result = curl_exec($ch);
curl_close($ch);
?>
Перевірка роботи CAPI
Після налаштування сервера та інтеграції коду варто перевірити роботу CAPI. Це можна зробити у розділі Test Events у Meta Business Manager. Тут ви зможете переконатися, що тестова подія успішно передається та обробляється Facebook. Або встановити власні логи на сайт та переглянути $reponse від API Facebook вже після передачі даних.
Висновок
CAPI – це мастхев для арбітражників у 2025 році. Він повертає втрачені конверсії, забезпечує повноцінні дані для оптимізації реклами та робить рекламні кампанії більш точними. Якщо ви вкладаєте бюджет у Facebook і ще не інтегрували CAPI, зараз саме час це зробити, щоб максимально ефективно використовувати кожну гривню (або франклін) та не зливати бюджет даремно.
Готові качати траф? Погнали тестити! 🚀
Залишити відгук