Основы

Умные ссылки и перенаправления

Ваша умная ссылка, mapps.one/habitly, определяет устройство каждого посетителя и за несколько миллисекунд решает, куда его отправить. На этой странице объясняется, какие правила действуют по умолчанию, как их изменить, что видят боты предпросмотра ссылок и как метки кампаний передаются дальше в магазины.

Маршрутизация по умолчанию

Посетитель	Куда попадает	Если этой ссылки нет
iPhone, iPad, iPod	App Store	Лендинг
Android	Google Play	Лендинг
Устройства Huawei и Honor, HarmonyOS	AppGallery	Google Play, затем лендинг
Windows	Microsoft Store	Лендинг
macOS	App Store	Лендинг
Нераспознанные устройства («Другое»)	Лендинг	—
Linux и ChromeOS	Лендинг	—

Устройство определяется по user agent браузера. Планшеты подчиняются тем же правилам, что и телефоны на той же системе. iPad, запрашивающие версии сайтов для компьютера, представляются как Mac и всё равно попадают в App Store, потому что для macOS это назначение по умолчанию.

Правила переадресации

Откройте вкладку Ссылки приложения, чтобы выбрать назначение для каждой из этих платформ: iOS, Android, Huawei, Windows, macOS и «Другое». Доступные варианты:

App Store, Google Play, AppGallery или Microsoft Store: перенаправление на карточку в этом магазине,
Web-адрес: перенаправление на веб-адрес, сохранённый в приложении, например на веб-версию или лист ожидания,
Лендинг: показ лендинга по адресу умной ссылки.

Если для выбранного назначения не сохранена ссылка, посетитель переходит на запасной вариант: посетители с Huawei пробуют Google Play, а затем лендинг, все остальные видят лендинг. Предпросмотр правил в панели управления показывает, куда сейчас попадает каждая платформа, и отмечает строки, в которых используется запасной вариант.

Пример: у Habitly нет приложения для Mac. Выберите для macOS Лендинг, чтобы посетители с Mac видели скриншоты и оба значка магазинов, а не карточку приложения для iPhone в Mac App Store.

Перенаправления используют HTTP 302 с Cache-Control: no-store, поэтому браузеры и прокси их не кешируют, а изменения правил применяются уже к следующему посещению.

Предпросмотр ссылок и боты

Когда кто-то вставляет вашу ссылку в чат или публикацию, приложение загружает страницу, чтобы создать предпросмотр. Такие краулеры всегда получают лендинг, а не перенаправление, поэтому в предпросмотре отображаются название приложения, заголовок и изображение из тегов Open Graph страницы. Это касается Facebook, Instagram, WhatsApp, X, LinkedIn, Slack, Discord, Telegram, iMessage, Pinterest, Reddit, Mastodon, Bluesky, Snapchat, Skype, Zoom, Microsoft Teams и других.

Поисковые роботы, SEO-инструменты, сервисы мониторинга доступности, ИИ-краулеры и клиенты командной строки, такие как curl, wget или python-requests, тоже считаются ботами. Боты получают лендинг и никогда не учитываются в аналитике.

Встроенные браузеры

Ссылки, открытые внутри Instagram, Facebook, TikTok, X, LinkedIn, Snapchat, Pinterest, LINE, Telegram, WeChat, Reddit и Threads, распознаются. Посетитель направляется по устройству, как при любом другом посещении. В аналитике приложение, из которого он пришёл, записывается как источник трафика, хотя такие браузеры обычно не передают реферер.

Метки кампаний

Добавьте к умной ссылке стандартные UTM-метки, чтобы сравнивать каналы:

https://mapps.one/habitly?utm_source=instagram&utm_medium=social&utm_campaign=launch

mapps.one всегда записывает utm_source, utm_medium и utm_campaign в вашу аналитику. Если включена опция Передавайте параметры кампании в магазины (она включена по умолчанию), метки также передаются в место назначения в понятном ему формате:

Назначение	Что мы добавляем
Google Play	Параметр `referrer` с UTM-метками в URL-кодировке, которые ваше приложение может прочитать через Play Install Referrer API. `https://play.google.com/store/apps/details?id=com.habitly.app&referrer=utm_source%3Dinstagram%26utm_medium%3Dsocial%26utm_campaign%3Dlaunch`
App Store	Токен кампании `ct`: значение `utm_campaign` или `utm_source`, если кампании нет, длиной до 40 символов. `https://apps.apple.com/app/id1612345678?ct=launch`
Web-адрес	Сами UTM-метки. `https://habitly.app/?utm_source=instagram&utm_medium=social&utm_campaign=launch`
AppGallery, Microsoft Store	Ничего. Карточка открывается без дополнительных параметров.

Передаются все пять меток: utm_source, utm_medium, utm_campaign, utm_term и utm_content. Каждое значение обрезается до 100 символов.

О кампаниях App Store: App Store Connect относит токен ct к кампании, только если ссылка также содержит ваш токен провайдера (pt). Ссылки на магазины сохраняются в канонической форме, поэтому pt, вставленный в ссылку на App Store, не сохраняется. Для сравнения каналов используйте разбивку по кампаниям в аналитике mapps.one.

Ссылки значков магазинов

Значки магазинов на лендинге ведут на отслеживаемое перенаправление mapps.one/habitly/go/{store}. Клик учитывается как клик по магазину, после чего посетитель отправляется на карточку. Если у приложения нет ссылки на этот магазин, посетитель возвращается на лендинг.

Эти URL можно использовать и самостоятельно, если нужен конкретный магазин независимо от устройства, например в кампании только для Android. UTM-метки, добавленные к URL /go/, передаются так же, как и в умной ссылке.

Ключ магазина	URL
`app_store`	`mapps.one/habitly/go/app_store`
`google_play`	`mapps.one/habitly/go/google_play`
`app_gallery`	`mapps.one/habitly/go/app_gallery`
`microsoft_store`	`mapps.one/habitly/go/microsoft_store`
`web`	`mapps.one/habitly/go/web`

Справочник URL

URL	Для чего
`/habitly`	Умная ссылка: перенаправление по устройству или лендинг
`/habitly/page`	Лендинг на любом устройстве
`/habitly/go/{store}`	Отслеживаемое перенаправление в один магазин
`/habitly/open/{path}`	Диплинк в установленное приложение
`/habitly/privacy`, `/habitly/privacy/{language}`	Политика конфиденциальности
`/habitly/terms`, `/habitly/terms/{language}`	Условия использования
`/habitly/press`, `/habitly/press.zip`	Пресс-кит: страница и скачивание
`/habitly/qr.svg`, `/habitly/qr.png`	QR-код для умной ссылки

Если ссылка не работает

404 Not Found: ни одно приложение не использует этот слаг. Проверьте написание и то, не был ли слаг изменён.
410 Gone, «приостановлено»: приложение приостановлено в панели управления. Включите его снова.
410 Gone, «больше недоступно»: приложение заблокировано командой по доверию и безопасности. Обратитесь в поддержку.
Всегда открывается лендинг: для назначения этой платформы не сохранена ссылка, в правиле выбран «Лендинг» или вы проверяете ссылку с клиента, похожего на бота.