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

    • Это предотвращает дублирование событий при повторной отправке