S2S Postback для Unity Ads: настройка Keitaro и AppsFlyer 2026

S2S Postback для Unity Ads — это серверный протокол передачи данных (Server-to-Server), связывающий рекламный клик Unity с конверсиями в трекере Keitaro или мобильном MMP (AppsFlyer/Adjust) и возвращающий событие первого депозита (FTD) для автоматической калибровки алгоритма ставок Target ROAS.

Без корректной интеграции нормально запустить и вести кампанию в Unity Ads не получится. Если данные между рекламной сетью, трекером и приложением передаются с ошибками, часть регистраций и депозитов теряется. По полученной статистике становится невозможно понять, какие клики действительно приводят целевых пользователей. Из-за этого алгоритм принимает неверные решения о показе, а вы сливаете бюджет в попытках найти рабочий подход.

Но есть и хорошая новость — всех этих неприятностей легко можно избежать, если правильно настроить интеграцию с MMP или трекером. В статье разберем немного теории, а затем пошагово расскажем, как подключить к Unity Ads AppsFlyer или Keitaro при заливе PWA-приложения, а также ответим на самые распространенные вопросы.

Введение в атрибуцию Unity Ads

Атрибуция позволяет связать рекламный клик с установкой и дальнейшими действиями пользователя. Благодаря ей Unity Ads получает данные о том, какие объявления приводят регистрации и депозиты, а какие просто расходуют бюджет. Даже если у вас будет проверенный агентский аккаунт с кредитной линией, но неправильно настроенная интеграция, вывести залив в плюс не получится. Без корректно настроенной интеграции с MMP или трекером Unity Ads не сможет увидеть, насколько эффективно работают ваши кампании, а алгоритм не выйдет на целевую аудиторию.

При настройке важно не путать трекер и MMP, они отвечают за разные задачи, поэтому коротко пробежимся по всем участникам этой цепочки:

• Unity Ads — источник трафика. Площадка показывает рекламу, создает для перехода уникальный {click_id} и использует полученные через постбэк данные для управления ставками в рекламном аукционе.
• Keitaro — трекер и система распределения трафика. Он принимает клик, собирает данные из субаккаунтов, фильтрует ботов, направляет пользователя на нужный оффер и через S2S передает события обратно в источник.
• MMP-система для мобильной атрибуции по типу AppsFlyer нужна при работе с приложениями из Google Play и App Store. С ее помощью определяют, с какого рекламного клика пришла установка на устройство.
• PWA прила или приложение в App Store/Google Play — конечная точка маршрута пользователя, где происходят регистрация и депозит.

При передаче данных об установках в Unity убедитесь, что вы собираете данные по всей вашей пользовательской базе, включая авторизованные, неавторизованные и органические установки.

Матрица сквозного маппинга

При выборе источника трафика параметры S2S Postback в Keitaro должны подтянуться автоматически. Если этого не произошло или для вашей схемы нужны дополнительные постбэки, их можно добавить вручную. О пошаговой настройке S2S postback Unity Ads Keitaro расскажем чуть позже, а пока ловите параметры, которые можно передавать из источника в трекер и обратно.

Чем полнее информация о действиях пользователей возвращается в рекламную сеть, тем больше данных получают алгоритмы, что может существенно повысить эффективность рекламных кампаний. Рекомендуем сопоставить события с помощью специальной таблицы соответствия макросов Unity Ads параметрам трекера, которую мы составили самостоятельно.

Готовый шаблон Unity Ads postback URL может выглядеть следующим образом:

Грамотно заполнив все поля, вы сможете корректно настроить передачу необходимых параметров из источника в трекер и, при необходимости, обратно в рекламную сеть. Давайте же перейдем непосредственно к инструкции.

Пошаговый алгоритм настройки S2S интеграции в Keitaro

Шаг 1. Создаем источник трафика

S2S postback используется для отправки информации во внешний сервис, например, информации о конверсиях. В Keitaro должен быть готовый шаблон для Unity Ads. Источник также можно создать вручную и прописать макросы из таблицы выше.

Шаг 2. Передаем Sub ID в партнерскую сеть

В ссылку партнерской программы нужно пробросить sub1. По этому параметру партнерка сможет связать полученную конверсию Sub ID из Unity Ads с нужным переходом и вернуть ее обратно в трекер.

Шаг 3. Проверяем входящий и исходящий постбэки

Сначала убедитесь, что партнерская сеть возвращает реальный Sub ID и конверсия появляется в Keitaro. После этого проверьте исходящий S2S Postback в разделе логов Keitaro, там видно, какое событие было отправлено, на какой адрес ушел запрос и какой ответ вернул источник.

Отдельно проверьте {external_id}. Вместо этого макроса в исходящем S2S Postback должен подставляться реальный ID клика, полученный от источника трафика. Если значение остается пустым, вернитесь к настройке источника и проверьте, передается ли соответствующий параметр в ссылке при переходе пользователя из Unity Ads.

https://postback.unityads.unity3d.com/games/{game_id}/install?clickid={sub1}

https://postback.unityads.unity3d.com/games/{game_id}/event?clickid={sub1}&event_name=deposit&event_value={sub_id_revenue}&currency=USD

Рекомендуем узнать еще больше полезной информации касаемо настройки Keitaro для фильтрации трафика из нашей статьи. Актуально не только для Unity Ads, но и для любых других источников трафика.

Пошаговый алгоритм интеграции с AppsFlyer

Для подключения Unity Ads к AppsFlyer понадобится уникальный game_id. Его можно найти после добавления игры в разделе «Apps» → «Campaigns», как показано на скриншоте ниже.

