Поделиться через


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

Это важно

Центр приложений Visual Studio был прекращен 31 марта 2025 г., за исключением функций аналитики и диагностики, которые будут поддерживаться до 30 июня 2026 г. Подробнее.

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

Общие данные

Данные, отправленные с помощью заголовков запросов из пакета разработки программного обеспечения (SDK) в сбор данных.

Обязательные данные — App-Secret, Install-ID

  • Секрет приложения (App-Secret) Уникальный ключ, используемый для идентификации приложения.

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

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

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

  • Метка времени (метка времени) Метка времени журнала, пример: '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) Размер экрана устройства в пикселях (например, 640x480).

  • Версия приложения (appVersion) Версия приложения обычно представляется в формате: основной, младшей, сборки (например, 1.1.42)

  • Название оператора (carrierName) Название мобильного оператора.

  • Страна перевозчика (carrierCountry) Страна поставщика услуг мобильной связи.

  • Сборка приложений (appBuild) Номер сборки приложения. (пример: 42)

  • Пространство имен приложения (appNamespace) Идентификатор упаковки, идентификатор пакета или пространство имен в зависимости от того, что использует отдельная платформа (например, com.microsoft.example)

  • Метка выпуска Live Update (liveUpdateReleaseLabel) Метка, используемая для идентификации кода приложения "версия", выпущенная с помощью маяка динамического обновления, запущенного на устройстве.

  • Ключ развертывания Live Update (liveUpdateDeploymentKey) Идентификатор среды, к которой принадлежит текущий выпуск приложения, ключ развертывания затем сопоставляется с средой, такой как Production, Staging

  • Хэш пакета динамического обновления (liveUpdatePackageHash) Хэш всех файлов (ReactNative или Cordova), развернутых на устройстве с помощью маяка LiveUpdate. Помогает определить версию программного обеспечения на устройстве и необходимость загрузки обновлений в будущем.

  • Версия оболочки среды выполнения (оболочкаRuntimeVersion) Версия платформы технологий оболочки (версия среды выполнения Xamarin, ReactNative, Cordova и т. д.). Ознакомьтесь с wrappersdkname, чтобы узнать, относится ли эта версия к Xamarin, ReactNative или другому варианту.

  • Джейлбрейк (jailbreak) Флаг, указывающий, было ли устройство взломано.

Аналитика

  • Метрики взаимодействия Взаимодействие измеряет ежедневные сеансы на пользователя и длительность сеанса.

    • Ежедневные сеансы на пользователя: ежедневное среднее количество сеансов на пользователя.

    • Общее количество сеансов: общее количество сеансов.

    • Среднее число сеансов в день: количество сеансов в день в среднем по диапазону времени.

    • Длительность сеанса: распределение количества сеансов в течение нескольких интервалов.

    • Средняя длина сеанса: среднее значение всех продолжительности сеансов в выбранном диапазоне времени.

  • Метрики событий Вы можете отслеживать собственные метрики событий до 20 свойств, чтобы понять взаимодействие между пользователями и приложением.

Диагностика

  • Данные журналов сбоев и ошибок Эти данные включают идентификатор и имя процессов, потоков, кадров, связанных с сбоем и типом исключения и данными сообщения и устройства, как определено в разделе Common Data

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

  • Настраиваемые свойства Эти пары настраиваемых значений ключей можно указать при необходимости, чтобы добавить дополнительный контекст в отчеты об ошибках.

  • Идентификатор пользователя сбоя и ошибки Этот уникальный идентификатор при необходимости устанавливается разработчиком для присоединения идентификации конкретного пользователя к отчетам о сбоях.

  • Файлы символов Эти файлы символов предоставляются разработчиком для App Center, чтобы преобразовать аварийные отчеты в читаемый формат.

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

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