Meta Conversions API: полный гайд

Серверный канал Meta для данных о конверсиях носит имя Meta Conversions API: сервер, CRM, приложение или трекер отправляют события напрямую в Meta, не полагаясь на браузерный тег. Эта страница - вход в весь наш кластер про CAPI. Здесь разобрано, что делает API, что нужно рабочему событию, как устроены дедупликация и проверка, и где у каждой конкретной проблемы - задержка, двойной счёт, код ошибки - есть отдельный подробный гайд.

Что такое Meta Conversions API?

Официальное описание простое: Meta Conversions API соединяет данные рекламодателя с Meta. Источник может быть любым: сервер, платформа сайта, мобильное приложение, CRM. Покрытие - события сайта, события приложения, события бизнес-переписки и офлайн-конверсии. Каждое серверное событие привязывается к dataset ID - так Events Manager сейчас называет объект, который большинство рекламодателей по привычке зовёт пикселем. Прямая интеграция - это POST-запрос вашего кода к endpoint API с привязкой к этому датасету.

Доставленные серверные события Meta обрабатывает так же, как события Pixel, Facebook SDK, MMP SDK, офлайн-наборы и CSV-загрузки. Это полноценные сигналы: они годятся для измерения, отчётности и оптимизации кампаний. Никакого статуса второго сорта у канала доставки нет.

Что теряет браузерный пиксель без серверных событий

Пиксель срабатывает в браузере пользователя, и каждый оборванный запрос или незагрузившаяся страница означает конверсию, которую Meta не увидит. Meta Conversions API смотрит с другой стороны: сервер уже знает, что продажа случилась, и передаст событие, даже если браузер не сообщил ни о чём. Туда же попадают события, которые пиксель в принципе не умеет передавать: офлайн-покупки, отложенные подтверждения, записи из CRM.

У измерения только через браузер есть ещё платформенный потолок на iOS: браузер там сообщает меньше, а трафик отказавшихся от ATT измеряется только через Aggregated Event Measurement. Что протокол делает сегодня, разобрано в отдельном гайде: Aggregated Event Measurement в Facebook.

Что нужно перед настройкой

Чек-лист Meta короткий. Нужен Pixel ID, причём один и тот же для браузерных и серверных событий; нужен аккаунт Meta Business Suite; нужен access token, который передаётся с каждым вызовом API. Токен создаётся в Events Manager: откройте Settings, найдите секцию Conversions API и нажмите Generate access token. Секция видна только пользователям с developer-привилегиями бизнеса.

Кнопка Manage рядом с Conversions API берёт бюрократию на себя: она автоматически создаёт CAPI-app и CAPI system user, так что App Review и ручные запросы прав не нужны. Начиная с Graph API v12.0 токен из Events Manager работает со всеми версиями Graph API, а не только с той, что была актуальна при его создании.

Пошаговый проход по интерфейсу с разбором типовых ошибок токена - в отдельном гайде: ID пикселя Facebook и access token.

Четыре способа настроить Meta Conversions API

Events Manager предлагает управляемую ручную настройку. Conversions API Gateway - вариант без кода: разворачивается из Events Manager, работает на облачных ресурсах в аккаунте вашего бизнеса, и Meta оценивает сокращение срока интеграции с недель до часов или минут. Gateway сам генерирует ключ дедупликации между браузером и сервером. Партнёрские интеграции закрывают крупные платформы, прямая интеграция остаётся полностью ручным маршрутом.

Для первого теста без кода ручной путь в Pixel Activator требует только dataset ID и токен. Постоянную доставку лучше сразу отдавать автоматизации - к ней вернёмся в конце гайда.

Отправка событий: параметры, action_source и хеширование

Payload запроса Meta Conversions API - массив data, плюс test_event_code на время тестов. Внутри каждого события: event_name, event_time, event_id и параметры. event_time - это Unix-секунды в GMT, не больше семи дней в прошлое на момент отправки; если хоть одно событие в запросе нарушает лимит, падает весь запрос, и ни одно его событие не обрабатывается. Для событий сайта обязательны action_source и event_source_url на верхнем уровне события и client_user_agent внутри user_data; событиям вне веба достаточно action_source.

