Постбек Keitaro → Facebook CAPI

Депозит должен долететь из партнёрки в Facebook ровно один раз — не потеряться и не задвоиться. Показываем, как настроить S2S-постбек от Keitaro в CAPI: какой clickid передавать, как маппить статусы и что проверить перед тем, как лить бюджет всерьёз.

Путь конверсии от клика до CAPI

Пользователь кликает по рекламе — Facebook прикрепляет к переходу свои идентификаторы (fbclid, fbp/fbc), Keitaro сохраняет их вместе с subid клика. Когда партнёрка присылает постбек о депозите на URL Keitaro, тот подтягивает сохранённые идентификаторы и оформляет событие для CAPI — так Facebook понимает, какой именно клик привёл к конверсии, даже если она случилась заметно позже клика.

Настройка исходящего постбека в Keitaro

В интеграциях Keitaro добавляется Facebook CAPI: Pixel ID и токен доступа — системный токен из Business Manager, раздел Events Manager → настройки Conversions API. Дальше настраивается маппинг статусов конверсии на события Facebook: approved-депозит в гемблинге логично мапить на Purchase, лид или регистрацию — на Lead либо CompleteRegistration, с передачей суммы и валюты, если она есть.

Clickid и совпадение с пикселем

Чтобы CAPI-событие засчиталось с высоким качеством совпадения, в нём должны быть те же идентификаторы, что видел браузерный пиксель на этом же клике — отсюда важность корректно сохранённых fbclid/fbp на всём пути через PWA и Keitaro. Если эти данные не долетают, Facebook всё равно примет событие, но качество атрибуции и оптимизации заметно просядет.

Дедупликация: депозит один, событий тоже одно

Если на витрине уже стоит браузерный пиксель, один и тот же депозит может прийти в Facebook дважды — с клиента и через CAPI. Решается общим event_id, одинаковым в обоих вызовах на одно и то же реальное событие: Facebook сам оставит одну запись и пометит вторую как дедуплицированную. Перед масштабированием стоит прогнать несколько тестовых конверсий и убедиться в Events Manager, что дублей нет.

Частые вопросы

Нужен ли одновременно пиксель на витрине, если настроен CAPI?
Да, обычно связка пиксель плюс CAPI работает лучше, чем один канал, а задвоение между ними закрывается дедупликацией по event_id.
Где взять токен доступа для Facebook CAPI?
В Business Manager, в Events Manager нужного пикселя, в разделе настроек Conversions API — там генерируется системный токен для интеграции с Keitaro.
Как убедиться, что постбек реально долетел до Facebook?
В Events Manager смотрите вкладку полученных или тестовых событий: там видно источник (Browser или Server), статус приёма и совпадение по времени с реальным депозитом.
Собери своё PWA в APEX за пару минут

Клоака, антибот, пуши, сплит-тесты и свои домены — в одном сервисе.

Начать бесплатно

Читайте также