Данные, собранные пакетами SDK для Центра приложений

Статья
07/19/2023

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio до полного прекращения его использования, существует несколько рекомендуемых вариантов, на которые можно перейти.

Узнайте больше о сроках поддержки и альтернативных вариантах.

Пакеты SDK центра приложений отправляют данные в службы Центра приложений. Отправленные данные зависят от используемого пакета SDK или службы, способа настройки пакета SDK и службы сбоя данных, обрабатываемых приложением. Использование некоторых служб требует отправки определенных данных, чтобы служба функционировала. Все данные, отправляемые в Центр приложений, передаются через центральную службу приема.

Общие данные

Данные, отправляемые через заголовки запросов из пакета SDK в прием данных

Обязательные данные — Секрет приложения, Идентификатор установки

Секрет приложения (секрет приложения) Уникальный ключ, используемый для идентификации приложения.
Идентификатор установки (Install-ID) При каждой установке приложения с помощью пакета SDK центра приложений создается новый уникальный идентификатор установки. Этот идентификатор используется для отличия данных от уникальных устройств. Для правильной работы служб Центра приложений требуется идентификатор.

Данные, отправляемые через текст запроса из пакета SDK в прием

Обязательные данные : sdkName, sdkVersion, osName, osVersion, locale, timeZoneOffset, appVersion, appBuild

Timestamp (timestamp) Метка времени журнала, пример: '2017-03-13T18:05:42Z'
Идентификатор сеанса (sid) Журналы Аналитики могут быть частью одного сеанса, указав этот идентификатор.
Идентификатор пользователя (userId) Необязательная строка, используемая для связи журналов с пользователями.
Имя пакета SDK (sdkName) Имя пакета SDK. Состоит из имени пакета SDK и платформы, например appcenter.ios, hockeysdk.android.
Версия пакета SDK (sdkVersion) Версия пакета SDK в формате semver, например 1.2.0 или 0.12.3-alpha.1.
Версия программы-оболочки пакета SDK (wrapperSdkVersion) Версия пакета SDK-оболочки в формате semver. Когда пакет SDK заключает в оболочку базовый пакет SDK, в этом поле записывается версия пакета SDK, в то время как базовая версия пакета SDK — sdkVersion. Например, Xamarin.Android заключает в оболочку собственный Android.
Имя оболочки пакета SDK (wrapperSdkName) Имя пакета SDK-оболочки. Состоит из имени пакета SDK и платформы-оболочки, например appcenter.xamarin, hockeysdk.cordova.
Модель (модель) Модель устройства (пример: iPad2,3)
Имя OEM (oemName) Имя изготовителя устройства (например, HTC)
Имя операционной системы (osName) Имя ОС (например, iOS)
Версия операционной системы (osVersion) Версия ОС (пример: 9.3.0)
Код сборки операционной системы (osBuild) Код сборки ОС (пример: LMY47X)
Уровень API операционной системы (osApiLevel) Уровень API, если применимо, например в Android (пример: 15)
Язык и код страны (языковой стандарт) Язык ISO и код страны (например, en-US)
Смещение часового пояса (timeZoneOffset) Смещение в минутах от utc для часового пояса устройства, включая летнее время.
Размер экрана (screenSize) Размер экрана устройства в пикселях (например, 640 x 480).
Версия приложения (appVersion) Версия приложения обычно в основной, вспомогательной сборке (например, 1.1.42).
Имя оператора (carrierName) Имя поставщика службы ячеек.
Страна-перевозчик (carrierCountry) Страна поставщика услуг ячейки.
Сборка приложения (appBuild) Номер сборки приложения. (пример: 42)
Пространство имен приложения (appNamespace) Идентификатор пакета, идентификатор пакета или пространство имен в зависимости от того, что использует отдельная платформа (например, com.microsoft.example).
Метка выпуска динамического обновления (liveUpdateReleaseLabel) Метка, используемая для идентификации кода приложения "версия", выпущенного с помощью маяка динамического обновления, работающего на устройстве.
Ключ развертывания динамического обновления (liveUpdateDeploymentKey) Идентификатор среды, к которой относится текущий выпуск приложения, а затем ключ развертывания сопоставляется со средой, такой как рабочая среда, промежуточная среда.
Хэш пакета динамического обновления (liveUpdatePackageHash) Хэш всех файлов (ReactNative или Cordova), развернутых на устройстве с помощью маяка LiveUpdate. Помогает определить версию выпуска на устройстве или необходимость скачивания обновлений в будущем
Версия оболочки среды выполнения (оболочкаRuntimeVersion) Версия платформы технологии-оболочки (версия среды выполнения Xamarin, ReactNative, Cordova и т. д.). См. раздел wrappersdkname, чтобы узнать, относится ли эта версия к Xamarin, ReactNative или другому.
Побег из тюрьмы (jailbreak) Флаг, указывающий, было ли устройство снято со снятой защитой.

Аналитика

Метрики задействования Engagement измеряет ежедневные сеансы для каждого пользователя и длительность сеанса.
- Ежедневные сеансы на пользователя: ежедневное среднее количество сеансов на пользователя.
- Всего сеансов: общее количество сеансов.
- Среднее число сеансов в день: количество сеансов в день, усредненное по диапазону времени.
- Длительность сеанса. Распределение количества сеансов за несколько интервалов.
- Средняя продолжительность сеанса: среднее значение всех продолжительности сеансов в выбранном диапазоне времени.
Метрики событий Вы можете отслеживать собственные метрики событий с помощью до 20 свойств, чтобы понять взаимодействие между пользователями и приложением.

Диагностика

Данные журналов сбоев и ошибок Эти данные включают идентификатор и имена процессов, потоков, кадров, связанных со сбоем, а также тип исключения и данные сообщения и устройства, как определено в разделе Общие данные.
Аварийные вложения Эти вложения представляют собой двоичные или текстовые файлы, которые разработчики могут при необходимости вложить в отчет о сбоях.
Пользовательские свойства При необходимости можно указать эти пользовательские пары значений ключей, чтобы добавить дополнительный контекст в отчеты об ошибках.
Сбой и ошибка Идентификатор пользователя Этот уникальный идентификатор при необходимости задается разработчиком, чтобы прикрепить идентификацию конкретного пользователя к отчетам о сбоях.
Файлы символов Эти файлы символов предоставляются разработчиком для Центра приложений для символики сбоев.

Распространение

Маркер Этот GUID отправляется в службу распространения для проверка для новой версии приложения. Guid отправляется только в том случае, если приложение было установлено с помощью Центра приложений.