App Center SDK 收集的数据

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center,直到它完全停用,但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方案。

App Center SDK 将数据发送到 App Center 服务。 发送的数据因所使用的 SDK/服务、SDK 的配置方式以及应用程序处理的数据故障服务而异。 使用某些服务需要发送某些数据才能使服务正常运行。 发送到 App Center 的所有数据都通过中央引入服务传输。

通用数据

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

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

  • 应用程序机密 (应用机密) 用于标识应用程序的唯一键。

  • 安装标识符 (Install-ID) 每次使用 App Center SDK 安装应用都会生成一个新的唯一安装标识符。 此 ID 用于区分数据与唯一设备。 App Center 服务需要 ID 才能正常工作。

通过请求正文从 SDK 发送到引入的数据

所需数据 - sdkName、sdkVersion、osName、osVersion、区域设置、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) 采用 semver 格式的包装器 SDK 的版本。 当 SDK 包装基础 SDK 时,包装 SDK 版本将在此字段中捕获,而基本 SDK 版本为 sdkVersion。 例如,Xamarin.Android 包装本机 Android。

  • SDK 包装器名称 (wrapperSdkName) 包装器 SDK 的名称。 由 SDK 和包装器平台的名称组成,例如“appcenter.xamarin”、“hockeysdk.cordova”。

  • 模型 (模型) 设备型号 (示例:iPad2,3)

  • OEM 名称 (oemName) 设备制造商的名称 (示例:HTC)

  • 操作系统名称 (osName) OS 名称 (示例:iOS)

  • 操作系统版本 (osVersion) OS 版本 (示例:9.3.0)

  • 操作系统生成代码 (osBuild) OS 生成代码 (示例:LMY47X)

  • 操作系统 API 级别 (osApiLevel) API 级别(如 Android (示例:15)

  • 语言和国家/地区代码 (区域设置) ISO 语言和国家/地区代码 (示例:en-US)

  • 时区偏移量 (timeZoneOffset) 设备时区与 UTC 的偏移量(以分钟为单位),包括夏令时。

  • 屏幕大小 (屏幕大小) 设备屏幕的大小(以像素为单位) (示例:640x480) 。

  • 应用程序版本 (appVersion) 应用程序版本通常位于主要内部版本 (示例:1.1.42)

  • 运营商名称 (carrierName) 单元格服务提供程序的名称。

  • 运营商国家/地区 (运营商国家/地区) 单元格服务提供商的国家/地区。

  • 应用程序生成 (appBuild) 应用的内部版本号。 (示例:42)

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

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

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

  • 实时更新包哈希 (liveUpdatePackageHash) (ReactNative 或 Cordova 的所有文件的哈希) 通过 LiveUpdate 信标部署到设备。 帮助识别设备上的发布版本或将来需要下载更新

  • 运行时包装器版本 (wrapperRuntimeVersion) 包装器技术框架的版本 (Xamarin 运行时版本、ReactNative、Cordova 等) 。 请参阅 wrappersdkname,了解此版本是否引用 Xamarin 或 ReactNative 或其他版本。

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

分析

  • 参与指标 Engagement 衡量每个用户的每日会话数和会话持续时间。

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

    • 会话总数:会话总数。

    • 平均每天会话数:在时间范围内平均每天会话数。

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

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

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

诊断

  • 崩溃和错误日志数据 此数据包括与崩溃和异常类型相关的进程、线程、帧的 ID 和名称,以及通用数据部分中定义的消息和设备数据

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

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

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

  • 符号文件 这些符号文件由 App Center 开发人员提供,用于对崩溃进行符号化处理。

分发

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