Коротко
CAPI (Conversions API) — это серверный канал Meta. Вы отправляете события с сервера, из сайта, приложения или CRM, и Meta использует их для таргетинга, оптимизации и измерения результата. Событие приходит напрямую, поэтому не зависит от того, что видит браузер клиента.
Чем CAPI отличается от пикселя
Пиксель Meta работает в браузере. Он видит, что человек сделал на сайте: открыл страницу, нажал кнопку, отправил форму. Если клиент ушёл в WhatsApp, договорился с менеджером и оплатил через три дня, пиксель об этом не узнает: оплата произошла не на сайте.
CAPI устроен иначе. Событие отправляет ваша система в тот момент, когда оплата появилась в CRM. Для Meta такие события обрабатываются так же, как события пикселя: их можно использовать для отчётов и оптимизации.
Что именно отправляется
Это запрос к API с описанием события. Обязательные параметры по документации Meta:
event_name: название события, например «Покупка».event_time: время, когда событие произошло на самом деле.action_source: откуда событие, например сайт или чат.user_data: данные клиента, по которым Meta сопоставляет событие с человеком.
Для событий с сайта дополнительно нужен адрес страницы (event_source_url). Сумму и валюту можно добавить, чтобы реклама учитывала стоимость покупки.
Срок: события нужно отправлять быстро
Время события (event_time) может быть не старше 7 дней на момент отправки. Если в запросе есть хотя бы одно более старое событие, Meta возвращает ошибку на весь запрос, и ни одно событие из него не обрабатывается.
Практический вывод: оплату нужно передавать сразу, как только менеджер сменил стадию сделки, а не выгружать раз в месяц.
Двойной учёт и event_id
Если одно и то же событие приходит и от пикселя, и через CAPI, Meta должна понять, что это одно событие. Для этого в обоих источниках передают одинаковые event_name и event_id. Одинаковые события, пришедшие в течение 48 часов, учитываются один раз.
В схеме «клик на сайте, оплата в WhatsApp» оплату отправляет только сервер, поэтому пересечения с пикселем обычно нет. Но event_id стоит передавать всегда: например, номер заказа или сделки.
Что это даёт, когда клиенты пишут в WhatsApp
- Meta видит не только «написал», но и «заплатил».
- Оптимизация идёт по оплатам, а не по пустым перепискам.
- Видно, какие кампании приводят платящих клиентов, а не просто дешёвые обращения.
Как это делает ТУК-ТУК
ТУК-ТУК определяет источник обращения и записывает его в сделку Битрикс24. Когда сделка переходит в стадию «Оплачено», событие уходит в рекламный кабинет. Это входит в тариф «Трекер PRO». Сейчас эта часть в разработке.