Keitaro S2S постбек: настройка с нуля

Keitaro S2S постбек - выходная дверь трекера: каждая конверсия, дошедшая до Keitaro, способна уехать дальше - источнику трафика, партнёрской сети или серверному API рекламной площадки - через настроенный вами исходящий постбек. Правильная настройка - конверсии текут ко всем адресатам, которых они заслуживают; неправильная - конверсии приходят, но не уходят. Этот гайд собирает настройку с пустой кампании: что делает постбек, анатомию URL с плейсхолдерами, маршрутизацию по статусам, поведение очереди и дедупа и проверки по логам, доказывающие каждую доставку.

Входящая сторона - URL постбека, который дёргает партнёрская сеть, - разобрана внутри гайда от постбека сети до CAPI; здесь в фокусе исходящая доставка.

Что делают исходящие S2S постбеки

Keitaro документирует S2S постбеки как «инструмент аналитики и сбора данных на стороне источника трафика»: при регистрации конверсии Keitaro сверяет её статус с каждым настроенным постбеком и ставит совпавшие в очередь. В дизайне три следствия, которые стоит понять до настройки:

1. Постбеки привязаны к кампании. У каждой страницы кампании свой таб S2S Postbacks - одна кампания, один набор адресатов.
2. Постбеки ключуются статусом. Каждая строка постбека стреляет только по выбранному на ней статусу конверсии; постбек лида и постбек продажи - две разные строки.
3. Постбеки стоят в очереди. Исходящие запросы «собираются в очередь и отправляются» отдельно от обработки кликов - доставка переживает перезапуски, а дубли исключаются самой очередью.

Поскольку доставка ключуется статусом, сетка постбеков - это ваша событийная политика в форме трекера: какие статусы покидают трекер и куда.

Собираем URL постбека

Настройка живёт на странице кампании в табе S2S Postbacks, Add a postback. Три поля:

1. URL - «задайте адрес, куда отправить постбек», собирается плейсхолдерами, которые Keitaro подставляет в момент отправки.
2. Sending method - GET или POST, «что должно быть указано в Источнике» - адресат определяет, что принимает.
3. Status - статус конверсии, зажигающий этот постбек.

Типичный URL для площадки или источника несёт идентичность и деньги:

https://destination.example/track?clickid={external_id}&event={status}&payout={conversion_revenue}

Плейсхолдер, который решает доставку, - переносчик click ID {external_id}: «подставляется значение click ID из Источника», а пустое значение означает, что трафик источника никогда не передавал параметр - на чём матчить, неизвестно. Деньги едут в {conversion_revenue}, состояние - в {status}, а контекст кампании несёт семейство с подчёркиванием: {_sub_id_N}, {_offer_name}, {_campaign_name} (документация S2S постбеков). Полный каталог плейсхолдеров - таймстампы, конвертация валют, статусные маппинги вроде {status:lead=install sale=bill} - живёт в справочнике макросов.

Маршрутизация по статусам: одна сетка, много адресатов

Поле статуса в каждой строке постбека - механизм маршрутизации. Двухпоточная настройка - паттерн из гайда про холд-статусы - это буквально две строки:

Отклонения никуда не маппятся; ребиллам нужен транзакционный параметр, как в гайде о статусах. Поскольку строки привязаны к кампании, одна и та же политика повторяется на кампанию - поэтому слой доставки над трекером, читающий те же статусы, масштабируется лучше десятков скопированных вручную строк.

Очередь, дедуп и логи

После настройки три поведения определяют ежедневную эксплуатацию:

1. Очередь. Запросы «собираются в очередь и отправляются» отдельно - отказ адресата не теряет конверсии, а откладывает их.
2. Дедуп. Дублирующие конверсии исключаются из очереди: идентичная перерегистрация не перезапускает постбек. Изменённая конверсия (новые параметры на том же subid) сначала перезаписывает строку - правило входящей стороны из постбек-контракта Keitaro, - а затем стреляет заново.
3. Лог. Maintenance, Logs, S2S postbacks показывает, «какой subid инициирует S2S-отправку, какая ссылка конвертнула», и ответ адресата. Ошибки в ответе выясняются с адресатом - лог говорит, что было сказано, но не что адресат имел в виду.

Пара «очередь + лог» заодно становится диагностическим циклом каждой интеграции ниже: когда отчёт площадки выглядит жидко, S2S-лог - первый свидетель.

Тест настройки

Приёмочный тест имеет три контрольные точки:

1. Вызовите реальную конверсию через кампанию (тестовые постбеки сетей не несут настоящего subid).
2. Прочитайте Maintenance, Logs, Postbacks: конверсия зарегистрирована с верным статусом.
3. Прочитайте Maintenance, Logs, S2S postbacks: исходящая строка выстрелила, плейсхолдеры разрешились - непустой {external_id}, настоящая выплата, - и адресат ответил.

Бесплатные проверки площадочной стороны тоже доступны: Pixel Activator проверяет Meta-адресата без инфраструктуры, а чеклист поиска неисправностей постбеков покрывает режимы отказа между пунктами.

Keitaro S2S постбек: частые вопросы

Источники