通过

App Center SDK 收集的数据

重要

Visual Studio App Center 于 2025 年 3 月 31 日停用，但分析和诊断功能除外，这些功能将继续受支持，直到 2026 年 6 月 30 日。 了解详细信息。

App Center SDK 将数据发送到 App Center 服务。 发送的数据会根据所使用的 SDK/服务、SDK 的配置以及应用程序处理中与崩溃服务相关的数据而有所不同。 某些服务的用法要求发送某些数据才能使服务正常运行。 发送到 App Center 的所有数据都会通过中央引入服务传输。

常见数据

通过从 SDK 到引入的请求标头发送的数据

必需数据 - 应用机密、Install-ID

  • 应用程序机密（App-Secret） 用于标识应用程序的唯一键。

  • 安装标识符（Install-ID） 使用 App Center SDK 的每个应用安装都会生成新的唯一安装标识符。 此 ID 用于将数据与唯一设备区分开来。 App Center 服务需要 ID 才能正常运行。

通过请求正文从 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） 采用 semver 格式的 SDK 版本，例如“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） 设备制造商的名称（例如：HP）

  • 作系统名称 （osName） OS 名称（示例：iOS）

  • 操作系统版本 （osVersion） OS 版本 （例如：9.3.0）

  • 作系统生成代码 （osBuild） OS 生成代码（示例：LMY47X）

  • 操作系统 API 级别（osApiLevel） 适用于 Android 的情况时的 API 级别（例如：15）

  • 语言和国家/地区代码（区域设置） ISO 语言和国家/地区代码（示例：en-US）

  • 时区偏移量（timeZoneOffset） 设备时区的 UTC 偏移量（以分钟为单位，包括夏令时）。

  • 屏幕大小（screenSize） 设备屏幕的大小（例如：640x480）。

  • 应用程序版本（appVersion） 应用程序的版本通常分为主要版本、次要版本和构建版本（例如：1.1.42）

  • 运营商名称（carrierName） 移动网络服务提供商的名称。

  • 运营商国家（carrierCountry） 移动服务提供商的国家。

  • 应用程序生成（appBuild） 应用的内部版本号。 （示例：42）

  • 应用程序命名空间 （appNamespace） 捆绑标识符、包标识符或命名空间，具体取决于各个平台使用的内容（示例：com.microsoft.example）

  • 实时更新发布标签 （liveUpdateReleaseLabel） 用于标识通过设备上运行的实时更新信标发布的应用程序代码“版本”的标签。

  • Live Update 部署密钥 （liveUpdateDeploymentKey） 当前应用程序版本所属的环境标识符，然后部署密钥映射到生产环境、过渡环境

  • 实时更新包哈希（liveUpdatePackageHash） 是通过 LiveUpdate 信标部署到设备上的所有文件（ReactNative 或 Cordova）的哈希值。 帮助识别设备上的软件发行版本，并确定未来是否需要下载更新。

  • 运行时包装器版本 （wrapperRuntimeVersion） 包装技术框架的版本（Xamarin 运行时版本、ReactNative、Cordova 等）。 请参阅 wrappersdkname，查看此版本是否引用 Xamarin 或 ReactNative 或其他版本。

  • 越狱 指示设备是否已越狱的标志。

数据分析

  • Engagement 指标 Engagement 度量每个用户的每日会话和会话持续时间。

    • 每个用户的每日会话数：每个用户的每日平均会话数。

    • 会话总数：会话总数。

    • 平均每天会话次数：在指定时间范围内计算的每天会话平均次数。

    • 会话持续时间：在几个持续时间间隔内分布会话数。

    • 平均会话长度：所选时间范围内所有会话持续时间的平均值。

  • 事件指标 可以使用最多 20 个属性跟踪自己的 事件指标 ，以了解用户与应用之间的交互。

诊断

  • 崩溃和错误日志数据 此数据包括与故障相关的进程、线程、帧的 ID 和名称，以及 Common Data 节中定义的异常类型和消息和设备数据

  • 崩溃附件 这些附件是开发人员可以选择附加到崩溃报告的二进制文件或文本文件。

  • 自定义属性 可以选择指定这些自定义键值对，以向其错误报告添加其他上下文。

  • 崩溃和错误用户 ID 开发人员可以选择将此唯一标识符设置为将特定用户的标识附加到崩溃报告。

  • 符号文件 这些符号文件由开发人员为 App Center 提供，以符号化崩溃。

分发

  • 令 牌 此 GUID 将发送到分发服务，以检查应用程序的新版本。 仅当应用程序使用 App Center 安装时，才会发送 GUID。