Постбэки не приходят: чек-лист диагностики

Если конверсии не появляются в Adset или не доходят до источника трафика — пройдите шаги ниже по порядку.

Напомним цепочку: при клике Adset создаёт внутренний event_click_id и передаёт его в CPA-сеть (обычно как sub1 или clickId); при конверсии партнёрка вызывает postback URL и возвращает этот ID; Adset находит клик и отправляет событие в источник, используя сохранённый ext_click_id. Подробнее: Как работают постбэки: простыми словами

Шаг 1. Проверьте URL постбэка у партнёрки

Входящий постбэк Adset принимает параметры clickId, status, revenue, currency, externalId. Пример глобального postback URL:

https://adset.pro/postback/?clickId={ref_id}&status={status}&revenue={sum}&currency={currency}

{ref_id}, {status}, {sum}, {currency} — макросы партнёрки, у каждой CPA-сети они свои.

Возможны два подхода:

• Один глобальный URL — статус приходит через макрос. В настройках партнёрской программы в Adset должны быть добавлены все возможные значения статусов.
• Раздельные URL под каждый статус — значение status задаётся жёстко в URL и должно точно совпадать со значением из шаблона статусов постбэка.

Подробнее: Статусы конверсий и настройка postback

Шаг 2. Проверьте, что click id передаётся в ссылке оффера

В параметрах ссылки на оффер (paramTemplate) должен стоять исходящий макрос трекера {event.event_click_id} — именно это значение партнёрка обязана вернуть в постбэке в параметре clickId. Если макрос отсутствует или партнёрка возвращает собственный ID вместо переданного, Adset не сможет найти исходный клик и конверсия не привяжется.

Шаг 3. Посмотрите логи постбэков

Откройте меню действий (⋮) у пикселя → Логи. Каждая запись имеет статус: success (зелёный), error (красный), pending (жёлтый). Используйте фильтры по ClickId, статусу, триггеру (Deposit — accept, Registration — hold и т.д.) и периоду; в колонках «Данные запроса» и «Данные ответа» виден точный запрос и ответ внешнего сервера.

Отдельный случай — статус Ignored в логах пикселей: если в кампании «Доля конверсий для источника» меньше 100% (или доля выплат обнуляет revenue), часть постбэков в пиксель источника помечается Ignored и не отправляется. Это настройка, а не ошибка.

Подробнее: Просмотр логов постбэков

Шаг 4. Типовые ошибки

• Неверный макрос сети — в clickId приходит сырая строка вида {ref_id}: партнёрка не подставила значение. Проверьте, что в postback URL использованы макросы именно вашей CPA-сети.
• Обрезанный или изменённый click id — значение должно вернуться ровно в том виде, в каком Adset передал его в ссылке оффера.
• Неверное значение статуса — строка в постбэке (lead, sale, reg…) не совпадает со значениями шаблона статусов партнёрской программы. Настройте маппинг статусов в настройках сети в Adset и не смешивайте разные названия без настройки соответствий.
• Ошибки отправки в источник (видны в логах): Invalid ext_click_id — проверьте маппинг параметров источника трафика; Invalid OAuth access token — обновите Access Token в настройках пикселя; Timeout / Connection refused — проверьте URL постбэка и повторите отправку; Purchase event requires positive revenue and currency — партнёрка не передала revenue/currency, при необходимости задайте дефолтное значение в настройке оффера.

Шаг 5. Для пикселей — тестовые события (CAPI)

Facebook CAPI проверяется через Test Events: скопируйте Test Event Code в Facebook Events Manager (пиксель → Test Events → Test Server Events), в трекере откройте меню (⋮) пикселя → Тест, вставьте код, выберите события и нажмите Run Test. По каждому событию отобразится результат OK/Failed, а в Events Manager события появятся с меткой «Server».

Подробнее: Проверка CAPI (server-to-server) — отправка Test Events

Шаг 6. Когда писать в поддержку

Если шаги 1–5 пройдены, а постбэки так и не приходят, обратитесь в поддержку и приложите:

• название партнёрской сети, оффера и кампании;
• postback URL, настроенный у партнёрки, и пример реального вызова;
• clickId проблемной конверсии и время события;
• скриншоты логов (статус, данные запроса и ответа).

Как связаны статусы

В CPA-шаблонах статусы партнёрки маппятся на внутренние события трекера: например, lead → hold, sale → accept. Регистрации и депозиты отображаются в статистике как события CPA_HOLD и CPA_ACCEPT.