Facebook CAPI: подробная настройка
Facebook CAPI: подробная настройка — это не разовое действие «включил и забыл», а связка из токена, структуры события и качества данных, от которой зависит, поверит ли Facebook вашим конверсиям. Без неё оптимизация кампании держится на догадках: часть депозитов теряется, часть задваивается, а показатель EMQ падает без объяснимой причины. Разберём каждый шаг — от получения токена до проверки в Events Manager.
Что нужно подготовить перед настройкой
Для CAPI нужен уже созданный в Meta Events Manager Pixel и отдельный токен доступа именно к нему — без пикселя серверные события просто не к чему привязать. Дальше нужен канал, который умеет делать исходящий POST-запрос: это может быть свой сервер, а может быть встроенная интеграция трекера, например Keitaro, — тогда писать код вообще не придётся.
Структура события: что реально отправляется
Каждый серверный вызов состоит из event_name (название события, совпадающее с логикой воронки), event_time (unix-время момента самого действия, а не момента отправки постбека), event_source_url, action_source со значением «website», и двух блоков данных — user_data и custom_data. custom_data несёт value и currency для события с ценностью, например Purchase, без них Facebook не сможет использовать сумму для оптимизации ставок.
user_data и качество матчинга (EMQ)
Именно поля внутри user_data формируют показатель Event Match Quality: хэшированные email и телефон, если они есть, external_id — ваш собственный постоянный идентификатор пользователя, client_ip_address и client_user_agent, унаследованные от исходного визита, и параметр fbc, полученный с клика по рекламе. Facebook поднимает EMQ только за реальные совпадающие данные — искусственно подставленные значения не помогают и могут выглядеть подозрительно.
Токен, event_id и дедупликация с пикселем
Токен доступа авторизует весь серверный вызов и даёт право писать события от имени пикселя, поэтому его нельзя публиковать в открытом виде — только в закрытых настройках трекера или сервера. event_id — отдельная сущность: строка, которая связывает серверное событие с его клиентским двойником от Pixel, чтобы Facebook засчитал одно событие, а не два. Потеря или случайная перегенерация одного из них на полпути — самая частая причина, по которой CAPI перестаёт работать незаметно для байера.
Проверка в Events Manager и связка с Keitaro
Вкладка Test Events в Meta Events Manager показывает каждый входящий серверный вызов в реальном времени вместе с разбивкой EMQ по полям — так быстрее всего понять, какого параметра не хватает. Частые ошибки — event_time далеко от реального момента действия, пропущенный action_source и custom_data без currency на событии с ценностью. В связке с Keitaro токен и Pixel ID указываются один раз в настройках исходящего постбека, а качество итогового EMQ зависит от того, что APEX донесёт от клика по рекламе до самого постбека — clickid, IP и User-Agent.
Частые вопросы
- Где взять токен доступа для Facebook CAPI?
- В Meta Events Manager: выбранный пиксель → Settings → раздел Conversions API → Generate Access Token. Токен привязан к конкретному пикселю и должен храниться только в закрытых настройках сервера или трекера.
- Что реально повышает EMQ, а что не даёт эффекта?
- Поднимают показатель реальные хэшированные email или телефон, external_id, client_ip_address, client_user_agent и fbc с клика; произвольно подставленные «заглушки» не помогают, потому что Facebook не может их с чем-либо сопоставить.
- Нужен ли event_id, если событие шлётся только через CAPI, без пикселя?
- Нет, event_id критичен только тогда, когда одно и то же действие отправляется двумя каналами; для одиночного серверного канала дублей просто не возникает.
- Можно ли настроить CAPI без своего сервера, силами одного Keitaro?
- Да, исходящая интеграция Keitaro с Conversions API умеет собирать нужные поля из постбека и отправлять их по тем же правилам без отдельного бэкенда.
Клоака, антибот, пуши, сплит-тесты и свои домены — в одном сервисе.
Начать бесплатно