Постбэки и цели
Подписанный POST, GET-ссылка и цели воронки: как передать конверсию в сеть.
Постбэк — это запрос от вашего сервера к сети: «заказ такой-то состоялся». Сеть не видит вашу CRM и не знает о продаже ничего, пока вы о ней не сообщите. Гайд собирает всё о приёме конверсий в одном месте: адреса, подпись, статусы, цели, проверку и разбор ошибок.
Как считается конверсия
| Шаг | Кто | Что происходит |
|---|---|---|
| 1. Переход | партнёр | человек приходит по ссылке; сеть создаёт клик и передаёт его идентификатор click_id параметром в адресе вашего сайта |
| 2. Сохранение | вы | click_id сохраняется в заказе рядом с его номером — единственная нить между переходом и продажей |
| 3. Постбэк | ваш сервер | заказ подтверждён — вы вызываете адрес постбэка оффера с click_id, номером заказа и статусом |
| 4. Холд | сеть | вознаграждение считается по условиям оффера и резервируется на срок холда |
| 5. Выплата | сеть | холд закончился — деньги доступны партнёру |
Постбэк без click_id сеть отклонит с 400 INVALID_INPUT. Если click_id пришёл, но такого перехода нет (потерян, искажён по дороге), сеть запишет факт продажи в состояние «переход не найден»: привязки к партнёру нет, денег никто не получает. Проверьте, что параметр доживает до создания заказа — чаще всего он теряется между лендингом и формой оплаты.
Быстрый старт: пять шагов
Всё, что нужно, — на странице «Приём результата (S2S)» в кабинете рекламодателя.
| Шаг | Где | Что сделать |
|---|---|---|
| 1 | страница S2S, карточка оффера | скопируйте адрес постбэка вида https://api.recca.ru/cpa/postback/<offer_id> |
| 2 | страница S2S | нажмите «Выпустить секрет» и сохраните сразу: показывается один раз |
| 3 | ваш сайт | сохраняйте click_id из адреса в заказ, как utm-метки |
| 4 | CRM или сервер | отправьте постбэк при подтверждении заказа — способом ниже |
| 5 | страница S2S | виджет «Проверить интеграцию», затем «Журнал постбэков» |
Две двери
| POST с подписью | GET-ссылка | |
|---|---|---|
| кому подходит | есть разработчик | в CRM есть только поле «URL постбэка» |
| параметры | тело JSON | строка запроса |
| право доступа | HMAC-подпись в заголовке | токен secure в адресе |
| секрет | не покидает ваш сервер | токен виден в журналах промежуточных серверов |
| статус | рекомендуемый | запасной |
POST с подписью
Запрос
POST https://api.recca.ru/cpa/postback/<offer_id>
Content-Type: application/json
X-CPA-Signature: <подпись>
{
"click_id": "clk_a1b2c3",
"external_id": "order-10421",
"status": "confirmed",
"sum_rub": 5000,
"sub_id": null
}
Поля
| Поле | Обязательно | Что это |
|---|---|---|
click_id | да | идентификатор перехода, пришедший вам в ссылке |
external_id | да | ваш номер заказа; ключ идемпотентности — повтор не создаёт вторую конверсию |
status | да | статус заказа у вас, см. таблицу ниже |
sum_rub | для процентных моделей | сумма заказа в рублях |
sub_id | нет | сквозная метка партнёра, если получали её в ссылке |
goal | нет | код цели воронки; не передан — основная ставка оффера |
| Ограничение | Значение |
|---|---|
external_id, sub_id | до 200 символов; номер заказа не может начинаться с recca: |
sum_rub | число |
goal | латиница, цифры и _ . -, до 64 символов |
Метки sub_id_2…sub_id_10 и идентификатор лендинга сеть берёт только из самого перехода: это разметка партнёра, и принять её из постбэка значило бы позволить рекламодателю переписывать разрез отчёта партнёра.
Подпись
HMAC-SHA256 в шестнадцатеричном виде, секретом оффера, от строки, собранной через двоеточие:
click_id:external_id:status:sum_rub:sub_id[:goal[:timestamp]]
| Форма | Когда получается | Пример |
|---|---|---|
| 5 сегментов | goal не передан, метки времени нет | clk:order-1:confirmed:: |
| 6 сегментов | goal передан — даже goal=1 | clk:order-1:confirmed::lead |
| 7 сегментов | передан X-CPA-Timestamp; цели нет — шестой сегмент пустой | clk:order-1:confirmed::lead:1760000000 |
| Правило | Почему |
|---|---|
| пустые значения остаются пустыми сегментами | нет суммы и метки — строка заканчивается двумя двоеточиями; разделители не схлопываются |
| порядок полей фиксирован | не зависит от порядка полей в JSON |
шестой сегмент появляется по факту передачи goal | правило про присутствие поля, а не про значение |
| метка времени делает строку семисегментной всегда | иначе шесть сегментов означали бы то ли цель, то ли метку, и по содержимому их не отличить |
Необязательные заголовки
| Заголовок | Что делает | Ответ при нарушении |
|---|---|---|
X-CPA-Timestamp | метка Unix в секундах; окно свежести ±5 минут | 403 STALE_SIGNATURE — чинится часами, а не секретом |
X-CPA-Key-Id | current или previous; после ротации прежний секрет принимается ещё 7 суток | 403 UNKNOWN_KEY_ID |
Повторяя отложенный постбэк из очереди, подписывайте его заново с текущей меткой: старую подпись окно уже не пропустит. Заголовок ключа без ротации не нужен — сеть проверяет оба слота сама.
Примеры
bash
SECRET="ваш_секрет"
CANON="clk_a1b2c3:order-10421:confirmed:5000:"
SIG=$(printf '%s' "$CANON" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print $2}')
curl -X POST "https://api.recca.ru/cpa/postback/$OFFER_ID" \
-H "Content-Type: application/json" \
-H "X-CPA-Signature: $SIG" \
-d '{"click_id":"clk_a1b2c3","external_id":"order-10421","status":"confirmed","sum_rub":5000}'
PHP
$canon = implode(':', [$clickId, $orderId, 'confirmed', (string)$sum, '']);
$sig = hash_hmac('sha256', $canon, $secret);
$ch = curl_init("https://api.recca.ru/cpa/postback/{$offerId}");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json', "X-CPA-Signature: {$sig}"],
CURLOPT_POSTFIELDS => json_encode([
'click_id' => $clickId, 'external_id' => $orderId,
'status' => 'confirmed', 'sum_rub' => $sum,
]),
CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
Python
import hmac, hashlib, requests
canon = f"{click_id}:{order_id}:confirmed:{sum_rub}:"
sig = hmac.new(secret.encode(), canon.encode(), hashlib.sha256).hexdigest()
requests.post(
f"https://api.recca.ru/cpa/postback/{offer_id}",
json={"click_id": click_id, "external_id": order_id,
"status": "confirmed", "sum_rub": sum_rub},
headers={"X-CPA-Signature": sig},
timeout=10,
)
Node.js
import { createHmac } from 'node:crypto'
const canon = [clickId, orderId, 'confirmed', String(sum), ''].join(':')
const sig = createHmac('sha256', secret).update(canon).digest('hex')
await fetch(`https://api.recca.ru/cpa/postback/${offerId}`, {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'X-CPA-Signature': sig },
body: JSON.stringify({
click_id: clickId, external_id: orderId,
status: 'confirmed', sum_rub: sum,
}),
})
Ответы
| Код | Что значит |
|---|---|
201 | конверсия создана |
200 с idempotent: true | заказ уже был засчитан; второй раз вознаграждение не начисляется |
400, 403, 404, 409, 500 | ошибка; код в теле — расшифровка в разделе «Коды ошибок» |
429 | превышен лимит обращений; повторите после паузы из Retry-After |
GET-ссылка для CRM
https://api.recca.ru/cpa/postback/<offer_id>?clickid={click_id}&action_id={order_id}&goal={goal}&sum={sum}&status=1&sub_id={sub_id}&secure=ВАШ_ТОКЕН_GET
Готовая строка для каждого оффера — на странице S2S, поле «Ссылка для CRM (GET)»: замените плейсхолдеры на макросы вашей CRM.
Токен secure
В адрес вставляется отдельный токен вида cpag_…, который выдаётся вместе с секретом — при создании оффера и при каждой ротации. Это не секрет подписи: он в адресную строку не попадает никогда. Токен выведен из секрета, поэтому ротация секрета отзывает и его — отдельной кнопки отзыва нет. Засветился — выпустите новый секрет на странице S2S и замените токен в CRM.
Имена параметров
| Что | Как можно назвать |
|---|---|
| идентификатор перехода | clickid, click_id |
| ваш номер заказа | action_id, external_id, actionid, order_id |
| сумма заказа | sum, sum_rub, amount |
| метка партнёра | sub_id, sub1, sub_id1 |
| цель воронки | goal |
| токен доступа | secure |
Сумма принимается и с точкой, и с запятой: 5000, 5000.50, 5000,50.
Значения status
| Код | Что означает |
|---|---|
1 | подтверждено — начинается холд |
2 | ожидание — конверсия записана, вознаграждение не начисляется |
3 | отмена — гасит конверсию по политике сети |
5 | у нас равно 1: подтверждение и так лежит на холде до конца срока |
Два умолчания: нет status — постбэк считается подтверждением; нет action_id — номером заказа становится сам переход (click:{clickid}), и повторный вызов той же ссылки ничего не задваивает.
Проверка живого адреса:
curl -i "https://api.recca.ru/cpa/postback/$OFFER_ID?clickid=clk_test&action_id=order-1&sum=1000&status=1&secure=$GET_TOKEN"
201 — конверсия создана; 403 — токен не тот; 400 — нет clickid либо адрес оффера неверный.
Статусы, холд, отмена
Что вы присылаете
Числа понимает только GET-ссылка; в POST-запросе шлите слова — строго строчными.
POST:
| Значение | Как поймёт сеть |
|---|---|
pending, wait, waiting, on_hold | ожидание — конверсия записана, вознаграждение не начисляется |
cancel, reject | отмена — гасит конверсию |
любое другое слово (approved, sale…) | подтверждение — начинается холд |
⚠ Любое слово, которого нет в первых двух строках, — это подтверждение. declined, 3, Cancel в POST не отменят конверсию, а начнут холд.
GET:
| Значение | Как поймёт сеть |
|---|---|
1, 5, confirmed, approved, hold (и confirm, approve) | подтверждено — начинается холд |
2, pending, wait, waiting, on_hold | ожидание |
3, cancel, reject, declined, trash (и cancelled, rejected, decline) | отмена — гасит конверсию |
любое другое значение или пустой status | подтверждение |
В GET регистр не важен.
Что происходит на нашей стороне
| Состояние конверсии | Деньги партнёру |
|---|---|
| переход не найден | нет; более поздний постбэк с верным click_id поднимет ту же строку |
| ожидание | нет |
| холд | зарезервированы, идёт срок возврата |
| подтверждено | доступны к выплате |
| отменено | нет; состояние конечное |
Переходы намеренно узкие: из «подтверждено» назад в холд конверсия не возвращается — деньги не ходят задним ходом. Единственный выход из «подтверждено» — отмена с возвратом.
Отмена и возврат
Отправьте постбэк с тем же номером заказа и статусом отмены. Если заказ засчитан по цели, отмену нужно слать с той же целью — иначе сеть ответит, что отменять нечего.
| Где вознаграждение | Что произойдёт |
|---|---|
| на холде | аннулируется, никто ничего не теряет |
| начислено, но не выплачено | создаётся обратная проводка |
| уже выплачено | по политике сети: удержание из будущих выплат или списание за счёт сети |
Повторная отмена безопасна: операция идемпотентна и второй раз ничего не меняет.
Цели воронки
Один переход часто приносит цепочку событий: заявка, оплата, продление. Цели позволяют не заводить отдельный оффер на каждое.
...&action_id=order-10421&goal=lead → заявка, ставка 300 ₽
...&action_id=order-10421&goal=deposit&sum=5000 → оплата, 12 % от суммы
Оба постбэка идут по одному переходу и с одним номером заказа — это две разные конверсии, каждая по своей ставке и со своим холдом.
| Правило | Как работает |
|---|---|
goal не передан | действует цель по умолчанию 1 — основная ставка оффера |
| уникальность | тройка «сеть + номер заказа + цель»; повтор той же тройки идемпотентен |
| один клик — одна выплата на цель | второй заказ той же цели с того же перехода → 409 ALREADY_CONVERTED, в сообщении — номер занявшего заказа |
| исключения | модель revshare; цель-веха; цель с флагом «несколько конверсий с клика» |
| неизвестная цель | отказ 400 UNKNOWN_GOAL — молча заплатить по чужой ставке хуже, чем отказать |
| выключенная цель | отказ 409 GOAL_DISABLED — оператор сети временно остановил приём новых конверсий по цели; уже записанные подтверждаются и возвращаются как раньше |
| лимит оффера | до 50 целей |
Флаг «несколько конверсий с клика» у цели включает оператор сети: тогда каждый заказ той же цели с того же перехода платится своей конверсией. В списке целей на странице S2S у каждой видны код, название, ваша ставка, холд и этот флаг; цель с кодом 1 переопределяет основную ставку оффера. Выключенная цель в этом списке помечена отдельно — приём по ней остановлен до включения.
Оператору: капы оффера считают каждую денежную конверсию независимо от цели — воронка из двух целей расходует кап вдвое быстрее.
Веха — цель за ноль: она не создаёт вознаграждения и не расходует лимит, но показывает доходимость воронки — где именно она ломается.
Макросы адреса рекламодателя
Для операторов и партнёров: в адрес, куда сеть отправляет трафик, можно вставить макросы.
| Макрос | Что подставится |
|---|---|
{clickid}, {click_id} | идентификатор перехода |
{pid}, {partner_id} | псевдоним партнёра для этого оффера |
{subid}, {sub_id} | метка партнёра |
{sub1} … {sub10} | метки партнёра, имена Affise |
{sub_id_2} … {sub_id_10} | дополнительные метки партнёра |
{webmaster_id}, {aff_id} | номер вебмастера — только если сеть включила передачу, иначе пусто |
{offer_id} | идентификатор оффера |
{landing_id} | идентификатор лендинга |
| Правило | Поведение |
|---|---|
| неизвестный макрос | раскрывается в пустую строку |
click_id не дописывается сам | в адресе с макросами идентификатор перехода берите макросом {clickid} |
| значения кодируются | подстановка URL-кодируется |
Про {pid}: это не идентификатор партнёра, а псевдоним, стабильный в пределах одного оффера, — ключ для вашей отчётности, который не позволяет опознать одного и того же партнёра в разных офферах и сетях. Про {webmaster_id}: короткий номер вебмастера слепоту снимает, поэтому по умолчанию выключен; включает владелец сети в «Правилах сети».
Пример: https://example.com/promo?utm_campaign={pid}&clickid={clickid}
Повторы и лимиты
| Ситуация | Ответ двери |
|---|---|
| повтор с тем же заказом и целью, та же сумма | 200, idempotent: true — повторная отправка безопасна |
| повтор с другой суммой | 409 IDEMPOTENT_MISMATCH: сумма — часть операции; другое событие шлите своим номером |
| номер заказа занят чужим оффером той же сети | 409 EXTERNAL_ID_CONFLICT — добавьте свой префикс к нумерации |
Повтор — правильный способ пережить обрыв связи. Лимиты: 2 000 запросов в минуту на оффер (оператор может задать своё значение от 60 до 20 000) и 30 отказов по праву в минуту с одного адреса (неверная подпись, неверный токен, несуществующий оффер — верно подписанные запросы это ведро не расходуют); превышение — 429 RATE_LIMITED с заголовком Retry-After. Номер заказа уникален в пределах сети, а не оффера.
Проверка интеграции
Виджет «Проверить интеграцию»
Вставьте секрет ровно так, как он прописан в вашей CRM — с теми же пробелами и кавычками. Сеть подпишет тестовый постбэк именно им и прогонит через боевой приёмник: несовпадение секрета вы увидите здесь, а не на первом реальном заказе. Тестовая конверсия создаётся по-настоящему, но помечается и не попадает ни в статистику, ни в счёт, ни в выплаты.
Журнал постбэков
Каждый запрос к вашим офферам за последние 90 дней: время, оффер, дверь (POST или GET), цель, ваш номер заказа, присланный статус дословно, ответ сети.
| Симптом | Причина | Что делать |
|---|---|---|
| строки нет | запрос не дошёл, либо в адресе неверный идентификатор оффера — такие не записываются | проверьте адрес и то, что сервер вообще отправляет запрос |
ответ 403 | не совпал секрет или подпись | виджет проверки |
200 и «повтор» | заказ уже был засчитан | не ошибка: задвоение исключено |
| «переход не найден» | click_id потерян между лендингом и формой | проверьте передачу параметра до создания заказа |
Оператор сети видит тот же журнал по всем рекламодателям: обращаясь в поддержку, называйте время запроса и номер заказа.
Коды ошибок
Каждый ответ приёмника несёт код. Ниже — все коды, которые может увидеть рекламодатель, и что с ними делать.
INVALID_INPUT · HTTP 400
Не хватает обязательного поля либо значение не проходит проверку: нет click_id, external_id или status; сумма не число или больше допустимого; sub_id длиннее 200 символов; код цели содержит недопустимые символы.
Что делать: Сверьте отправляемые поля со списком в разделе «Поля» выше. Частая причина — макрос CRM не подставился и уехал в запрос как есть (sum={cost_money_value}).
OFFER_NOT_FOUND · HTTP 400
В адресе указан идентификатор оффера, которого нет, либо у оффера не заведены условия CPA и секрет.
Что делать: Возьмите адрес постбэка со страницы «Приём результата (S2S)» — там он готовый, для каждого вашего оффера. Такой запрос не попадает в журнал: он не принадлежит ни одной сети.
BAD_SIGNATURE · HTTP 403
Подпись в заголовке X-CPA-Signature не совпала с той, что ожидает сеть: другой секрет либо строка собрана в другом порядке.
Что делать: Проверьте секрет виджетом «Проверить интеграцию» — он подписывает тестовый постбэк ИМЕННО тем секретом, который вы вставите, и прогоняет через боевой приёмник. Если секрет верный — проверьте порядок полей в строке подписи и то, что пустые значения остаются пустыми сегментами.
BAD_SECURE · HTTP 403
В GET-ссылке параметр secure не совпал с токеном оффера. ⚠ Туда вставляется НЕ секрет подписи, а отдельный токен вида cpag_…: строка запроса целиком попадает в журналы промежуточных серверов, и ключу, которым подписывается тело, там не место.
Что делать: Токен выдаётся вместе с секретом — при создании оффера и при каждой ротации, один раз. Если он утерян, выпустите новый секрет на странице S2S: токен перевыпустится вместе с ним. Прежнее значение параметра (сам секрет) больше не принимается — это не переходный период, а смена контракта.
STALE_SIGNATURE · HTTP 403
Подпись верна, но заголовок X-CPA-Timestamp вне окна свежести — пять минут в обе стороны — либо не является меткой времени Unix в секундах.
Что делать: Сверьте часы сервера, с которого уходят постбэки: окно двустороннее, поэтому спешащие часы отбиваются так же, как отстающие. Если вы повторяете отложенный постбэк из очереди — подписывайте его ЗАНОВО с текущей меткой, а не отправляйте сохранённое тело со старой.
UNKNOWN_KEY_ID · HTTP 403
Заголовок X-CPA-Key-Id назвал слот секрета, которого не существует. Допустимы current и previous.
Что делать: Заголовок необязателен: без него сеть проверяет оба слота сама. Присылайте его, только если точно знаете, каким ключом подписали; неизвестное значение отбивается намеренно, иначе заголовок ничего не означал бы.
WINDOW_EXPIRED · HTTP 409
Клик состоялся раньше, чем позволяет окно атрибуции оффера: заказ пришёл, но связывать его с этим переходом уже поздно.
Что делать: Смотрите «Окно атрибуции» в условиях оффера. Если ваш цикл сделки длиннее окна — договоритесь с сетью об увеличении, задним числом конверсия не засчитывается.
ALREADY_CONVERTED · HTTP 409
По этому переходу уже засчитана конверсия на ту же цель, но с другим номером заказа. Один клик оплачивается один раз на цель.
Что делать: Если это продолжение воронки — пришлите постбэк с другой целью (goal), а не с новым номером заказа. Если это тот же заказ — отправьте прежний external_id, и повтор попадёт в идемпотентность.
ILLEGAL_TRANSITION · HTTP 409
Запрошенный переход статуса невозможен: например, подтвердить конверсию, по которой уже прошёл возврат.
Что делать: Посмотрите текущий статус заказа в сверке. Отменённая конверсия терминальна — новое подтверждение оформляется новым external_id.
UNKNOWN_GOAL · HTTP 400
В постбэке указана цель, которой у оффера нет.
Что делать: Список целей оффера — на странице S2S под ставкой. Сеть намеренно не подставляет ставку «по умолчанию» вместо неизвестной цели: заплатить по чужой ставке хуже, чем отказать.
GOAL_DISABLED · HTTP 409
Цель выключена оператором сети, а конверсии по ней раньше не было: новые конверсии по выключенной цели не принимаются. Отказ виден в журнале постбэков с этим кодом.
Что делать: Это состояние конфликта, а не кривой запрос: ставки и история цели сохранены, но приём остановлен. Попросите оператора включить цель на странице целей оффера либо шлите другую цель. Уже записанные конверсии по ней подтверждаются и возвращаются как раньше — отказ касается только новых.
EXTERNAL_ID_CONFLICT · HTTP 409
Этот номер заказа уже занят в сети по этой же цели — но другим оффером, не вашим.
Что делать: Номер заказа уникален в пределах СЕТИ, а не оффера, поэтому у двух рекламодателей со сквозной нумерацией с единицы номера пересекутся. Добавьте к external_id собственный префикс. Раньше в этом случае постбэк молча переписывал чужую конверсию, поэтому отказ — это не новое ограничение, а прекращение тихой порчи данных.
IDEMPOTENT_MISMATCH · HTTP 409
Постбэк по этому заказу и этой цели уже приходил, но с ДРУГОЙ суммой. Раньше такой повтор получал успех и прежние деньги — то есть сеть подтверждала сумму, которой не начисляла.
Что делать: Сумма — часть операции, а не её уточнение. Если сумма изменилась (доплата, пересчёт, частичный возврат), это ДРУГОЕ событие: пришлите его под своим external_id. Если это добросовестный повтор — пришлите ту же сумму, и он попадёт в идемпотентность. ⚠ «Не передали сумму» и «передали ноль» — разные значения: постбэк без sum_rub не совпадает с постбэком, где sum_rub=0.
NOT_CONVERTED · HTTP 400
Рекламодатель прислал отмену (статус «отклонено») по заказу, у которого по этой цели ещё не было подтверждения. Это штатный исход, а не сбой: отмена записана (строка «отклонено»), и подтверждение по этому заказу и цели уже не пройдёт. Снаружи ответ всегда 400 — он одинаков для «заказа не было» и «был, но не засчитан», чтобы по ответу нельзя было перебирать чужие номера заказов.
Что делать: Действий не требуется, если рекламодатель и должен был отклонить этот заказ (например, цель «сделка провалена»). Ошибка — только если вы ждали ПОДТВЕРЖДЕНИЕ по этому заказу: тогда проверьте в журнале, что подтверждение и отмена идут с одним номером заказа и одной целью — отмена ищет конверсию по тройке «сеть + номер заказа + цель».
NOT_FOUND · HTTP 404
Денежная нога отменяемой конверсии не найдена — отменять нечего.
Что делать: Как правило, конверсия уже отменена. Проверьте статус в сверке: повторная отмена безопасна и ничего не меняет.
REVERSAL_FAILED · HTTP 500
Возврат начался, но не завершился на нашей стороне.
Что делать: Повторите запрос: операция идемпотентна. Если повторяется — сообщите оператору сети время запроса и номер заказа, строка есть в журнале.
RATE_LIMITED · HTTP 429
Превышен лимит обращений. Вёдер ДВА, и исчерпать достаточно одно: по офферу — 60 запросов в минуту, по адресу отправителя — 300. Ответ несёт заголовок Retry-After с паузой в секундах.
Что делать: Ставьте постбэки в очередь и берите паузу из Retry-After, а не из своей константы. Лимит общий для обеих дверей (POST и GET) — переезд на другой транспорт его не обходит. ⚠ Ведро оффера считается по идентификатору в адресе: несколько ваших офферов не мешают друг другу, а вот один оффер, нагруженный с нескольких серверов, делит общий счёт.
INTERNAL_ERROR · HTTP 500
Сбой на нашей стороне: запрос дошёл, но обработать его не удалось. Конверсия при этом не создана.
Что делать: Повторите запрос позже: приёмник идемпотентен, дубликат не создаст вторую конверсию. Если повторяется — напишите оператору сети.
Постбэки вебмастера: диагностика доставки
Это обратное направление: сеть сообщает о конверсиях на сервер или трекер вебмастера GET-запросом по адресу, который вебмастер задал в кабинете. Адрес собирается из макросов ({click_id}, {sub1} … {sub10}, {transactionid}, {goal}, {sum}, {payout}, {status} и других).
⚠ {click_id} — это идентификатор клика в сети Recca, а не в вашем трекере. Идентификатор клика трекера обычно приезжает в одной из меток (sub1 … sub10) из ссылки, поэтому в адрес подставляйте нужную метку, например {sub2}, а не {click_id}.
| Что в кабинете | Что делает |
|---|---|
| «Проверить» | отправляет тестовую доставку по адресу выбранного статуса. Макросы тестовые: click_id = test_click, метки sub1 … sub10 = test_sub1 … test_sub10, номер заказа test-transaction; настоящий клик не берётся, чтобы тест не создал в трекере живую конверсию. Не чаще пяти проверок за пять минут |
| Журнал доставок | по каждой доставке: адрес как ушёл (токен бота скрыт), код ответа, причина сбоя и отрывок ответа сервера — вебмастеру до 2000 знаков, оператору сети первые 300; токены в отрывке скрыты. Показываются последние сто доставок |
| «Не доходит» | плашка у постбэка: три последние нетестовые доставки подряд мёртвые, ни одной успешной между ними. Одна успешная доставка плашку снимает |
| «Отправить заново» | возвращает в очередь мёртвые доставки за последние семь суток (не больше двухсот за вызов): адрес собирается заново по текущему шаблону. Доставленные и тестовые не трогаются; постбэк должен быть включён; не чаще пяти раз за пять минут |
Успешной считается любая доставка с ответом 2xx. Иначе доставка повторяется с паузами 1 минута, 5 минут, 15 минут, 1 час и 6 часов — всего шесть попыток; после шестой неудачи она становится мёртвой — «Прекращено после ошибок» в журнале.
Частые вопросы
Отправляю сумму, а она не сохраняется
Три проверки по журналу: доехал ли постбэк (есть ли строка); не уехал ли макрос CRM как есть — sum={cost_money_value} вместо числа отбивается как неверный ввод; та ли цель — сумма относится к конверсии той цели, которую вы назвали.
Заявка засчиталась, а оплата — нет
Скорее всего, оба постбэка ушли без цели: второй попадает в идемпотентность первого — номер заказа тот же, цель та же. Передавайте goal для каждого события воронки.
Можно ли слать постбэки с нескольких серверов
Да. Лимит считается на оффер (2 000 запросов в минуту по умолчанию), а не на адрес: с адреса ограничиваются только отказы по праву — 30 в минуту.
Секрет утёк — что делать
Выпустите новый на странице S2S и обновите его в CRM. Прежний принимается ещё 7 суток, но столько же действует и утёкший — меняйте сразу, а неделя пусть остаётся страховкой от простоя.
Оффер ведёт оператор, своего входа нет
Попросите оператора: у него та же кнопка в списке офферов. Секрет показывается один раз — получить и передать его нужно сразу и защищённым каналом.
Тем, кто управляет сетью машиной, а не руками, посвящён соседний гайд: «Go SDK».
О возможности целиком — какие задачи решают постбэки в CPA-сети — читайте на странице Постбэки S2S.