共用方式為


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 的每個應用程式安裝都會產生新的唯一安裝識別碼。 此標識碼可用來區分數據與唯一裝置。 App Center 服務需要標識碼才能正常運作。

從 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) 裝置製造商的名稱(例如:HTC)

  • 作系統名稱 (osName) OS 名稱(範例:iOS)

  • 作系統版本 (osVersion) 作系統版本(範例: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) 用來識別透過裝置上執行的即時更新指標所發行應用程式程式代碼「版本」的標籤。

  • 即時更新部署金鑰 (liveUpdateDeploymentKey) 目前應用程式版本所屬環境標識碼,部署密鑰接著會對應至生產環境、預備環境等環境

  • 即時更新套件哈希 (liveUpdatePackageHash) 透過 LiveUpdate 指標部署到裝置的所有檔案哈希(ReactNative 或 Cordova)。 協助識別裝置上的發行版本,或者在未來需要下載更新時使用

  • 運行時間包裝函式版本 (wrapperRuntimeVersion) 包裝函式技術架構的版本(Xamarin 運行時間版本、ReactNative、Cordova 等等)。 請參閱 wrappersdkname 以查看此版本是否參考 Xamarin 或 ReactNative 或其他。

  • 越獄(越獄) 旗標,指出裝置是否已越獄。

數據分析

  • 參與度指標 參與度衡量每日每位使用者的會話次數及會話持續時間。

    • 每位使用者的每日會話數:每位使用者的每日平均會話數目。

    • 會話總數:會話總數。

    • 每日平均會話數:時間範圍內平均每天的會話數目。

    • 會話持續時間,會話數目的分佈在幾個持續時間區間內。

    • 平均會話長度:所選時間範圍內所有會話持續時間的平均值。

  • 事件計量 您可以使用最多 20 個屬性來追蹤自己的 事件計量 ,以瞭解使用者與應用程式之間的互動。

診斷

  • 當機和錯誤記錄數據 此數據報含與當機相關的進程、線程、框架標識符和名稱,以及 Common Data 區段中所定義的例外狀況類型和訊息和裝置數據

  • 當機附件 這些附件是開發人員可以選擇附加至當機報表的二進位或文本檔。

  • 自訂屬性 您可以選擇性地指定這些自定義索引鍵值組,以將其他內容新增至其錯誤報告。

  • 當機和錯誤使用者識別碼 開發人員選擇性地設定此唯一標識符,以附加特定使用者的標識碼以產生當機報告。

  • 符號檔 這些符號檔是由開發人員為 App Center 提供,以符號化當機。

分發

  • 令牌 此 GUID 會傳送至散發服務,以檢查應用程式的新版本。 只有在使用App Center安裝應用程式時,才會傳送 GUID。