Facebook Conversions API: Посібник із впровадження на 2026 рік

Автор: Marcus Chen

Спеціалісти з перформанс-маркетингу Перевірено старшими медіабаєрами

Коротка відповідь AI

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

Опубліковано 10 липня 2026

12 хв читання · Налаштування

Facebook Conversions API (CAPI), це серверний компаньйон для браузерного пікселя. Після того, як iOS 14.5 зруйнувала відстеження на основі браузера, CAPI став єдиним способом відновити конверсії, які Meta втрачала. У 2026 році рекламодавці, які використовують лише піксель, втрачають 30-60% атрибутованих конверсій. Цей посібник охоплює чисте впровадження CAPI від початку до кінця.

Що насправді робить CAPI

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

• Відновлює конверсії iOS. Користувачі з обмеженнями ATT все одно ініціюють серверні події.
• Оминає блокувальники реклами. Події між серверами не блокуються.
• Вища якість даних. Серверні події можуть включати ідентифікатори першої сторони (хешована електронна пошта, телефон, ID клієнта) для кращого зіставлення.
• Краща дедуплікація. У поєднанні з пікселем за допомогою event_id, Meta дедуплікує та враховує кожну конверсію один раз.

Три шляхи встановлення

1. Вбудовані інтеграції платформ (найпростіший)

Shopify, WooCommerce, BigCommerce, Magento, Wix і Squarespace мають вбудовані конектори CAPI від Meta. Увімкніть в адмінці вашої платформи, вставте токен доступу, готово. Найкраще для команд без розробників.

2. Серверний менеджер тегів (рекомендований)

Використовуйте Stape або Google Tag Manager Server-Side для надсилання подій CAPI з контейнера sGTM. Ви отримуєте повний контроль над подіями, дедуплікацію та Advanced Matching без написання серверного коду. Галузевий стандарт для серйозних операторів.

3. Пряма API-інтеграція (найбільше контролю)

Надсилайте POST-запити безпосередньо на https://graph.facebook.com/v18.0/{pixel_id}/events з вашого бекенду. Найкраще для SaaS, кастомних додатків і всього, що не побудовано на великій комерційній платформі.

Покрокова інструкція: пряма API-реалізація

1. Створіть токен доступу CAPI. Events Manager → ваш піксель → Settings → Conversions API → Generate Access Token.
2. Виберіть події для надсилання на сервер. Завжди надсилайте Purchase, Lead і CompleteRegistration. Опціонально: ViewContent, AddToCart, InitiateCheckout для багатшого зіставлення.
3. Сформуйте корисне навантаження події. Обов'язково: event_name, event_time, action_source ("website"), event_id (для дедуплікації) та user_data (хешована електронна пошта/телефон/external_id).
4. Хешуйте всі поля user_data за допомогою SHA-256. Електронна пошта, телефон, ім'я, місто, штат, індекс, все хешоване, малими літерами, без пробілів.
5. Надішліть POST на кінцеву точку Graph API. Включіть токен доступу як параметр запиту або заголовок.
6. Налаштуйте логіку повторних спроб. Невдалі POST-запити (помилки 5xx) слід повторювати з експоненційною затримкою до 3 разів.
7. Логуйте кожну подію для аудиту. Зберігайте корисне навантаження події та відповідь Meta, щоб згодом мати змогу налагодити атрибуцію.

Дедуплікація подій: критична деталь

• Створюйте унікальний event_id для кожної конверсії (наприклад, ID вашого замовлення).
• Надсилайте однаковий event_id як у виклику браузерного пікселя, так і в події CAPI.
• Переконайтеся, що event_name збігається точно: "Purchase", а не "purchase".
• Переконайтеся, що event_time знаходиться в межах 1 хвилини між двома подіями для чистої дедуплікації.
• Використовуйте звіт про дедуплікацію в Events Manager, щоб перевірити, чи співвідношення здорові (події, зіставлені браузер+сервер, мають бути домінуючою групою).

Advanced Matching: чому хешовані ідентифікатори важливі

CAPI дозволяє передавати ідентифікатори користувачів (хешована електронна пошта, телефон, ім'я, місто тощо) для кожної події. Meta використовує їх, щоб зіставити конверсію з користувачем, який натиснув на оголошення, навіть якщо браузерний файл cookie зник.

• Електронна пошта (em): Найважливіший ідентифікатор. Передавайте його для кожної події, коли це можливо.
• Телефон (ph): Номер, без форматування, з кодом країни (наприклад, 14155551234).
• Ім'я (fn) та прізвище (ln): Малими літерами.
• Місто (ct), штат (st), індекс (zp), країна (country): Все малими літерами, без пробілів.
• Зовнішній ID (external_id): Ваш внутрішній ID клієнта, хешований. Чудово підходить для зіставлення повторних покупців.
• Click ID (fbc) та Browser ID (fbp): Отримуйте з браузерних файлів cookie та передавайте в кожній серверній події для кращого зіставлення.

Перевірка працездатності CAPI

1. Events Manager → вкладка Diagnostics. Не повинно бути критичних попереджень.
2. Events Manager → Event Quality / Event Match Quality. Намагайтеся досягти 7+ за 10-бальною шкалою.
3. Events Manager → гістограма Events Received. Переконайтеся, що заповнені обидва стовпчики: Browser і Server.
4. Тестові події. Створіть test_event_code, ініціюйте реальну конверсію та спостерігайте, як вона надходить у реальному часі.
5. Через 7 днів: Порівняйте атрибутовані конверсії в Ads Manager до та після CAPI. Зростання атрибутованих конверсій на 20%+ підтверджує, що CAPI відновлює дані.

CAPI більше не є опціональним. Рекламодавці, які у 2026 році використовують лише піксель, змагаються з однією рукою, зав'язаною за спиною. Виберіть шлях встановлення, який відповідає вашому стеку, правильно налаштуйте дедуплікацію та перевірте за допомогою Event Match Quality. Два дні роботи окупаються назавжди.