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

Якщо конверсії не з'являються в 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.