Adset.ProAdset.ProKnowledge base
RUEN
To app
Home/Пікселі/Facebook Pixel (Conversions API)

Facebook Pixel (Conversions API)

Що таке Facebook Conversions API?

Facebook Conversions API (CAPI) — це server-to-server інтеграція, яка дозволяє надсилати події конверсій безпосередньо з вашого сервера у Facebook. Це підвищує якість даних і покращує оптимізацію рекламних кампаній.

Переваги CAPI:

  • ✅ Обхід блокувальників реклами та обмежень iOS 14+

  • ✅ Більш точна атрибуція конверсій

  • ✅ Поліпшення роботи алгоритмів оптимізації Facebook

  • ✅ Можливість надсилати дані про вартість конверсії (revenue)

Отримання даних для налаштування

Крок 1: Отримайте Pixel ID

  1. Зайдіть у Facebook Events Manager (https://business.facebook.com/events_manager)

  2. Виберіть свій піксель

  3. Перейдіть у Settings → Pixel ID

  4. Скопіюйте ID (наприклад: 1234567890123456)

Крок 2: Отримайте Conversions API Access Token

  1. У Events Manager відкрийте свій піксель

  2. Перейдіть у Settings → Conversions API → Generate Access Token

  3. Скопіюйте токен (наприклад: EAABsbCS1234...)

ВАЖЛИВО: Зберігайте токен у секреті! Не передавайте його третім особам.

Налаштування Facebook пікселя в трекері

Поле "ID пікселя"

Вставте скопійований Pixel ID (тільки цифри, без пробілів).

Приклад:

1234567890123456

Поле "Токен доступу до пікселя"

Вставте повний Access Token.

Приклад:

EAABsbCS1234ZABCDEFGabcdefg1234567890HIJKLMNOP

Маппінг подій для Facebook

Facebook підтримує наступні стандартні події:

Подія Facebook

Опис

Коли використовувати

Purchase

Покупка

Для депозитів (accept)

CompleteRegistration

Завершення реєстрації

Для реєстрацій (hold)

Lead

Лід

Для лідів, установок PWA (pwa_install)

ViewContent

Перегляд контенту

Для переглядів лендингів

AddToCart

Додавання в кошик

—

InitiateCheckout

Початок оформлення замовлення

—

AddPaymentInfo

Додавання платіжної інформації

—

Contact

Контакт

—

SubmitApplication

Відправка заявки

—

Subscribe

Підписка

—

Рекомендований маппінг (застосовується за замовчуванням):

Подія трекера

Подія Facebook

Коментар

pwa_install

Lead

PWA Install = Лід

hold

CompleteRegistration

Реєстрація = Complete Registration

accept

Purchase

Депозит = Покупка

Додаткові дані, що надсилаються у Facebook

Трекер автоматично надсилає наступні дані разом з подіями:

User Data (дані користувача):

  • client_ip_address — IP-адреса користувача (з події event.user_ip)

  • client_user_agent — User Agent браузера (з події event.user_ua)

  • fbc — Facebook Click ID (з event.ext_click_id + час кліка)

Custom Data (дані конверсії):

  • currency — валюта конверсії (з conversion.currency)

  • value — сума конверсії (з conversion.revenue)

    • Для події Purchase надсилається реальна сума депозиту

    • Для інших подій надсилається 0 з валютою USD

Event Metadata:

  • action_source — завжди website

  • event_source_url — URL лендинга (наприклад: https://domain.com/track/campaign_id/ads)

  • event_id — унікальний ID постбека (для дедуплікації)

  • event_time — час конверсії в Unix timestamp (в секундах)

Особливості роботи Facebook CAPI

  1. Хешування даних

    • Трекер НЕ хешує IP та User Agent — вони надсилаються як є

    • Facebook сам хешує дані на своїй стороні

  2. FBC (Facebook Click ID)

    • Формат: fb.1.<timestamp_ms>.<fbclid>

    • Приклад: fb.1.1705319400000.AbCdEfGh123

    • Час береться з первинного кліка (не з конверсії)

  3. Дедуплікація подій

    • Кожна подія має унікальний event_id

    • Це запобігає дублюванню подій при повторній відправці