Налаштування postback Keitaro для Adgora

Що потрібно підготувати перед початком

Перш ніж намагатися налаштувати postback джерела трафіку Keitaro для Adgora, переконайтеся, що обидва акаунти активні й що ви можете редагувати джерело трафіку в Keitaro. Це звучить просто, але саме тут багато налаштувань і зависають: у користувача є доступ адміністратора в Adgora, але лише перегляд у Keitaro, тож поле postback лишається заблокованим. Вам потрібен точний акаунт Adgora, у який ви хочете передавати події, а також запис джерела трафіку в Keitaro, який фактично отримує кліки.

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

На практиці найзручніше відкрити обидва інструменти в окремих вкладках і поруч порівняти назву джерела, поле postback і поле ідентифікатора кліку. Одна дрібна помилка — і велика проблема. Джерело трафіку з назвою “Meta US” у Keitaro та “meta_us” в Adgora може й працювати, але лише якщо збігаються реальні параметри, а не напис, який ви використовуєте для зручності.

Якщо перед налаштуванням запиту вам потрібне коротке нагадування про терміни звітності, глосарій ad tech допоможе з базовими словами, які постійно трапляються в екранах трекінгу. Також варто переглянути інші гайди про крипто-рекламу, монетизацію та Ad-Tech, якщо ви будуєте повніший трекінг-стек, адже налаштування postback рідко існує окремо.

Знайдіть endpoint postback Adgora та потрібні параметри

Перший технічний крок — скопіювати endpoint postback Adgora з тієї частини акаунта, де налаштовано конверсії. Не вгадуйте URL. Не використовуйте postback з іншого акаунта. Одна зайва або відсутня літера в шляху endpoint може перетворити валідну конверсію на тиху помилку, а тихі помилки — найгірші, бо виглядають як “немає трафіку”, а не як “неправильне налаштування”.

Зазвичай Adgora очікує базовий endpoint і кілька параметрів, які ідентифікують подію. У схемі postback для джерела трафіку такі параметри часто включають click ID, ідентифікатор джерела та посилання на конверсію. Keitaro має передати все, що Adgora використовує, щоб прив’язати подію до правильного рядка джерела. Якщо рядок джерела неправильний, конверсія потрапляє не туди або не потрапляє зовсім.

Скопіюйте endpoint точно так, як його показано в Adgora, а потім запишіть, які макроси Adgora вказує для запиту. Деякі команди зберігають текстову нотатку з endpoint, HTTP-методом, назвами обов’язкових параметрів і будь-якими необов’язковими значеннями, наприклад payout або status. Така нотатка економить час пізніше, особливо коли для другого джерела трафіку потрібна та сама схема.

Якщо ваш акаунт Adgora використовується для крипто-кампаній, логіка налаштування та сама, незалежно від того, чи ви працюєте з workflow крипто-ad network для паблішерів, чи з чимось іншим. Postback усе одно потребує правильних ідентифікаторів. Нічого магічного не відбувається лише тому, що кампанія пов’язана з криптою.

Створіть URL postback у Keitaro

Відкрийте налаштування джерела трафіку в Keitaro та знайдіть поле postback або conversion callback для цього джерела. Вставляйте туди endpoint Adgora, а не в поле postback кампанії. Це важлива різниця. Postback на рівні джерела передає дані саме з конфігурації джерела трафіку, а це й потрібно Adgora для звітності на рівні source; відстеження на рівні кампанії — це інший шар, і якщо їх змішати, буде плутанина.

Тепер зіставте токени Keitaro з параметрами Adgora. Наприклад, якщо Adgora очікує click ID, Keitaro має передати токен, у якому міститься це значення кліку. Якщо Adgora очікує назву або ID джерела, Keitaro має надіслати токен, прив’язаний до запису джерела трафіку, а не назву кампанії. Під час зіставлення дотримуйтеся буквального значення. Без зайвих хитрощів. Саме так будується postback Keitaro Adgora в реальному робочому сценарії.

Одна уважна звичка економить години: спочатку запишіть готовий URL у звичайному текстовому редакторі, а вже потім збережіть його в Keitaro. Після цього звірте кожен параметр по черзі. Відсутній амперсанд, випадково вставлений пробіл або токен у неправильних дужках можуть зламати запит. Особливо прикро, коли URL на перший погляд виглядає цілком нормально.

Деякі команди спершу тестують це на менш критичному джерелі, наприклад на невеликій тестовій кампанії, а вже потім переходять до більших закупівель. Це розумно. Якщо ви також працюєте з нішевими вертикалями, наприклад з кампаніями для встановлення мобільних застосунків або пропозиціями forex і трейдингу, та сама логіка postback усе одно застосовується, навіть якщо сторінка оффера виглядає зовсім інакше.

Правильно зіставте click ID та ідентифікатори джерела

Ось та частина, де інтеграції зазвичай ламаються. Keitaro може отримувати багато ID, але Adgora розпізнає подію лише тоді, коли точний click або source identifier повертається в тому форматі, якого він очікує. Якщо ID відсутній, обрізаний або надісланий під неправильною назвою параметра, Adgora не зможе зв’язати конверсію з початковим кліком.

Від самого початку використовуйте одну схему назв. Якщо ваше джерело — “fb_us_01” у Keitaro, зберігайте ту саму логіку в нотатках Adgora, у трекінговій таблиці та в будь-якій внутрішній документації. Невідповідна назва не завжди ламає сам запит, але вона ламає людське розслідування проблем. Три різні позначення одного джерела можуть забрати пів дня.

