Кастомные конверсии Facebook CAPI для партнёрских офферов: настройка без собственного сайта

С помощью кастомных конверсий Facebook CAPI партнёр передаёт события конверсии в Meta, даже если пиксель на домене рекламодателя ему недоступен. Вместо браузерного трекинга вы отправляете серверные события через цепочку постбэков трекера напрямую в датасет рекламодателя через Conversions API.

Зачем партнёру серверные кастомные конверсии

В типичной партнёрской схеме конверсия происходит на лендинге или в чекауте рекламодателя. У вас нет возможности установить туда пиксель Meta. Без сигнала конверсии оптимизация кампании буксует.

Conversions API решает задачу, принимая серверные события от любой авторизованной системы. Ваш трекер уже получает постбэк от CPA-сети в момент конверсии. Этот постбэк содержит данные, достаточные для формирования валидного события CAPI.

Для партнёров самый частый вариант - общий датасет: рекламодатель генерирует токен доступа к датасету и передаёт его вам или настраивает в общем трекере. Если нужно разобраться с получением ID датасета и токена, смотрите Facebook Pixel ID и токен доступа.

Как работает цепочка постбэк-CAPI

Поток данных по шагам:

1. Пользователь кликает по рекламе и попадает на страницу рекламодателя. Трекер фиксирует click ID (fbclid или внутренний sub ID).
2. Пользователь конвертируется. CPA-сеть отправляет постбэк на URL трекера с параметрами конверсии (выплата, имя цели, sub ID).
3. Трекер сопоставляет постбэк с исходным кликом и инициирует исходящий запрос на CAPI-релей.
4. Релей форматирует payload и отправляет POST на эндпоинт /events для целевого датасета.

CPA-сеть --> Трекер (постбэк на входе)
                 |
                 v
           CAPI-релей (формат + авторизация)
                 |
                 v
           Эндпоинт Meta /events (датасет)

Релеем может быть serverless-функция, модуль внутри трекера (Keitaro, Binom и аналоги) или платформа вроде MOST, которая автоматизирует маршрутизацию конверсий. Для базовой настройки в Keitaro обратитесь к гайду Facebook CAPI в Keitaro.

Маппинг полей постбэка в параметры CAPI

Conversions API требует определённые поля для каждого серверного события. Таблица сопоставления для типичного партнёрского постбэка:

Поле event_name - ключевое для кастомных конверсий. Вы определяете кастомную конверсию в Meta Events Manager, создавая правило на совпадение с выбранным именем события. Когда событие CAPI приходит с этим именем, Meta засчитывает кастомную конверсию.

{
  "data": [
    {
      "event_name": "AffiliatePurchase",
      "event_time": 1753600000,
      "action_source": "website",
      "event_source_url": "advertiser-landing.example/thank-you",
      "user_data": {
        "fbp": "<hashed_fbp>",
        "external_id": "<hashed_sub_id>"
      },
      "custom_data": {
        "value": 42.50,
        "currency": "USD"
      }
    }
  ]
}

Эндпоинт принимает пакеты до 1000 событий за запрос. Полное описание параметров - в официальной документации: Параметры серверных событий Conversions API.

Создание кастомной конверсии в Events Manager

Шаги в Meta Events Manager:

1. Откройте Events Manager и выберите датасет, принимающий события CAPI.
2. Перейдите в раздел Custom Conversions и нажмите Create Custom Conversion.
3. Укажите источник данных - ваш датасет.
4. В блоке Rules выберите Event equals и введите точное кастомное имя события (например, AffiliatePurchase).
5. При желании добавьте правило по значению (value > 0), чтобы отсечь тестовые события.
6. Назовите конверсию и сохраните.

После создания кастомная конверсия появляется в выпадающем списке оптимизации адсета в течение нескольких часов. Если события не отображаются, проверьте доставку через Meta Test Events Tool.

Настройка доступа: датасет, токен и partner_agent

Перед первым POST-запросом нужны три элемента:

• Dataset ID - числовой идентификатор пикселя/датасета рекламодателя (тот же, что используется для браузерных событий).
• Access token - долгоживущий токен системного пользователя с правами ads_management и business_management на датасет.
• partner_agent - строка-идентификатор платформы (например, keitaro-2.1 или most-relay-1.0). Meta использует её для партнёрской атрибуции.

Рекламодатель генерирует токен в Business Settings > System Users, назначает ресурс датасета и безопасно передаёт учётные данные. Никогда не хардкодьте токены в клиентском коде или публичных репозиториях.

Про ограничение event_time в 7 дней и работу с запоздалыми постбэками читайте в Facebook CAPI Error 2804003: обход лимита 7 дней.

Валидация доставки и устранение проблем

Чеклист валидации:

1. Откройте Events Manager > Test Events и добавьте датасет.
2. Вызовите тестовую конверсию из CPA-сети (большинство сетей поддерживают тестовый постбэк).
3. Убедитесь, что событие появилось в ленте Test Events в течение 60 секунд.
4. Проверьте, что event_name точно совпадает с правилом кастомной конверсии (регистр имеет значение).
5. Убедитесь, что user_data содержит хотя бы один ключ сопоставления (fbp, em или external_id).
6. Посмотрите вкладку Events Quality на предмет предупреждений о match rate.

Типичные проблемы:

• Событие не появляется - у токена нет прав на датасет или event_time старше 7 дней.
• Кастомная конверсия не срабатывает - несовпадение event_name (лишние пробелы, другой регистр).
• Низкий match rate - поля user_data не хэшированы SHA-256 или отсутствует fbp.

Если параллельно с CAPI вы тестируете пиксель вручную, сначала активируйте его корректно. Для бесплатной ручной активации используйте Pixel Activator.

Окна атрибуции и влияние на оптимизацию

Meta применяет окна атрибуции (1-day click, 7-day click, 1-day view по умолчанию) на уровне рекламного аккаунта. Событие CAPI должно нести идентификатор клика (fbp или external_id), который Meta сопоставит с показом в пределах активного окна.

Если CPA-сеть задерживает постбэки более чем на 24 часа, конверсии могут выпасть из окна 1-day click. Настройте трекер на мгновенную пересылку постбэков и сохраняйте исходный fbclid в момент клика.

Подробнее о мультиплатформенных постбэках трекера - в гайде Постбэки Keitaro для Facebook и TikTok.

Источники