Контактные данные хешируются SHA-256: email, телефон, имя и остальные поля user_data, причём сначала нормализуются по полям - email в нижний регистр, телефон только цифры с кодом страны, страна двухбуквенным кодом. Системы Meta спроектированы так, чтобы не принимать нехешированную контактную информацию; Business SDK хеширует автоматически, если руками не хочется. Каждый запрос требует минимум один параметр user_data, а с Graph API v13.0 действуют правила о допустимых комбинациях этих параметров. Хешировать нельзя client_ip_address, client_user_agent, fbc и fbp - значения cookies fbp и fbc отправляйте всегда, когда они есть.

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1790000000,
      "event_source_url": "your-domain.example/checkout-success",
      "event_id": "order-10247",
      "action_source": "website",
      "user_data": {
        "em": "<sha256-of-email>",
        "client_user_agent": "<client-user-agent-string>",
        "fbp": "fb.1.1790000000.1234567890"
      }
    }
  ]
}

Воронка без собственного сайта - партнёрские офферы, например - меняет картину параметров. Этот случай разобран отдельно: Facebook CAPI custom conversions для партнёрских офферов.

Как работает дедупликация Pixel и серверных событий

Дедупликация нужна только тем, у кого одно событие уходит дважды: через Pixel и через Meta Conversions API. Meta документирует два метода. Рекомендуемый спаривает event_id и event_name: браузерный eventID и серверный event_id должны совпадать точно, имена событий - тоже. Второй метод опирается на одинаковые event_name плюс fbp и/или external_id с обеих сторон.

Окно в обоих случаях 48 часов: дублирующая комбинация, пришедшая в тот же датасет в пределах 48 часов после первого события, отбрасывается, побеждает первая полученная копия. Тонкое место: второй метод работает главным образом для пар браузер-сервер, внутри одного канала дедупликации нет.

Если конверсии всё равно задваиваются, причина обычно в одной из этих пар. Подробный разбор: дедупликация Pixel и CAPI событий.

Как проверить события перед масштабированием

После старта отправки дайте системе минут двадцать, прежде чем делать выводы - именно так быстро события становятся видны в Events Manager. Для более быстрой обратной связи откройте Test Events tool: Events Manager, Data Sources, ваш датасет, Test Events - и прикладывайте показанный код к запросам как test_event_code.

Одна деталь ловит почти всех: события с тестовым кодом не выбрасываются. Они считаются: попадают в Events Manager и участвуют в таргетинге и измерении наравне с обычными, поэтому тестируйте с той же дисциплиной, что и боевой трафик.

Полный цикл валидации до масштабирования - в гайде: Meta Test Events tool: проверка Pixel и CAPI.

Event Match Quality и зачем он нужен

Каждое событие Meta Conversions API получает в Events Manager балл Event Match Quality по шкале до десяти. Балл показывает, насколько эффективно переданные customer information параметры срабатывают при сопоставлении события с аккаунтами Meta. Для атрибуции и оптимизации доставки годятся только matched events; unmatched идут в базовое измерение и останавливаются на этом. Сейчас EMQ существует только для web-событий.

Официальных весов по полям и целевого значения Meta не публикует - гайд, называющий конкретную цифру, выдумывает порог. Честная механика простая: больше корректно нормализованных user_data - матчингу есть с чем работать. Приёмы повышения разобраны в гайде: балл Facebook Event Match Quality.

Диагностика: задержки, расхождения, ошибки

События, которые «не приходят», часто оказываются преждевременной паникой - вспомните про 20-минутное окно видимости и сначала исключите обычную задержку. Отметки времени старше семи дней роняют весь запрос Meta Conversions API; за знаменитой ошибкой 2804003 стоит именно этот механизм, а путь обратной заливки существует только для офлайна и physical store - окно 62 дня. Когда Ads Manager и трекер показывают разные числа, дело в правилах счёта, а не в канале доставки. Если ничто из перечисленного не объясняет симптом, проверьте сам пиксель по системному чек-листу.

По каждому из четырёх случаев есть отдельный гайд:

• Что проверять при задержке событий Meta CAPI
• Facebook CAPI error 2804003 и лимит 7 дней
• Почему Ads Manager и трекер показывают разные конверсии
• Чек-лист аудита Facebook Pixel

Автоматизация доставки: Keitaro, Pixel Activator и Most

Если воронка живёт в Keitaro, трекер может отправлять конверсии напрямую в Meta Conversions API, с картой событий в одном месте - подключение без потери конверсий разобрано в гайде по интеграции Keitaro с CAPI по пути. Для ручных разовых тестов Pixel Activator остаётся самым быстрым входом без настройки. А когда доставка должна просто происходить всегда - ретраи, дедупликация, маршрутизация из CRM или трекера круглосуточно - это работа Most в фоне.

Meta Conversions API: частые вопросы

фильтрация ботов перед CAPI. батчинг и лимиты Meta CAPI.

Sources