Сверка конверсий по API: как находить потерянные постбеки

Постбек — это один HTTP-запрос от сети к вашему трекеру. Если он не дошёл, трекер об этом не узнает: заявка есть в кабинете сети, деньги начислены, а в отчёте по кампании её нет. Вы режете связку, которая на самом деле в плюсе, или продолжаете лить в минус, думая, что сеть «ещё не подтвердила».

Потерянные постбеки не видны изнутри трекера по определению. Их можно найти только одним способом — сравнить то, что знает сеть, с тем, что знает трекер. Ниже — как эта сверка устроена в inotrack, как включить её по API для Admitad, CityAds и Leads.su и как читать отчёт.

Почему постбеки теряются

Причины скучные и повторяются у всех:

• Сеть не отправила. Сбой очереди на стороне сети, постбек отключили при правке настроек, модерация ссылки ещё не пройдена.
• Сеть отправила не на все статусы. Например, в кабинете включена отправка только на создание заявки, а на одобрение и отказ — нет. Бывает и так, что сеть в принципе не шлёт постбек на отдельный переход статуса.
• Трекер был недоступен. Перезагрузка сервера, истёкший сертификат, проблема с DNS. Часть сетей повторяет отправку, часть — нет.
• Постбек дошёл, но не сопоставился. Нет clickid, клик не найден, статус не из словаря. Такие случаи inotrack складывает в карантин с причиной — они не потеряны, их видно во вкладке «Карантин». Но их тоже нужно разобрать.

Первые три случая карантин не поймает: до трекера ничего не дошло.

Три способа сверки

В inotrack сверка с сетью — один механизм с тремя источниками данных.

1. Файл. Во вкладке «Сверка с сетью» раздела «Постбеки» загружается выгрузка конверсий из кабинета: CSV или XLSX до 10 МБ и 50 000 строк. Подходит для любой сети, у которой есть экспорт.
2. Кабинет Unicom24. У сети нет API статистики для партнёров, поэтому трекер входит в кабинет под вашим логином и раз в сутки забирает детальный отчёт за 30 дней.
3. API сети. Для Admitad, CityAds и Leads.su трекер сам забирает конверсии по API — по расписанию, без файлов.

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

Как работает сверка по API

Раз в час планировщик интеграций запрашивает у сети конверсии за окно — по умолчанию за последние 7 дней. Каждая строка сети сопоставляется с конверсиями трекера по clickid и идентификатору заявки.

Откуда берётся clickid:

Сеть	Метод API	clickid	Идентификатор заявки
Admitad	статистика действий	subid	action_id
CityAds	статистика заказов по дате конверсии	xid	submissionID или orderID — на выбор
Leads.su	список конверсий, все статусы	aff_sub1	id конверсии

Сверка сравнивает строки сети с постбеками конкретного подключения — того, что заведено в «Постбеках» у этого же рекламодателя. Если такого подключения нет, сравнивать не с чем: плановая сверка тихо пропускается и повторит попытку через сутки.

Свежие конверсии не трогаются

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

Как включить

Сверка включается в настройках подключения сети: «Интеграции» → «Партнёрские сети», источник — «API сети по расписанию».

1. Заведите подключение постбеков. Сначала должны работать обычные постбеки — как их настроить, разобрано в статье о постбеках Leads.su, Admitad и CityAds.
2. Подключите сеть по API. Нужен токен или ключи из кабинета сети и привязка к рекламодателю.
3. Оставьте режим «Только отчёт». Он стоит по умолчанию: сверка строит отчёт и ничего не записывает.
4. Откройте первый отчёт. Он появится в истории сверок подключения с подписью вида «сверка API · Leads.su».
5. Включите дозапись, когда отчёт выглядит правдоподобно.

Поля настройки:

Поле	По умолчанию	Диапазон
Сверка конверсий по API	только отчёт	отчёт, отчёт и дозапись, не сверять
Окно сверки	7 дней	от 1 до 30
Интервал сверки	60 минут	от 15 минут до суток
Ждать постбек свежей конверсии	120 минут	до суток

Окно больше 30 дней не задаётся: дальше трекер не помнит решений по заявкам, и сверка не смогла бы отличить новое от уже учтённого.

Как читать отчёт

Каждая строка сети получает один из итогов:

• Совпадает — конверсия есть, статус и сумма те же.
• Потеряна у нас — в сети конверсия есть, в трекере нет. Это и есть потерянный постбек.
• Статус отстал — у нас лид, а сеть уже одобрила или отклонила. Потерян постбек о смене статуса.
• Статусы расходятся — у нас и у сети разные решения по одной заявке, либо идентификаторы заявок не совпали (об этом ниже).
• Сумма расходится — статус тот же, выплата другая.
• Есть только у нас — трекер знает о конверсии, а сеть в выгрузке её не показала.
• У нас статус новее — в трекере статус заявки более поздний, чем в данных сети; обычно статистика сети просто ещё не обновилась.
• Пропущена — нет clickid, строка старше окна, клика с таким clickid нет, статус не распознан или строка повторяется.