Unity Ads связывает одно приложение с одним game_id в рамках учетной записи, поэтому перед настройкой стоит проверить идентификатор, именно он будет использоваться AppsFlyer при атрибуции установок.

Интеграция Unity с AppsFlyer происходит буквально в пару кликов:

1. В AppsFlyer откройте раздел «Сотрудничество» → «Партнерские интеграции» и перейдите на вкладку «Маркетплейс».
2. Найдите Unity Ads среди партнеров и откройте «Интеграцию».
3. Включите переключатель «Активировать партнера».

После подключения нужно настроить передачу событий из AppsFlyer обратно в Unity Ads:

1. Укажите game_id и еще раз проверьте, что он совпадает с идентификатором приложения, который используется для атрибуции установок.
2. Включите отправку событий внутри приложения.
3. При необходимости задайте окно обратной передачи для этих событий.
4. Нажмите «Добавить событие» и выберите нужное событие SDK либо событие, которое передается между серверами.

Сопоставьте события AppsFlyer с соответствующими событиями Unity Ads. Рекомендуемые названия со стороны AppsFlyer и обязательные названия Unity Ads показаны в таблице ниже.

Конечно, работать с PWA гораздо легче, во-первых, не придется заморачиваться с подключением MMP, во-вторых, гораздо ниже риски бана прилы и потерь из-за этого. Ищите готовые PWA приложения для арбитража на нашем сайте. Удобный онлайн-конструктор позволяет создать или импортировать прилу из Google Play за считанные минуты, подключить триггерные пуши и начать зарабатывать.

Как не потерять click_id при заливе на PWA-приложения?

При заливе на PWA в цепочке нет магазина приложений, поэтому для атрибуции не используется AppsFlyer. Пользователь просто открывает рекламу во встроенном браузере, где обычные cookies могут удаляться после закрытия вкладки или спустя 24 часа. Из-за этого часть отложенных конверсий легко потерять.

Например, пользователь установил PWA или зарегистрировался сегодня, а депозит внес через несколько дней. Если данные о первоначальном клике хранились только в сессионных cookies, к этому моменту они могут пропасть и депозит уже не получится связать с рекламным переходом.

Чтобы сохранить click_id при Unity Ads tracking PWA, используют следующую схему:

1. После клика по рекламе параметр {click_id} передается в URL прелендинга.
2. На прелендинге {click_id} сразу сохраняется в localStorage, которое не сбрасывается после обычного закрытия вкладки.
3. Когда пользователь позже вносит депозит, сохраненный {click_id} подтягивается из локального хранилища и передается в партнерскую программу.
4. Партнерка возвращает идентификатор в Keitaro, после чего трекер отправляет S2S Postback в Unity Ads.

Такая схема позволяет сохранить до 30-40% отложенных депозитов. При этом доступный объем localStorage и особенности его работы различаются в зависимости от браузера. Совместимость с разными браузерами показана на скриншоте ниже.

Тема работы с макросами и Sub ID в PWA подробнее раскрыта в нашем блоге, поэтому рекомендуем вернуться к прочтению этой полезной статьи.

5 наиболее распространенных причин потери постбэков

Потеря постбэков не всегда связана с ошибкой в самой интеграции. Даже если события передаются корректно, Unity может не получить часть конверсий или учесть их неправильно. Поэтому при расхождениях в статистике сначала проверьте следующие 5 моментов:

• Рассинхрон валют. Партнерка может передавать доход в EUR или рублях, тогда как Unity Ads по умолчанию ожидает USD. Если валюту не указать, данные о доходе будут пересчитываться некорректно. Чтобы этого избежать, в шаблоне постбэка нужно прописать currency=USD.
• Окно атрибуции. Допустим, депозит произошел спустя 5 дней после клика, а в Unity окно атрибуции установлено на 2 дня. Такой постбэк окажется за пределами заданного периода и будет отклонен сервером.

• Ошибки кодирования символов в URL. Незакодированные спецсимволы в передаваемых параметрах могут нарушить структуру GET-запроса. В результате постбэк не будет обработан корректно.
• Отсутствие дедупликации по Transaction ID. Если один и тот же депозит отправляется повторно, например после обновления игроком страницы подтверждения оплаты. Чтобы передача FTD в Unity Ads считывалась корректно, нужно прописать уникальный Transaction ID, чтобы система связывала дубли.
• Остановка кампании из-за деклайна карты. Если банк блокирует карту или отклоняет очередное списание, кампания останавливается. Пока платежный вопрос решается, окно атрибуции уже полученных кликов продолжает идти и часть конверсий можно потерять. Снизить риск таких остановок помогают виртуальные карты для оплаты рекламы и серверов трекинга. Лучше использовать проверенное решение от FBM Cards.

💡Совет эксперта FBM: При настройке исходящего вебхука из Keitaro в Unity Ads всегда добавляйте параметр currency=USD, даже если партнерка рассчитывает выплаты в EUR или рублях. Трекер автоматически сконвертирует доход по курсу на момент клика, что предотвратит критический сбой машинного обучения Target ROAS.

Это все, что вам нужно, чтобы запустить вашу первую кампанию в Unity Ads. Следующим логичным шагом является углубление в креативы, поскольку именно от них зависит львиная доля успеха кампании, так что ждите еще полезных статей в нашем блоге.

Когда S2S постбэк и трекинг событий отлажены, переходите к масштабированию связки — читайте наш гайд по масштабированию Unity Ads от $500 до $10 000, а также инструкцию по работе с агентскими аккаунтами Unity Ads для залива без лимитов и риск-пейментов.

Часто задаваемые вопросы (FAQ)