Binom Facebook CAPI: интеграция от постбека трекера до Conversions API
Что интеграция Binom с Facebook реально покрывает
Интеграция Binom Facebook CAPI начинается с честного вопроса: что именно документирует трекер. Официальная документация Binom описывает одну Facebook-интеграцию, и она про деньги, а не про конверсии: access token подключает Facebook-аккаунт к кампании в Binom, и каждые 30 минут Binom забирает расходы в разрезе токена {{ad.id}}, который вы передаёте из Facebook в трекер. Если передать {{ad.id}} невозможно, Binom синхронизирует расходы целого аккаунта и распределит их по кликам дня. Статистика активных кампаний за предыдущий день обновляется три раза в сутки, а аккаунты с нулём кликов трекер пропускает, чтобы не дёргать API впустую.
Токен берётся в Meta for Developers: создайте приложение типа Business, подключите Marketing API, отметьте ads_management и сгенерируйте токен. Документация Binom добавляет операционное предупреждение: Facebook требует генерировать новый токен каждые два месяца, то есть у cost-интеграции есть встроенный график обслуживания.
Чего в доках нет - нативного отправителя Facebook Conversions API внутри Binom. Конверсии приезжают в трекер постбеками от партнёрских сетей - это стандартный путь обновления; на случай, когда постбеки недоступны, есть conversion pixel. Из этого различия следует вся интеграция: Binom знает о конверсии, а доставка этой конверсии в Conversions API Meta - слой, который вы надстраиваете сверху.
Что Conversions API требует от моста
Кто бы ни формировал серверное событие, требования Meta фиксированы. Payload уходит POST'ом на эндпоинт Conversions API с пиксельным ID и access token; user-data поля вроде email и телефона едут как SHA-256-хэши нормализованных значений; каждое событие несёт event_id, чтобы ретраи и дубли каналов не задваивали счёт; таймстемп события не старше 7 дней. Механика задержек за этим лимитом - в материале о том, почему Meta отклоняет события старше 7 дней.
Для связки с Binom триггер - постбек. Трекер уже знает момент конверсии, выплату и - если вы сохранили их в момент клика - клик-идентификатор fbclid и собранные на лендинге хэши идентификаторов. Мост слушает постбек и выпускает событие Conversions API с этим контекстом: имя события, смаппленное из статуса конверсии Binom, event_id из транзакционного или клик-ID трекера, проброшенный fbclid для клик-матчинга и хэши идентификаторов, если воронка их собрала. Фон матчинга и дедупа - в дедупликации по event ID.
Три рабочих варианта моста
Вариант первый - маленький собственный эндпоинт: мост слушает исходящий постбек, который Binom шлёт в источник трафика при фиксации конверсии, - либо скрипт работает прокси-эндпоинтом перед трекером - и на каждый выстрел формирует CAPI-payload. Держите направление прямо: постбек от партнёрской сети кормит Binom, а собственный source-постбек Binom кормит ваш мост. Максимальный контроль и максимальная ответственность: хэширование, ретраи и дисциплина event_id - проблема вашего кода, а правила строги настолько, что первая версия обычно проваливает валидацию несколько раз.
Вариант второй - server-side tag manager: sGTM принимает постбек и форвардит преобразованное событие в Meta ценой эксплуатации sGTM-инфраструктуры - трейд-оффы в гайде по миграции с server-side GTM.
Вариант третий - делегирование: MOST принимает постбек Binom и доставляет в Conversions API Meta - а также TikTok, Snapchat, Pinterest, Reddit и OpenAI - беря на себя форматирование payload, ретраи и дедупликацию по каждой сети. Для одиночного лендинга и ручного воркфлоу ту же доставку без подписки делает бесплатный Pixel Activator. Выбор подчиняется той же логике, что в сравнении Meta CAPI Gateway и прямой интеграции: владеть инфраструктурой или владеть только постбеком.
Синхронизация расходов обратно в Binom
Направление расходов документировано Binom от и до. Передайте {{ad.id}} из Facebook в URL кампании трекера, чтобы расходы ложились по объявлениям; если токен передать нельзя, переключите кампанию на аккаунт-левел синк и примите дневное распределение по кликам. Подключите access token из Business-приложения с правами ads_management и держите в голове двухмесячную ротацию: мёртвый токен молча останавливает обновления расходов, и первый симптом - протухший спенд Facebook в отчётах.
Держите два направления отдельно в голове: расходы текут Facebook → Binom через официальную интеграцию, конверсии текут Binom → Facebook через построенный вами мост к Conversions API. Команды, которые их путают, ждут появления CAPI-конверсий в cost-sync-виде Binom, где им появляться неоткуда. Валидируйте направления независимо - обновления расходов в трекере и доставку Conversions API в Meta Test Events и Events Manager.