Повторы постбэка и дубли конверсий: как защитить учёт в трекере
Сеть повторяет отправку, если трекер не ответил или вернул 5xx, и при плохой настройке одно событие учитывается дважды. Разбираем, как устроены повторы, откуда берутся дубли и как от них защититься.
Как сеть повторяет постбэк
Если ваш трекер не ответил на запрос или вернул ошибку 5xx, Лидпульт не считает отправку выполненной и пробует снова. Паузы растут: через 30 секунд, затем через 1, 2, 4 минуты и так далее, всего до восьми раз. Такая схема даёт трекеру время восстановиться после кратковременного сбоя и не теряет события при перезапусках и обновлениях на вашей стороне.
Повторы выполняются для того же события. Это не новые статусы, а новые попытки доставить уже существующий. Для сети такая логика единственно правильная, ведь потерянная конверсия означает потерянные деньги для вебмастера.
Откуда берутся дубли
Дубль возникает, когда ваш трекер на самом деле обработал запрос, но не успел ответить вовремя или ответил с ошибкой уже после записи конверсии. Сеть видит неудачу и повторяет отправку, а трекер записывает вторую конверсию. Типичные причины: тяжёлая обработка запроса в самом обработчике, ответ отправляется после записи в базу и обращений к внешним сервисам, перегрузка сервера в часы пик, сбой между записью конверсии и формированием ответа.
Есть и другой источник «дублей», который на деле дублем не является. Статус лида меняется несколько раз, и каждое изменение приносит свой постбэк. Это нормальная работа, и трекер должен обновлять конверсию, а не создавать новую запись на каждое событие.
Правило первое: отвечайте быстро
Лучший способ уменьшить число повторов состоит в том, чтобы отвечать 200 сразу после принятия запроса. Тяжёлую обработку, пересчёты и обращения к внешним сервисам переносите в фоновую очередь. Если запрос принят и поставлен в очередь, можно смело отвечать: сеть получит подтверждение и не станет повторять. Внешние запросы сети идут с таймаутом, поэтому долгая обработка почти гарантированно приведёт к повторам.
Правило второе: делайте обработку идемпотентной
Если запрос пришёл повторно, результат должен остаться тем же. Для этого используйте ключ события. Практичный вариант — комбинация из номера лида и статуса: пара «lead_id плюс status» однозначно определяет событие. Перед записью конверсии проверьте, нет ли уже записи с таким ключом. Если есть, не создавайте новую, а просто ответьте 200.
key = lead_id + ":" + status
if (exists(key)) return 200 // повтор, ничего не делаем
save(key, click_id, payout, status)
return 200Для этого в адрес постбэка добавляйте макрос %lead_id%: без него у вас не будет надёжного ключа.
Правило третье: ставьте статус вместо суммирования
Не прибавляйте выплату при каждом постбэке. Правильная логика такая: у клика одна конверсия, а статус и сумма в ней перезаписываются по приходу новых событий. Тогда повтор события accepted не удвоит доход, а смена с accepted на canceled корректно обнулит его. Если ваш трекер умеет работать только добавлением, настройте учёт так, чтобы засчитывать лишь итоговый статус, а промежуточные игнорировать.
Как обнаружить дубли
- Сравните число принятых лидов в трекере и в кабинете за один период: в трекере больше значит, есть дубли.
- Найдите в трекере конверсии с одинаковым номером лида.
- Посмотрите журнал отправок: серия записей по одному событию с неудачными попытками перед успешной.
- Проверьте время ответа трекера: превышение секунд обычно ведёт к повторам.
Что делать с уже накопленными дублями
Исправьте причину: ускорьте ответ и добавьте проверку ключа. Затем очистите дубли в отчётах: оставьте одну конверсию на каждую пару лид-статус, лишние удалите или пометьте как невалидные. Пересчитайте прибыль за период и сравните с кабинетом сети, чтобы убедиться, что цифры сошлись. Если вы принимали решения о бюджете по завышенным данным, пересмотрите их. Подробности об адресе постбэка и ограничениях изложены в документации API.
Короткий чек-лист
- Обработчик отвечает 200 быстро, тяжёлое уходит в очередь.
- В адресе есть макрос
%lead_id%. - Конверсия идентифицируется по ключу «лид плюс статус».
- Статус и сумма обновляются, а не суммируются.
- Раз в неделю цифры сверяются с кабинетом.
Пример безопасного обработчика на стороне трекера
Представьте обработчик постбэка в виде простой последовательности. Он принимает запрос, проверяет токен, быстро выделяет из запроса номер лида, статус, идентификатор клика и выплату. Затем записывает событие в очередь вместе с ключом и сразу отвечает 200. Отдельный воркер берёт события из очереди, проверяет ключ по уже обработанным и обновляет конверсию. Если один и тот же ключ приходит повторно, воркер просто пропускает его. Даже если сеть повторит отправку восемь раз, конверсия останется одна.
Такая схема заодно защищает от нагрузки: в час пик очередь копится, а не рушит сервер, и ответы сети идут быстро. Для небольших проектов достаточно хранить обработанные ключи в таблице базы данных с уникальным индексом.
Особый случай: смена статуса и повтор
Бывает так, что события приходят не в том порядке: из-за повторов сообщение со старым статусом может прийти после сообщения с новым. Чтобы не откатить конверсию назад, сравнивайте не только ключ, но и логику статусов. Принятый лид не должен перейти обратно в холд из-за запоздавшего повтора. Если ваш трекер хранит время события, используйте его: более позднее событие побеждает. Подход прост, но избавляет от труднообъяснимых расхождений в отчётах.
Напоминание
Повторы нужны для надёжности, а не для удобства вашего трекера. Принимайте их как данность и стройте обработку так, чтобы повторное событие ничего не меняло.
Вопросы и ответы
Сколько раз сеть повторит постбэк?
До восьми раз с растущей паузой: через 30 секунд, 1, 2, 4 минуты и далее. Повторы идут, если трекер не ответил или вернул 5xx.
Повторяет ли сеть постбэк при ответе 4xx?
В документации повторы описаны для случаев, когда трекер не ответил или ответил 5xx. На ошибки 4xx рассчитывать не нужно: исправляйте настройки на своей стороне.
Можно ли отключить повторы?
Нет, это часть доставки. Защищайтесь на стороне трекера: быстрый ответ и проверка ключа события.
Как проверить, что трекер идемпотентен?
Отправьте кнопкой проверки два запроса подряд с одинаковым значением и посмотрите, сколько конверсий появилось в отчёте.
Почему постбэк приходит несколько раз с разными статусами?
Потому что статус лида меняется и сеть сообщает о каждом изменении. Это не ошибка, а нормальный поток событий.