Как правильно сформировать User-Agent для мобильных приложений

1. Пользователь-Агент
2. Как сформировать значимых User-Agents для мобильных приложений
3. Нативное приложение для Android
4. Нативное приложение для iOS
5. Objective-C
6. стриж
7. телефон с операционной системой Виндоус
8. Последние мысли

Нативные приложения, мобильные приложения или просто приложения. Мы называем их разными вещами и используем их постоянно. С точки зрения бизнеса, приложения дополняют мобильные и настольные сайты. Они являются естественным продолжением онлайн-стратегии. В связи с этим важно предпринять необходимые шаги, чтобы удостовериться, что собственные приложения и их версии являются идентифицируемыми. Это важно как с точки зрения аналитики, так и с точки зрения разработчика или поддержки. Нативные приложения имеют много общего с сетью. Приложения часто используют те же онлайн-ресурсы, что и веб-сайт, такие как RESTful API, изображения или видео. Поскольку эти ресурсы являются общими, очень важно правильно сформировать User-Agents для мобильных приложений, чтобы определить, кто использует ресурсы. Пользователь в приложении для Android или iOS? Какая версия приложения? Какая версия ОС? И так далее.

Существует два типа мобильных приложений: 1) полностью нативные и 2) гибридные приложения на основе веб-просмотра. В этом посте мы сосредоточимся на полностью нативных приложениях, где HTTP-запросы отправляются нативным кодом.

Если вас интересуют гибридные приложения на основе веб-просмотра, в которых окно браузера заключено в собственную оболочку, ознакомьтесь с этот другой пост о строках User-Agent для гибридных веб-приложений ,

Пользователь-Агент

Уже существует отраслевой стандарт для идентификации устройств, который приложения также могут использовать. Это строка User-Agent. Строка User-Agent - это поле в заголовке HTTP, которое может идентифицировать приложение, выполняющее запрос. В веб-браузере User-Agent устанавливается браузером (который также является приложением). Теперь вместо браузера наше приложение будет отправлять HTTP-запросы. Когда мы разрабатываем собственное приложение для мобильного телефона, нам нужно принять меры, чтобы наш User-Agent содержал значимую информацию. В противном случае приложение получит значения по умолчанию, что не очень полезно в любом контексте.

Как сформировать значимых User-Agents для мобильных приложений

Спецификация ясно:

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

Спецификация идет более подробно и делает вывод, что агенты пользователей должны состоять из одного или нескольких идентификаторов продукта и необязательных версий. По соглашению идентификаторы продуктов перечислены в порядке убывания их значимости для идентификации программного обеспечения User-Agent.

Давайте подробно рассмотрим, как составить значимые строки User-Agent для собственных приложений на разных платформах:

Нативное приложение для Android

Исходя из спецификации выше, шаблон, который мы хотим для User-Agent нашего приложения:

<AppName> / <версия> Dalvik / <версия> (Linux; U; Android <версия Android>; <идентификатор устройства> Build / <buildtag>)

Например:

Myapp / 1 Dalvik / 2.1.0 (Linux; U; Android 6.0.1; Vivo 1610 Build / MMB29M)

Важной частью здесь является «Myapp / 1», который идентифицирует нативное приложение и версию приложения. Это самое значительное. Остальная часть строки идентифицирует основное программное обеспечение. В Android относительно легко составить пользовательскую строку User-Agent. Вот пример кода:

URLConnection cn = новый URL ("http: // ....") .openConnection (); cn.setRequestProperty («Пользователь-агент», «Myapp / 1» + System.getProperty («http.agent»)); cn.connect ();

Если вы используете популярный Пикассо библиотека, то композиция похожа. Однако фактический запрос сделан немного по-другому. Посмотри это Пример приложения, созданного с помощью Picasso на Github.

Нативное приложение для iOS

Пользовательские агенты для iOS немного сложнее из-за того, что нам приходится учитывать и Objective-C, и Swift. Пользовательский агент по умолчанию в iOS может выглядеть примерно так:

MyApp / 1 CFNetwork / 808.3 Darwin / 16.3.0

В iOS компонент под названием «CFNetwork» управляет сетевым обменом данными. Также участвует UNIX-версия, на которой построена iOS: «Дарвин». Оба они упоминаются в пользовательском агенте по умолчанию. Кроме того, может быть добавлен пользовательский идентификатор приложения. Так что не очень значимый.

Чтобы создать более значимый User-Agent, нам нужно добавить больше информации, например:

<AppName / <версия> <платформа iDevice> <идентификатор модели Apple> iOS / <версия ОС> CFNetwork / <версия> Darwin / <версия>

Например:

MyApp / 1 iPhone5,2 iOS / 10_1 CFNetwork / 808,3 Darwin / 16.3.0

Основная задача при создании User-Agent в iOS - собрать все необходимые параметры. Например, не очевидно, как найти значения CFNetwork- и Darwin. Мы написали пример приложения в Objective-C а также стриж с функциональностью, необходимой для сбора всех битов, которые входят в строку User-Agent. Не стесняйтесь использовать его. Как только биты собраны, просто вызовите функцию для создания User-Agent, прежде чем сделать запрос:

Objective-C

NSString * userAgent = getUAString (); NSURL * url = [NSURL URLWithString: @ ""]; NSMutableURLRequest * request = [[NSMutableURLRequest alloc] initWithURL: url]; [request setValue: userAgent forHTTPHeaderField: @ "User-Agent"];

Для полного кода функции getUAString (), увидеть Github ,

стриж

let userAgent = UAString (), если let url = NSURL (string: "") {let request = NSMutableURLRequest (url: url as URL) request.setValue (userAgent, forHTTPHeaderField: "User-Agent") // ...}

Для полного кода функции getUAString (), увидеть Github ,

телефон с операционной системой Виндоус

Стоит отметить, что Windows Phone не так популярен, как Android и iOS. Семантика User-Agent похожа:

<имя приложения> / <версия> Windows Phone / <версия ОС> <название устройства>; <название модели устройства>)

Например:

MyApp / 1 Windows Phone / 10.0 Microsoft; Lumia 550

Вы можете получить фирменное наименование устройства и название модели из класса EasClientDeviceInformation с помощью свойств SystemManufacturer и SystemProductName . Версия ОС может быть извлечена из свойства DeviceFamilyVersion в классе AnalyticsVersionInfo .

Последние мысли

Даже если ваша любимая библиотека или фреймворк не рассматриваются в этом посте, эти примеры должны быть достаточно общими, чтобы их можно было перенести в любой фреймворк. Стоит потратить дополнительные несколько минут на разработку, чтобы убедиться, что пользовательский агент вашего приложения имеет смысл и соответствует спецификации. Ваша аналитика, devops, и отладка все выиграют. Кроме того, вы можете использовать это обнаружение устройств для таргетинга на конкретные устройства, приложения или версии приложений на определенных платформах с сообщениями, рекламой или контентом.

В этой статье рассматриваются пользовательские агенты в полностью нативных приложениях. Если ваше приложение является веб-приложением (или гибридным приложением), то прочитайте «Правильно сформируйте User-Agent для приложений Webview»

Похожие

Комментарии