Conversions API Meta: как настроить серверные события без программиста
Что такое Conversions API (CAPI) Meta, зачем он рядом с пикселем, какие данные нужны для сопоставления событий и как настроить CAPI в трекере без кода.
Пиксель Meta видит только то, что происходит в браузере на вашем сайте. Но в арбитраже главные конверсии случаются в другом месте: человек подписывается на Telegram-канал, регистрируется или вносит депозит у партнёрки. Пиксель этого не видит. Conversions API (CAPI) решает задачу с другой стороны: о конверсии Meta сообщает ваш сервер.
Что такое Conversions API#
Conversions API — способ отправлять события в Meta напрямую с сервера, без браузера посетителя. Сервер отправляет в Meta запрос: какое событие произошло, когда и с каким кликом оно связано. Для этого нужны два значения из Events Manager — ID пикселя (Dataset ID) и токен доступа.
Событие уходит в тот же пиксель, что и браузерные события. В Ads Manager оно выглядит так же: из него считаются результаты, по нему учится оптимизация.
Пиксель или CAPI: что выбрать#
| Пиксель в браузере | Conversions API | |
|---|---|---|
| Откуда уходит событие | из браузера посетителя | с сервера |
| Блокировщики рекламы | могут не дать коду загрузиться | не влияют |
| Человек закрыл страницу раньше времени | событие теряется | не влияет |
| Конверсии вне сайта: подписка в Telegram, депозит у партнёрки | не видит | отправляет, когда о них узнает трекер |
| Нужен ли код на лендинге | да | нет |
Ответ — и то и другое. Пиксель на лендинге даёт Meta браузерный идентификатор _fbp и события на странице. CAPI доставляет главные конверсии, где бы они ни случились. Чтобы одна конверсия не посчиталась дважды, события дедуплицируются — об этом ниже.
Как Meta понимает, чей это клик#
Серверное событие приходит без cookie браузера. Чтобы связать его с показом рекламы, Meta сравнивает параметры пользователя (user_data) с тем, что знает сама. Чем больше совпадений, тем выше качество сопоставления событий (Event Match Quality) в Events Manager.
| Параметр | Что это | Откуда берётся |
|---|---|---|
fbc | ID клика по рекламе | собирается из fbclid, который Meta добавляет к ссылке объявления |
fbp | браузерный ID | cookie _fbp, его ставит пиксель на лендинге |
client_ip_address, client_user_agent | IP и браузер | запоминаются при клике |
external_id | ваш ID посетителя | например, ID клика трекера |
em, ph | email и телефон | только в виде хеша SHA-256 |
country, ct | страна и город | по IP, тоже в виде хеша |
Самый ценный параметр для рекламного трафика — fbc. Он прямо указывает на клик по объявлению. Формат: fb.1.<время клика в мс>.<fbclid>.
Отсюда первое правило: не теряйте fbclid по дороге. Если между объявлением и лендингом стоит редирект или сокращатель ссылок, проверьте, что параметры ссылки доходят до конца. Без fbclid событие опирается на IP и браузер — Meta сопоставляет такие события хуже.
Дедупликация: чтобы конверсия не посчиталась дважды#
Если одно событие пришло и от пикселя, и через CAPI, Meta нужно понять, что это одно и то же. Для этого у обоих событий должны совпадать:
event_name— имя события, напримерLead;event_id— ID события.
Meta объединяет такие события, если они пришли в течение 48 часов после первого. Типичная ошибка — генерировать ID отдельно в браузере и на сервере: они не совпадут, и Meta посчитает две конверсии.
Какие события отправлять#
Оптимизация Meta учится на событии, которое вы выбрали целью. Нужен баланс: событие должно быть близко к деньгам, но случаться достаточно часто. Если целевых событий мало, группа объявлений долго не выходит из фазы обучения, и результаты скачут.
- Депозитов много — оптимизируйтесь на
Purchaseи передавайте сумму. - Депозиты редкие — берите событие раньше в воронке: регистрацию, подписку, лид.
- Совсем мало данных — помогает микроконверсия, например нажатие главной кнопки на лендинге.
Как настроить CAPI в Lidvanto#
Трекер Lidvanto отправляет события в CAPI сам — код писать не нужно.
- Возьмите данные в Events Manager. ID пикселя (Dataset ID) — в настройках источника данных. Токен — там же, блок Conversions API → Generate access token. Код тестового события — вкладка Test Events.
- Добавьте пиксель в трекер. Трекер → Пиксели → пиксель Meta: Pixel ID, Токен доступа и Test Event Code.
- Привяжите кампании. В блоке Кампании отметьте нужные кампании. У каждой два переключателя: API — серверные события, Браузер — код пикселя на лендингах трекера. Включите оба.
- Задайте правила событий. На странице кампании, вкладка Конверсии: событие трекера → имя события Meta. Имена для подписки, диалога, регистрации и депозита закреплены:
Subscribe,Contact,CompleteRegistrationиPurchase. Депозит уходит с суммой и валютой из постбэка партнёрки.
- Проверьте. Кнопка Отправить тест отправит тестовое событие с вашим Test Event Code — оно появится во вкладке Test Events. Боевые события уходят без тестового кода, так что забытый код статистику не испортит.
Что трекер делает за вас:
- сохраняет
fbclidиз ссылки объявления и собирает из негоfbc; - забирает
_fbpс лендинга, если включён код пикселя; - добавляет IP, браузер, гео и ID клика, хеширует личные данные;
- даёт браузерному и серверному событию заявки один
event_id— Meta считает её один раз; - отправляет конверсии, которые случились не на сайте: подписку на канал, диалог с ботом, депозит по постбэку.
Подробная инструкция — Пиксели Meta и TikTok.
Частые вопросы#
Нужен ли код пикселя на лендинге, если есть CAPI?
Не обязательно: CAPI работает и без него. Но с кодом на лендинге у событий появляется _fbp, и Meta сопоставляет их точнее. В Lidvanto код ставится переключателем Браузер, без правки лендинга.
Почему в Events Manager низкое качество сопоставления?
Чаще всего до трекера не доходит fbclid — его теряет редирект или сокращатель ссылок. Проверьте, что ссылка объявления ведёт прямо на ссылку трекера и не обрезает параметры.
Конверсии задваиваются. Что проверить?
Что браузерное и серверное событие приходят с одним event_id и одним именем. И что на лендинге один код пикселя: если код уже вставлен в лендинг вручную, не включайте ещё и переключатель Браузер.
Можно ли отправлять в CAPI депозиты, которые случились у партнёрки?
Да. Партнёрка сообщает о депозите постбэком, трекер привязывает его к клику и отправляет в Meta как Purchase с суммой.