Как работает и зачем нужен Android UTM Campaign Widget
Android UTM Campaign Widget — это модуль или логика в приложении/SDK, которая при первом запуске извлекает UTM-параметры (через Install Referrer API или аналог), сохраняет их и прикрепляет к событиям в аналитике для корректной атрибуции установки и последующих действий.
Что делает виджет и почему он важен
Веб‑UTM живут в URL; в Android путь сложнее: клик → магазин → установка → запуск. Виджет решает три задачи:
- Перехватывает referrer/utm при первом запуске.
- Сохраняет атрибуцию установки (source/medium/campaign и доп. поля).
- Подмешивает эти параметры к ключевым событиям (install, signup, purchase) для корректных отчётов и расчёта LTV/CPA.
Android UTM Campaign Widget не является официальным стандартом — это подход/паттерн, часто реализуемый в SDK аналитики (Firebase, AppsFlyer, Adjust и т.д.).
Как это работает на практике (пошагово)
- Сбор меток при клике: рекламная ссылка включает referrer/utm в URL Google Play или в промежуточном лендинге.
- Передача при установке: Google Play передаёт referrer приложению через Install Referrer API.
- Первый запуск и сохранение: виджет ждёт первого запуска, извлекает utm_*, сохраняет в локальное хранилище как атрибуцию установки.
- Отправка в аналитику: при событиях виджет добавляет сохранённые utm‑поля в параметры событий.
Практические рекомендации для разработчиков:
- Подключите и протестируйте Install Referrer API.
- Фиксируйте атрибуцию один раз (не перезаписывайте).
- Локально храните минимальный набор: utm_source, utm_medium, utm_campaign, utm_content, utm_term.
Тестируйте на отдельном окружении: сделайте тестовую ссылку с уникальным utm → установите приложение → проверьте, что аналитика получает параметры.
Как внедрить: конкретные шаги для команды
- Выберите инструмент: Firebase/GA4, AppsFlyer, Adjust, AppMetrica или собственный backend.
- Реализуйте приём referrer: Install Referrer API + обработчик первого запуска.
- Задайте правила нейминга UTM (единый документ для веба и мобайла).
- Пропишите UTM во всех рекламных ссылках (ads, партнёрки, лендинги, письма).
- Настройте отправку UTM с ключевыми событиями и постройте отчёты: клик → установка → регистрация → покупка.
Таблица: какие данные стоит собирать по UTM
| Параметр | Что хранить | Для чего нужен |
|---|---|---|
| utm_source | Площадка/канал (vk, google, tiktok) | Сравнение каналов, распределение бюджета |
| utm_medium | Тип трафика (cpc, cpm, email) | Анализ формата закупки |
| utm_campaign | Название кампании | Оценка эффективности кампании |
| utm_content | Креатив/вариант | A/B‑тесты креативов |
| utm_term | Ключ/аудитория | Анализ сегментов/ключей |
Частые ошибки
- Несогласованный нейминг между веб и мобайл: приводит к раздробленным отчётам.
- Неиспользование Install Referrer API → большинство платного трафика помечается как органика.
- Перезапись атрибуции при каждом запуске приложения.
- Отсутствие отправки UTM с ключевыми событиями (тогда видна только установка, но не 가치 действий).
Если не настроить корректную обработку UTM, платный трафик часто будет выглядеть как органический и вы потеряете данные для оптимизации кампаний.
FAQ
- Как долго хранить атрибуцию установки?
- Обычно фиксируют атрибуцию один раз и хранят её бессрочно для аналитики LTV; допускается логика «fallback» при старых данных.
- Нужно ли дублить UTM в in‑app промо?
- Да — разделяйте источник установки и in‑app campaign (install_source_* vs inapp_source_*).
- Что использовать: SDK аналитики или своё решение?
- Попробуйте SDK для быстрого старта; собственное решение даёт гибкость, но требует поддержки referrer и согласованной схемы передачи событий.
Используйте Android UTM Campaign Widget как фундамент: корректная атрибуция установки — база для расчёта CPA, LTV и принятия решений по бюджету.