Как подключить postback Keitaro к Adgora

Что нужно подготовить перед началом

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

Сначала проверьте три вещи. Во-первых, источник трафика Keitaro должен уже существовать. Во-вторых, вы должны понимать, какое оффер или кампания будут генерировать событие конверсии. В-третьих, у вас должны быть идентификаторы, которые Adgora ожидает в настройках аккаунта. Если чего-то не хватает, остановитесь и сначала восстановите доступ, а уже потом вставляйте URL.

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

Если перед настройкой вам нужен более общий обзор терминов отчётности, словарь ad tech поможет разобраться с базовыми словами, которые постоянно встречаются в интерфейсах трекинга. Также стоит посмотреть и остальные гайды по crypto advertising, monetization и 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 используется для криптокампаний, логика настройки остаётся той же — неважно, работаете ли вы по схеме crypto ad network for publishers или с чем-то другим. Postback всё равно нужны правильные идентификаторы. Никакой магии не происходит только потому, что кампания связана с криптой.

Соберите URL postback в Keitaro

Откройте настройки источника трафика в Keitaro и найдите поле postback или conversion callback именно для этого источника. Вставляйте туда endpoint Adgora, а не в поле campaign postback. Это различие важно. Postback на уровне источника отправляет данные из самой конфигурации источника трафика, а именно это и нужно Adgora для отчётности по источнику; трекинг на уровне кампании — это другой слой, и если смешать их, легко запутаться.

Теперь сопоставьте токены Keitaro с параметрами Adgora. Например, если Adgora ожидает click ID, Keitaro должен передавать токен, в котором хранится это значение клика. Если Adgora ожидает название или ID источника, Keitaro должен отправлять токен, привязанный к записи источника трафика, а не к названию кампании. Сопоставляйте буквально. Не усложняйте.

Есть одна полезная привычка, которая экономит часы: сначала соберите готовый URL в обычном текстовом редакторе, а уже потом сохраните его в Keitaro. После этого сравните каждый параметр по одному. Пропущенный амперсанд, лишний пробел при копировании или токен не в тех фигурных скобках могут сломать запрос. Особенно неприятно, когда на первый взгляд URL выглядит нормально.

Некоторые команды сначала тестируют это на менее важном источнике, например на маленькой тестовой кампании, прежде чем переходить к более крупным закупкам. Это разумно. Если вы также работаете с нишевыми вертикалями, например с кампаниями по установке мобильных приложений или офферами по forex и трейдингу, логика postback остаётся той же, даже если сама страница оффера выглядит совершенно иначе.

Правильно сопоставьте click ID и идентификаторы источника

Именно здесь интеграции чаще всего и ломаются. Keitaro может получать много разных ID, но Adgora распознаёт событие только тогда, когда нужный click ID или идентификатор источника возвращается в том формате, который он ожидает. Если ID отсутствует, обрезан или передан под неверным названием параметра, Adgora не сможет связать конверсию с исходным кликом.

С самого начала используйте одну схему названий. Если у вас источник называется “fb_us_01” в Keitaro, сохраняйте ту же логику в заметках Adgora, в таблице трекинга и во внутренней документации. Несовпадение названий не всегда ломает запрос, но почти всегда ломает человеческую диагностику. Три разных обозначения одного источника легко съедят полдня.

Когда в списке параметров Adgora есть поле click ID, привязывайте его к токену Keitaro, который хранит идентификатор клика из записи о переходе по источнику. Когда нужен идентификатор traffic source, передавайте токен источника, а не токен кампании. Идентификатор источника и идентификатор клика — это не одно и то же, и их путаница может сделать конверсию формально валидной, но привязанной не к тому источнику.

Для команд, сравнивающих 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-encoding. Если параметр содержит специальные символы и значение закодировано не так, как ожидает Adgora, запрос может прийти с повреждёнными частями. Чаще всего это видно в названиях источников, пользовательских заметках или значениях редиректа. Плюс может превратиться в пробел. Слэш может разорвать поле. Мелкие символы, большая головная боль.

Неправильный HTTP-метод тоже приводит к сбоям. Если Adgora ожидает GET, а Keitaro отправляет POST, или наоборот, endpoint может отклонить запрос или просто проигнорировать его. Проверьте метод в обоих инструментах, прежде чем менять что-то ещё. Если менять сразу три поля, невозможно понять, что именно помогло.

Дублирующиеся параметры создают ещё один тихий беспорядок. Два значения в одном поле могут привести к тому, что одна система прочитает первое, а другая — последнее. Оставляйте один параметр на одну задачу. Если нужно проверить запасное значение, сделайте отдельную версию, а не меняйте живой URL.

Иногда проблема вообще не в URL. Источник трафика в Keitaro может называться одним образом, а запись источника в Adgora может ожидать другой аккаунт или другой network ID. Из-за такого несоответствия каждый запрос выглядит «валидным», но попадает не туда. Сначала проверьте привязку аккаунтов, а уже потом переписывайте сам postback.

Запустите в работу и отслеживайте первые реальные события

После успешного теста переключайтесь с тестового трафика на реальный, не меняя остальную часть воронки. То есть вы оставляете оффер, лендинг и логику маршрутизации без изменений, а postback источника продолжает срабатывать. Здесь правило одно: меняйте по одному элементу. Если вы одновременно измените воронку и postback, вы не поймёте, из-за чего именно просела отчётность.

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

Следите за названием источника, значениями параметров и временем отправки. Если одно рекламное объявление даёт конверсии, а другое — нет, проблема может быть в настройке источника, а не в самом postback. Чистый запуск в бою означает, что один и тот же URL, те же токены и тот же шаблон идентификаторов продолжают работать при изменении объёма трафика.

Если в вашем наборе кампаний есть и другие вертикали, привычка к отчётности остаётся той же. Отправляете ли вы конверсии для dating-офферы, строите крипто-реклама или сравниваете новый источник со старым трафиком, держите первые реальные события под контролем, пока логи и записи не начнут совпадать. А потом всё равно продолжайте следить за postback источника, потому что первый тихий сбой часто проявляется уже после первого чистого дня, а не в момент запуска.

Если вам нужна краткая проверка перед финальным запуском, ориентируйтесь на связку параметров и задачу настройка postback keitaro adgora: один endpoint, один источник, один тестовый клик и одна подтверждённая конверсия. Для отладки полезно также держать под рукой схему keitaro adgora click id postback, чтобы быстро сверить, какой именно идентификатор клика уходит в запросе и как он принимается в Adgora.