S2S-постбэк: настройка и макросы как в Affise

Технический специалист сети получает задачу «настроить постбэк» и первым делом ищет, какие параметры передавать и что означает каждый макрос. S2S-постбэк — это HTTP-запрос между серверами: рекламодатель сообщает сети о статусе конверсии, а сеть передаёт этот статус дальше вебмастеру. Ниже — как устроена эта цепочка в Recca, какие макросы использовать на каждом шаге и почему перенос постбэков с площадки, работающей по конвенции Affise, занимает часы, а не дни.

Как ходит конверсия

Конверсия проходит через три точки. Пользователь кликает по ссылке вебмастера и получает уникальный идентификатор клика — click_id. Он сохраняется в URL, с которым пользователь доходит до сайта рекламодателя. Когда действие засчитано — покупка, заявка, установка — рекламодатель отправляет постбэк в сеть с этим же click_id и статусом. Сеть находит клик по идентификатору, применяет холд и правила подтверждения, а затем отправляет свой постбэк вебмастеру — уже со статусом, который видит сеть, и суммой выплаты.

Ключевое условие на каждом хопе — не терять и не менять click_id. Если рекламодатель передаёт его с опечаткой или обрезает по длине, сеть не может связать конверсию с кликом, и она уходит в необработанные.

Recca хранит клик и его click_id в кабинете сети — они видны в статистике по рекламодателю и по вебмастеру одновременно, без выгрузки отдельных логов.

Постбэк рекламодателя в сеть

Рекламодатель получает не постбэк, а ссылку — трекинговую ссылку с параметром click_id, который он обязан подставить в свой собственный постбэк-запрос при подтверждении действия. Обязательные параметры на этой стороне:

• click_id (в системе рекламодателя может называться clickid, subid или sub1) — идентификатор, который пришёл в клике;
• статус конверсии — approved, pending, declined, hold;
• сумма — если рекламодатель передаёт вознаграждение сам, а не сеть считает его по ставке оффера.

Если у рекламодателя своя CRM или трекер, а не готовая интеграция, адрес постбэка настраивается один раз в кабинете CPA-агентства — дальше рекламодатель просто дёргает готовый URL с нужными параметрами при смене статуса заявки. Подробнее об устройстве этой связки — в разделе S2S-постбэки.

Постбэк сети вебмастеру — макросы

Сеть собирает у себя статус, сумму и служебные поля и отдаёт их вебмастеру через собственный постбэк с макросами. Вебмастер один раз подставляет макросы в постбэк-URL своего трекера, и дальше сеть заполняет их значениями на каждой конверсии.

Порядок макросов в URL менять можно — сеть подставит значения независимо от позиции. Один и тот же макрос в одном URL используется один раз.

Совместимость с Affise

Формат постбэка в Recca собран по той же конвенции, что использует Affise: те же имена макросов для click_id, статуса, суммы и sub-параметров. У Affise, по документации сервиса, нет отдельного макроса clickid для постбэка на сторону вебмастера — идентификатор клика передаётся через sub1–sub8, и Recca поддерживает такую же передачу. Из-за этого перенос постбэк-ссылок с площадки на конвенции Affise на Recca — это замена домена и токена авторизации в уже готовой ссылке вебмастера, а не переписывание её с нуля.

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

Логи постбэков

Каждый отправленный и полученный постбэк Recca записывает в лог: время, адрес, параметры запроса, код ответа и тело ответа удалённой стороны. Лог доступен по конверсии, по рекламодателю и по вебмастеру — можно посмотреть все постбэки за период или найти конкретный click_id.

Если конверсия не долетела до вебмастера, лог показывает, на каком хопе она потерялась: рекламодатель не отправил постбэк, сеть не нашла click_id по своей базе, или запрос до сервера вебмастера вернул код ошибки. Что попадает в лог и как его фильтровать — в разделе S2S-постбэки.

Типовые ошибки

Три ситуации повторяются чаще остальных.

Потерянный click_id. Рекламодатель обрезал параметр по длине или передал его в другом поле — сеть получает постбэк без идентификатора и не может сопоставить его с кликом. Решение — заранее проверить лимит длины click_id в системе рекламодателя.

Повтор конверсии. Ретраи на стороне рекламодателя или сети создают несколько постбэков с одним click_id. Без проверки на дубликат вебмастер получает одну и ту же конверсию дважды. Recca помечает повторные постбэки по одному click_id и статусу, но окончательное решение о повторе — за трекером вебмастера.

Неверный протокол или домен. Постбэк-URL с http вместо https или с опечаткой в домене возвращает ошибку соединения ещё до обработки параметров — такую ошибку лог показывает по коду ответа, а не по логике конверсии.

Проверка

Перед тем как включать постбэк на реальном трафике, стоит прогнать одну тестовую конверсию по всей цепочке: клик с тестовым click_id, статус от рекламодателя, обработка холда в сети, постбэк вебмастеру. Если тестовая конверсия дошла до вебмастера с тем же click_id и корректной суммой — цепочка настроена верно.

Правила холда и подтверждения конверсий настраиваются отдельно — см. холды и подтверждение конверсий: они не влияют на сам постбэк, но определяют, когда сеть его отправит.

Настроить постбэки для своей CPA-сети можно на тарифе «CPA-сеть» — оставить заявку на подключение или посмотреть остальные тарифы на странице цен.