ZM APPS + Unity Ads: запуск от А до Я
ApptureПошаговый гайд по запуску Unity Ads на прилах ZM apps. Совместный материал ZM apps и Appture (агентские кабинеты Unity Ads).
Атрибуция (AppsFlyer) уже настроена на стороне ZM apps. Достаточно трекера с саб-параметрами и постбэками (Keitaro, Binom или аналоги).
Содержание
- Как устроена связка
- Что понадобится
- Шаг 1 — Кампания и треклинка в Keitaro
- Шаг 2 — Нейминг в ZM apps
- Шаг 3 — Прила в Unity Dashboard
- Шаг 4 — Данные в саппорт ZM apps
- Шаг 5 — Кампания в Unity
- Шаг 6 — События и деньги: постбэки в ZM apps
- Шаг 7 — Трекинг креативов и паблишеров в Keitaro
- Шаг 8 — ROAS и Event-кампании
- Чек-лист перед запуском
- Контакты
Как устроена связка
Два потока данных, оба нужны:
Клики и показы (вниз):
Unity Ads → Click/Impression URL (ZM apps) → нейминг → → ваша треклинка → Keitaro → прила
События и деньги (вверх):
Партнёрка → постбэк с выплатой в Keitaro → → постбэк из Keitaro в ZM apps (exid + событие + сумма) → → ZM apps обрабатывает и передаёт в AppsFlyer → → AppsFlyer отдаёт в Unity
Когда верхний поток работает, Unity видит не только инсталлы, но и деньги — это открывает ROAS и Event-кампании. Когда нижний настроен полностью, в Keitaro приходит разбивка по крео и паблишерам.
Что понадобится
- Кабинет Unity Ads с агентским доступом — Appture
- Подписка ZM apps + прила под Unity (iOS или Android) — доступ выдаёт менеджер ZM apps
- Keitaro или аналог (саб-параметры + постбэки)
- Офферная ссылка партнёрки с настроенной выплатой
Шаг 1 — Кампания и треклинка в Keitaro
- Создайте кампанию в Keitaro под связку.
- В трекерной ссылке примите клик-ID ZM apps (
exid) и оставьте свободные слоты под аналитику:
https://ваш-домен.com/{subX}?sub1={exid}&sub3={sub3}&sub4={sub4}{exid}— клик-ID ZM apps, ключ матчинга конверсий. Потеряете — статистика развалится{subX}— динамическая метка кампанииsub3/sub4— слоты под крео и паблишера (Шаг 7)
3. В постбэке от партнёрки настройте приём суммы выплаты (payout) — она понадобится для ROAS (Шаг 6). Даже если пока льёте на CPI — настройте сразу.
⚠️ Один параметр не должен встречаться в ссылке дважды.
Шаг 2 — Нейминг в ZM apps
- Личный кабинет ZM apps → Naming → добавьте треклинку из Шага 1 → «Сформировать нейминг»
- Получите диплинк с теми же параметрами, для in-app источников схема
inapp://
Пример:
inapp://ВАШ_НЕЙМИНГ/subX={campaignid}/sub3={sub3}/sub4={sub4}⚠️ Ссылку в нейминг можно добавить один раз (менять потом — через личный кабинет). Имена sub-параметров в нейминге и треклинке должны совпадать.
Шаг 3 — Прила в Unity Dashboard
- Unity Dashboard → Unity Ads User Acquisition → Add a new app
- Ссылка на прилу из стора — ПОЛНАЯ, с «хвостом» параметров (иначе не распознается):
https://apps.apple.com/app/id1234567890?platform=iphone&ppid=abcd1234
3. Из карточки приложения скопируйте Unity Ads Game ID
⚠️ Если прила уже запускалась в Unity раньше — не добавляйте её заново (задвоение Game ID ломает атрибуцию), сверьте Game ID с менеджером ZM apps/Appture.
Шаг 4 — Данные в саппорт ZM apps
Отправьте: нейминг, название прилы или bundle, «Unity Ads», Game ID.
В ответ — две ссылки: Click URL и Impression URL.
⚠️ В полученных Click / Impression URL проверьте параметрredirect— должно бытьredirect=true. Если стоитfalse— поправьте или попросите менеджера перегенерировать: сfalseклики идут, но пользователь не доходит до стора.
Шаг 5 — Кампания в Unity
- Create Campaign → в поле
Campaign titleвставьте нейминг — и ничего кроме него - Вставьте Click URL и Start/Impression URL от ZM apps
- Параметры под задачу → Go live
Шаг 6 — События и деньги: постбэки в ZM apps
Главный шаг для ROAS. Из Keitaro отправляйте в ZM apps оба события, депозит — с суммой выплаты:
Регистрация:
https://tools.zm.app/pb/?exid={sub1}&action=regДепозит с суммой:
https://tools.zm.app/pb/?exid={sub1}&action=dep&payout={payout}¤cy=USDexid={sub1}— тот самый клик-ID из Шага 1payout— сумма выплаты (в{payout}подставьте макрос выплаты Keitaro — сумма из постбэка партнёрки),currency— валюта, опционально
Где настраивается в Keitaro: настройки кампании → Postbacks (либо постбэк на уровне оффера, если события приходят туда). Статусы событий мапьте так: регистрация → action=reg, депозит → action=dep.
Дальше цепочка отрабатывает сама: ZM apps передаёт событие и сумму в AppsFlyer, AppsFlyer — в Unity. Вы настроили один постбэк — Unity получил деньги.
Перед боевым запуском прогоните тестовую конверсию вместе с менеджером ZM apps — убедитесь, что событие видно на их стороне и доехало до AppsFlyer.
Шаг 7 — Трекинг креативов и паблишеров в Keitaro
Настраиваем трекинг плейсментов и креативов: Unity отдаёт в клик ID крео-пака и ID приложения-паблишера — заводим их в свободные саб-слоты треклинки, чтобы видеть разбивку в отчётах Keitaro:
1. В свободные сабы нейминга пропишите имена AppsFlyer-параметров обычным текстом, без фигурных скобок: sub3=af_ad (крео), sub4=af_siteid (паблишер). Инструмент ZM apps сам развернёт их в значения — так работает передача ивентов с AppsFlyer.
Пример:
inapp://ВАШ_НЕЙМИНГ/sub1=zm/sub2=ВАШ_ID/sub3=af_ad/sub4=af_siteid
2. В Keitaro строите отчёты по sub3/sub4: какое крео тащит, какие паблишеры сливают
3. Слабых паблишеров — в блеклист кампании Unity (доступно в агентском кабинете), слабые крео — на замену
Без этого шага льёте вслепую. С ним — оптимизация на уровне паблишера, а не кампании.
Шаг 8 — ROAS и Event-кампании
Когда постбэки из Шага 6 заработали и в Unity накопились события с деньгами — вам доступны все типы кампаний:
- CPI — оплата за установку. События не нужны. Старт для новой прилы: тест гео и креативов, набор первичной статистики.
- ROAS — оптимизация на возврат инвестиций. Алгоритм ищет платящих, требует событий с суммами. Можно запускать и сразу, но лучше стартовать с CPI и переводить кампанию на ROAS-цель, когда накопились данные.
- CPE Payer — оплата за целевое событие. Оптимизация под первый депозит в течение 7 дней после установки, работает без сумм. Запускается параллельно с ROAS и добирает плательщиков, которых ROAS игнорирует. Создаётся напрямую в дашборде Unity.
Правила: суммы слать с первого дня (даже на CPI — данные копятся); после переключения на ROAS — 7 дней не трогать кампанию, алгоритм обучается.
Чек-лист перед запуском
- Прила добавлена в Unity по полной стор-ссылке, Game ID вписан в интеграцию; в Click/Impression URL проверен
redirect=true - В
Campaign title— только нейминг - Клик-ID (
exid) из треклинки уходит в постбэки — цепочка не рвётся - Настроена передача событий и revenue: постбэки
reg/depс суммой выплаты - Тестовая конверсия прогнана с менеджером ZM apps: событие дошло до ZM apps и доехало до AppsFlyer
- После первых кликов
sub3/sub4наполняются данными крео (af_ad) и паблишера (af_siteid)