Коли в списку параметрів Adgora є поле click ID, зіставте його з токеном Keitaro, який зберігає ідентифікатор кліку з запису source click. Коли там є ідентифікатор джерела трафіку, передавайте токен джерела, а не токен кампанії. Ідентифікатор джерела та ідентифікатор кліку — це не одне й те саме, і їхнє змішування може зробити так, що конверсія виглядатиме валідною, але буде прив’язана не до того джерела.

Для команд, які порівнюють CPA-воронки, така дисципліна важлива і для інших моделей ціноутворення. Якщо ви ще розбираєтеся з логікою звітів, стаття про CPC проти CPM і CPA стане корисним доповненням, адже postback лише показує, що сталося, але не пояснює, чому ви обрали саме цю модель.

Надішліть тестову конверсію та підтвердьте запит

Після збереження URL запустіть одну тестову конверсію. Одну. Не п’ять. Спричиніть подію контрольовано, а потім перевірте обидві системи. У Keitaro відкрийте лог джерела або кампанії та подивіться вихідний запит, HTTP-код і фінальний URL, який було надіслано. В Adgora знайдіть відповідний запис події та мітку часу. Ці дві мітки часу мають бути близькими, навіть якщо не збігаються до секунди.

Якщо Keitaro показує відповідь 200, а Adgora нічого не відображає, запит дійшов кудись, але не до потрібного обробника подій. Якщо Keitaro показує код 4xx, ймовірно, неправильні endpoint, метод або назви параметрів. Якщо запит взагалі не з’являється в логах, найімовірніше, у Keitaro неправильно вставлено токен або postback джерела так і не зберігся.

Використовуйте один тестовий клік із унікальною приміткою в журналі. Наприклад, “ручний тест у вівторок, 14:20”. Так у вас буде один чистий рядок для подальшого пошуку. Безладний тест із кількома кліками та без нотаток виглядає активним, але його важко налагоджувати.

Фраза як налаштувати postback джерела трафіку Keitaro для Adgora стає зрозумілою лише тоді, коли ви можете зіставити один клік джерела, один вихідний запит і одну подію всередині Adgora. Якщо все це збігається — налаштування працює. Якщо чогось бракує, не переходьте далі.

Виправте найпоширеніші помилки source-postback

Неправильне розміщення макросів — найчастіша помилка. Токен, призначений для даних кампанії, вставляють у поле джерела, або токен click ID ставлять туди, де має бути source ID. Запит усе одно відправляється, тому помилку легко не помітити. URL є, конверсії немає.

Наступний рівень проблем створює URL-кодування. Якщо параметр містить спеціальні символи, а значення закодовано не так, як очікує Adgora, запит може прийти з пошкодженими частинами. Найчастіше це видно в назвах джерел, користувацьких нотатках або значеннях редиректу. Плюс може стати пробілом. Слеш може розбити поле. Дрібні символи, велика морока.

Неправильні налаштування методу теж спричиняють збої. Якщо Adgora очікує GET, а Keitaro надсилає POST, або навпаки, endpoint може відхилити запит або просто його проігнорувати. Перевірте метод в обох інструментах ще до того, як змінювати щось інше. Якщо змінити одразу три поля, неможливо зрозуміти, яке саме виправило проблему.

Дубльовані параметри створюють ще одну тиху проблему. Два значення в одному полі можуть призвести до того, що одна система прочитає перше, а інша — останнє. Для кожної мети залишайте один параметр. Якщо потрібно протестувати запасне значення, робіть окрему версію, а не вписуйте його в живий URL.

Іноді проблема взагалі не в URL. Джерело трафіку в Keitaro може бути названо одним способом, тоді як запис джерела в Adgora очікує інший акаунт або інший ID мережі. Через таку невідповідність кожен запит може здаватися “валідним”, але потрапляти не туди. Перевірте зв’язок акаунтів, перш ніж переробляти сам postback. Саме тут часто й проявляється як підключити Adgora до Keitaro без зайвих збоїв.

Запустіть у продакшн і стежте за першими реальними подіями

Після успішного тесту перейдіть із тестового трафіку на реальний, не змінюючи решту воронки. Це означає, що ви залишаєте оффер, лендер і логіку маршрутизації без змін, поки postback джерела продовжує відправлятися. Тут правило одне: змінюйте по одному елементу. Якщо ви одночасно зміните воронку і postback, ви не зрозумієте, що саме спричинило падіння звітності.

Уважно стежте за першими реальними подіями. Перші 10 конверсій — найінформативніші, бо вони показують, чи продовжує source postback спрацьовувати під звичайним трафіком, а не лише на один ручний клік. Порівнюйте записи подій в Adgora з логами джерела в Keitaro. Вам потрібна стабільність, а не просто один успішний рядок.

Слідкуйте за назвою джерела, значеннями параметрів і часом. Якщо один ad set дає конверсії, а інший — ні, проблема може бути саме в налаштуванні джерела, а не в самому postback. Чистий перехід у live означає, що той самий URL, ті самі токени й та сама схема ідентифікаторів продовжують працювати, навіть коли обсяг трафіку змінюється. Саме тому корисно ще раз перевірити налаштування postback у Keitaro після перших live-даних.

Якщо у вашому міксі кампаній є й інші вертикалі, звичка до звітності лишається тією самою. Чи ви надсилаєте конверсії для dating-офери, будуєте крипто-реклама або порівнюєте нове джерело зі старим трафіком — тримайте перші live-події під наглядом, доки логи й записи не збігатимуться. Потім і далі стежте за postback джерела, бо перша тиха помилка часто з’являється вже після першого чистого дня, а не під час нього.