Гайд - Постбеки

Постбеки: кожна конверсія — у ваш трекер

Якщо ллєте трафік через Keitaro, RedTrack чи працюєте з партнеркою, клік випадає з поля зору трекера в момент входу в Telegram. Реєстрації й депозити відбуваються там, де трекер сліпий, а без даних про конверсії тихо помирають ваші звіти про витрати, авто-правила та звірка виплат. Постбеки замикають цей контур: на кожну конверсію, яку фіксує Leadgram, платформа звертається до S2S-URL вашого трекера, і фінансова частина воронки лишається видимою саме там, де ви оптимізуєте.

Як це працює

Правило постбеку - це три речі: подія-тригер, шаблон URL і HTTP-метод. Щойно по одному з ваших кліків фіксується конверсія - через server-to-server виклик рекламодавця в events API або через вузол «Тригер події» у флоу - спрацьовують усі ввімкнені правила з цим типом події. Одна подія, одне правило, один HTTP-запит.

Постбеки спрацьовують лише для подій, які пройшли білінг. Конверсія отримує статус charged або free ще до того, як до неї дістаються ваші правила: платно проходить лише перша білінг-подія підписника, усі наступні події від нього безкоштовні. Якщо в момент цього першого списання організація на паузі або без балансу, подія натомість падає в статус blocked, і постбек по ній не спрацьовує; події від підписників, за яких ви вже платили, лишаються безкоштовними й продовжують спрацьовувати. Окремого статусу для цього на самому правилі немає, тож якщо правило, яке мало б стріляти, раптом замовкло - спершу перевірте баланс організації, а вже потім розбирайтеся з URL.

Створення правила

  1. Відкрийте «Постбеки» і натисніть «Додати постбек».
  2. Виберіть пресет: Keitaro і RedTrack підставлять шаблон URL, «Власний» починається з порожнього поля.
  3. Назвіть правило так, щоб потім упізнати його в таблиці.
  4. Виберіть подію-тригер: «Лід», «Реєстрація», «Депозит», FTD, «Покупка», «Старт бота» або «Вступ до каналу».
  5. Вставте URL ендпоінта з макросами (список нижче).
  6. Виберіть GET або POST. За POST макроси в URL теж працюють, а ті самі поля додатково йдуть JSON-тілом.
  7. Натисніть «Додати постбек», щоб зберегти. Правило вмикається одразу і з'являється в таблиці з подією, методом, часом останнього спрацьовування та статусом.
Форма правила постбеку з подією-тригером і шаблоном URLФорма правила постбеку з подією-тригером і шаблоном URL

Макроси URL

Ці плейсхолдери підставляються при кожному спрацьовуванні:

  • {click_id} - id кліка в Leadgram; ключ, за яким трекер зіставляє сесію
  • {event_type} - назва події (deposit, ftd і так далі)
  • {sub1}-{sub5} - суб-ланцюжок, зафіксований на кліку
  • {platform} - рекламний майданчик кампанії (meta, google, tiktok)
  • {fbclid}, {gclid}, {gbraid}, {wbraid}, {ttclid} - нативні click id рекламних майданчиків

Порожні значення перетворюються на порожній рядок, тож &fbclid={fbclid} не зламається на трафіку з Google. Усе, чого немає в цьому списку, залишається в URL як звичайний текст. Робочий приклад для Keitaro: https://your-keitaro.com/postback?subid={click_id}&status={event_type}.

Доставка, ретраї та повторне відправлення

На кожен запит дається 10 секунд, і будь-який HTTP-статус від 200 до 399 зараховується як доставлений. Невдалий запит отримує ще до 2 повторів зі зростаючою паузою (всього 3 спроби), і кожне відправлення дзеркалиться в надійний журнал, який можна переглянути на сторінці «Доставка конверсій»:

  • «У черзі» - поставлено в чергу, ще не доставлено
  • «Відправлено» - ендпоінт відповів 200-399
  • «Збій» - остання спроба впала, ретраї ще можливі
  • «Мертва» - усі спроби вичерпано; оживить лише ручне повторне відправлення

Сторінка «Доставка конверсій» показує зведення про стан ще до того, як ви дістанетесь до будь-якої таблиці: одна картка на кожне правило й на кожне підключення до рекламного майданчика, зі статус-беджем («Без проблем», «Є збої» або «Є мертві») плюс лічильники sent/failed/dead/pending за останні 24 години та за останні 7 днів. Це найшвидший спосіб помітити, що з правилом щось не так, не перечитуючи кожен рядок окремо.

Нижче розташована таблиця «Проблемні доставки» (вкладки CAPI | Постбеки): вона показує кожну збійну чи мертву доставку з точним текстом помилки, по 20 рядків на сторінку. Часовим вікном вона не обмежена - це стосується лише лічильників у зведенні вище; доставка, яка впала кілька місяців тому, так само висітиме тут, доки ви не перевідправите її або вона сама не пройде успішно. «Повторно надіслати» ставить доставку в чергу ще раз з тим самим payload. Спершу полагодьте ендпоінт, а тоді перевідправляйте - нічого не втрачається.

Гарантія дедуплікації: одна й та сама логічна конверсія ніколи не піде у ваш ендпоінт двічі. Дедуплікація тримається крізь ретраї черги, краші й повторну обробку подій. Справжня нова повторна конверсія (наприклад, другий депозит, зафіксований як нова подія) відпрацює знову, як і має.

Часті граблі

  • Правило показує статус «Вимкнено» і не стріляє. Нові правила завжди створюються ввімкненими, а сьогодні дашборд дозволяє тільки створювати правила: редагувати, вимикати чи видаляти вже збережене правило з інтерфейсу не можна, тож якщо ви бачите вимкнене правило - його вимкнули якимось іншим способом. Перевірте поточний стан через фільтри «Усі / Активні / Вимкнені».
  • Назви макросів точні: {clickid} (без нижнього підкреслення) не підставляється і приїде до трекера буквально.
  • Тільки публічні http(s)-адреси: localhost і адреси приватних мереж відхиляються з міркувань безпеки. Ця перевірка спрацьовує, коли ви редагуєте URL і коли правило стріляє, але не в момент першого створення - тож поганий URL цілком може зберегтися і впасти лише тоді, коли справді спробує спрацювати.
  • Якщо ваш ендпоінт відповідає 4xx/5xx, доставка стає «Збій», а потім «Мертва». Це проблема приймальної сторони: полагодьте її, а тоді перевідправте зі сторінки «Доставка конверсій».
  • Ліміт - 50 правил постбеків на організацію.