Определение
Meta Conversions API (CAPI): интерфейс Meta для отправки данных с сервера на сервер.
Он передаёт конверсии с сайта, из приложения, CRM или офлайн-источника напрямую в Meta без браузерного Pixel. Событие содержит action_source (место действия) и данные пользователя для сопоставления, хешированные перед отправкой. Браузерную и серверную копии Meta сопоставляет по event_name и event_id и учитывает как одно действие.
- Параметры сопоставления
- адрес электронной почтыномер телефона
- дедупликация с Pixel
- event_nameevent_id
- На практике
Как работает Conversions API?
Conversions API передаёт события с сервера, бэкенда или из CRM в Meta по HTTP. Так в тот же dataset могут попасть действия, недоступные Pixel: покупка вне сайта, телефонный звонок или заказ в CRM.
Каждое событие содержит название, время и параметры. Для событий сайта также нужны URL источника и user agent клиента. Meta не получает этот браузерный контекст самостоятельно.
- На практике
Для чего нужен action_source?
action_source указывает место конверсии. Meta требует этот параметр в каждом событии API. Значение должно точно описывать источник.
Допустимые значения описывают, где может произойти конверсия: сайт, приложение, телефонный звонок, чат, физический магазин, электронная почта, событие, созданное системой, бизнес-сообщения и другое. Неверный источник искажает картину того, откуда пришла конверсия.
- На практике
Что такое хешированные параметры пользователя?
Параметры сопоставления помогают Meta связать серверное событие с аккаунтом человека. Например, адрес электронной почты или номер телефона. Перед отправкой персональные данные нужно хешировать. Business SDK делает это автоматически.
Несколько независимых параметров дают Meta больше способов сопоставить событие с человеком. Это отражает Event Match Quality.
- На практике
Как работает дедупликация с Pixel?
Meta сопоставляет событие из браузера с его серверной копией по event_name и event_id. Pixel отправляет значение как eventID, Conversions API как event_id. Чтобы Meta признала их одним действием, это должна быть одна и та же строка.
Если идентификаторы различаются, Meta может посчитать событие из браузера и серверное событие отдельно, и конверсии окажутся завышены. Если они совпадают, действие считается один раз.
Не путать с
Не путать с Это не Это замена Pixel интерфейс Meta для отправки данных с сервера на сервер Conversions API не обходит согласие или защиту приватности браузера. Это не замена Pixel. Рекомендуется отправлять события по обоим каналам и удалять дубли. Каналы дополняют друг друга по доступным данным.
Серверное событие само по себе не точнее: качество сопоставления зависит от идентификаторов, которые в нём есть.
- Где проверить
Как проверить серверные события в Events Manager?
- Meta Events ManagerdatasetOverview
- Meta Events ManagerdatasetTest Events
Откройте Meta Events Manager и выберите dataset. В Overview видны источники событий. Test Events показывает параметры события, его серверный источник и результат дедупликации с браузерной копией.
Диагностика показывает события, которые приходят без общего идентификатора. Это самый быстрый признак того, что пары event_id нет.
