Appy

Smart-ссылки и web-to-app

Что такое User-Agent?

Коротко

User-Agent — текст, который браузер отправляет в заголовке User-Agent каждого запроса: в нём названы браузер, его версия и операционная система. По нему серверы отличают iPhone от телефона на Android и от компьютера. Chrome теперь отправляет сокращённую версию, а недостающие подробности переехали в User-Agent Client Hints.

Краткий пересказ вChatGPTClaudePerplexity

Для чего он нужен

Сервер видит User-Agent до того, как что-либо отправит в ответ, поэтому это первая подсказка об устройстве. Smart-ссылка читает его, чтобы выбрать между App Store, Google Play и сайтом. Аналитика строит по нему разбивку по устройствам и браузерам. По нему же видно, что запрос пришёл из встроенного браузера или от робота: многие из них называют себя в этой строке.

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

Что убрал Chrome

Раньше в User-Agent были точная версия Android и модель телефона. Такие подробности помогают выделить одно устройство среди многих, поэтому Chrome их сократил. Теперь Chrome на Android сообщает одни и те же фиксированные значения для любого телефона — Android 10 и модель K, а настоящей остаётся только мажорная версия браузера.

Семейство операционной системы никуда не делось, так что отличить Android от iOS можно, как и раньше. А вот модель телефона и настоящую версию Android сервер из строки больше не узнает. Это затрагивает всё, что привязано к марке телефона, например отправку телефонов Huawei в AppGallery.

Как работают Client Hints

User-Agent Client Hints передают те же сведения отдельными структурированными заголовками. По умолчанию браузер на Chromium отправляет три: Sec-CH-UA с брендом и мажорной версией браузера, Sec-CH-UA-Mobile и Sec-CH-UA-Platform с операционной системой.

Всё остальное нужно запрашивать. Сервер перечисляет нужные подсказки в заголовке ответа Accept-CH, например Sec-CH-UA-Model и Sec-CH-UA-Platform-Version, и браузер добавляет их в последующие запросы. Client Hints отправляются только по HTTPS, и браузер может оставить значение пустым.

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

ПримерСокращённый User-Agent Chrome на Android
Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Mobile Safari/537.36

Попробуйте здесь

Посмотрите, что Instagram и TikTok делают с вашей ссылкой

Вставьте ссылку и проверьте, как её открывают встроенные браузеры, или откройте инструмент внутри приложения, чтобы увидеть его user agent.

Ваш браузер прямо сейчас

Определяем браузер…

Проверьте ссылку прямо здесь

Вставьте ссылку, которую ставите в шапку профиля и в посты, и нажмите на неё. Страница проследит, что случится после нажатия, и покажет результат.

Проверка user agent

Вставьте user agent из логов сервера или аналитики и узнайте, браузер какого приложения его отправил.

Примеры
ПодробнееChrome сообщает каждому серверу, что ваш телефон работает на Android 10Как сокращённый User-Agent повлиял на распознавание устройств и как Client Hints возвращают настоящие версию и модель.

Частые вопросы

Почему Chrome показывает любой телефон как Android 10 и модель K?

Так задумано. Chrome сократил User-Agent, и в строке больше нет точной версии Android и модели телефона. Все телефоны на Android отправляют одни и те же фиксированные значения, а серверы, которым нужны настоящие, запрашивают их через Client Hints.

Можно ли подделать User-Agent?

Да. Это заголовок, который задаёт клиент, и браузеры, скрипты и инструменты тестирования могут отправить любое значение. Для маршрутизации и статистики, где редкое неверное значение почти не вредит, его достаточно, а для проверки безопасности он не годится.

Что такое User-Agent Client Hints?

Набор заголовков запроса, которые передают сведения о браузере и устройстве по одному. Три базовых браузеры на Chromium отправляют по умолчанию. Подробные, такие как модель телефона и полная версия платформы, отправляются только после того, как сервер запросит их через Accept-CH.

  • Геомаршрутизация (geo-routing)

    Геомаршрутизация (geo-routing) — когда посетители одной и той же ссылки попадают на разные адреса назначения в зависимости от страны. Для приложений её чаще всего используют, чтобы выбрать нужный магазин: одна ссылка открывает RuStore пользователям Android в России и Google Play в остальных странах, а страна определяется по IP-адресу посетителя.

  • Встроенный браузер (in-app browser)

    Встроенный браузер (in-app browser) — браузер внутри Instagram, TikTok, Facebook, LinkedIn и других приложений. Ссылка открывается прямо в нём, и человек остаётся в приложении-хосте. Из-за этого Universal Links и App Links часто не срабатывают: вместо вашего приложения открывается сайт, даже если приложение установлено.

  • Клики ботов

    Клики ботов — переходы по ссылке, которые делают не люди. Краулеры превью в WhatsApp, iMessage, Slack и Facebook, поисковые боты, почтовые и антивирусные сканеры открывают ссылку раньше человека. Без фильтрации они раздувают счётчик кликов, и конверсия в установки выглядит хуже, чем на самом деле.

Все термины глоссария

Одна ссылка на App Store, Google Play и сайт

На бесплатном тарифе Appy — 4 ссылки с QR-кодами. Каждый телефон попадает в свой магазин: App Store, Google Play, AppGallery, Galaxy Store или GetApps, а компьютер — на сайт. Без рекламы и без банковской карты.