В таблице отчёта есть фильтр «Требуют внимания»: он оставляет потерянные, отставшие, расходящиеся по статусу и сумме и те, что есть только у нас.

Агрегат за период попадает ещё и в финансовый раздел: «Финансы» → «Сверка» показывает число конверсий и сумму у вас и у сети и подсвечивает расхождение выше порога.

Что делает дозапись

В режиме «Отчёт и дозапись» две категории строк ставятся в обычную очередь приёма постбеков — так, будто сеть прислала их сама:

• потерянные конверсии создаются;
• отставший статус обновляется в той же конверсии.

Дальше они проходят тот же путь, что любой постбек: словарь статусов, дедупликация, антифрод, пересчёт валюты, запись. Отличия дозаписанной конверсии:

• дата берётся из данных сети, а не «сейчас», и не может оказаться раньше клика;
• капы её не считают — иначе старая заявка съела бы сегодняшний лимит оффера;
• в событии и в вебхуке у неё отмечено происхождение «сверка»;
• при дозаливке из файла исходящие постбеки в источники трафика по умолчанию не уходят — это переключатель в форме.

Остальные расхождения — сумма, конфликт статусов, «есть только у нас» — автоматически не исправляются. Это решения, которые принимает человек.

Почему не появляются дубли

Главный страх перед автоматической дозаписью — задвоить конверсии. Защита двухслойная.

Дедупликация. Ключ конверсии — сеть, clickid, цель и идентификатор заявки. Повторный прогон сверки с теми же данными ничего не создаёт. Поздний постбек с тем же идентификатором заявки после дозаписи тоже не создаст вторую конверсию.

Проверка идентификаторов. Слабое место — когда идентификатор заявки в статистике сети и в постбеке разный. Тогда дозаписанная конверсия и поздний постбек легли бы рядом. Сверка это ловит: если по клику у трекера есть конверсии, но ни один идентификатор из данных сети с ними не совпал, строка получает итог «Статусы расходятся», а не «Потеряна у нас», и не дозаписывается.

Отсюда практическое правило: сначала отчёт, потом дозапись. Если в первом отчёте много строк «Статусы расходятся» по кликам, у которых конверсии есть, — идентификаторы не совпадают. Что делать:

• CityAds. Документация сети не говорит, какой идентификатор статистики совпадает с макросом постбека. В настройках интеграции переключите «ID конверсии для сверки» с submissionID на orderID и посмотрите следующий отчёт. Если не совпадает ни один — выберите «Не сопоставлять по ID».
• Leads.su. Если постбек не передаёт идентификатор конверсии, выберите «Не сопоставлять по ID».
• Admitad. Проверьте, что в параметр транзакции постбека приходит идентификатор действия.

Что делать с результатами

Сверка — не только способ дозаписать деньги. Отчёт показывает, что именно сломано.

• Много потерянных подряд за один период. В эти часы трекер был недоступен или сеть не отправляла. Проверьте журнал сервера и статус постбека в кабинете сети.
• Потерянные только по одному офферу. У оффера своя постбек-ссылка в кабинете сети или clickid не доходит в его ссылке.
• Массово «Статус отстал». Сеть не шлёт постбек на смену статуса. Включите в кабинете отправку на одобрение и отказ.
• Массово «Сумма расходится». Сеть корректирует выплаты после постбека или маппинг читает не тот параметр суммы.
• Много «Есть только у нас». Сеть не засчитала заявки, о которых прислала постбек. Это вопрос к менеджеру сети, и отчёт — готовый аргумент.

Каждый прогон записывается и в журнал загрузок самой интеграции: сколько строк получено, сколько свежих отложено, чем закончилась сверка. Ошибка API сети — истёкший токен, недоступный сервер — видна там же.

Чего сверка не делает

• Не заменяет постбеки. Она работает раз в час и с задержкой на свежие конверсии. Оптимизация рекламных кабинетов, правила и капы живут на постбеках.
• Не работает без подключения постбеков. Сравнение идёт с постбеками конкретного подключения рекламодателя.
• Не покрывает все сети по API. Адаптеры есть для Admitad, CityAds и Leads.su. Для Unicom24 — сверка через кабинет, для остальных — файлом.
• Не возвращает то, чего нет у сети. Если сеть сама потеряла заявку, сверка её не найдёт.

Чтобы узнать о проблеме раньше ближайшего прогона, пригодится алерт о тишине постбеков: трекер сообщает в Telegram, когда от сети перестали приходить конверсии. Он описан на странице алертов.

Итог

Потерянный постбек — это не редкая авария, а фоновая утечка, которую не видно без сравнения с сетью. Включите сверку по API в режиме отчёта, посмотрите первый прогон, убедитесь, что идентификаторы заявок совпадают, и только потом включайте дозапись. Формат постбеков и подробности сверки — в руководстве по постбекам, как расхождения выглядят в деньгах — на странице финмодуля, а список сетей и способов подключения — в разделе партнёрских сетей.