App Center SDK 所收集的數據

重要

Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center,直到它完全淘汰為止,但有數個建議您考慮移轉至的建議替代方案。

深入瞭解支持時程表和替代方案。

App Center SDK 會將數據傳送至 App Center 服務。 所傳送的數據會因所使用的 SDK/服務、SDK 的設定方式,以及應用程式所處理數據上的損毀服務而有所不同。 某些服務的使用方式需要傳送特定數據,才能讓服務運作。 傳送至 App Center 的所有數據都會通過中央擷取服務。

一般資料

透過要求標頭從 SDK 傳送至擷取的數據

必要數據 – App-Secret、Install-ID

  • 應用程式密碼 (應用程式秘密) 用來識別應用程式的唯一索引鍵。

  • 安裝識別碼 (Install-ID) 每個具有 App Center SDK 的應用程式安裝都會產生新的唯一安裝識別碼。 此標識碼用來區分數據與唯一裝置。 App Center 服務需要標識碼才能正常運作。

透過要求本文從 SDK 傳送至擷取的數據

必要數據 - sdkName、sdkVersion、osName、osVersion、locale、timeZoneOffset、appVersion、appBuild

  • 時間戳 (時間戳) 記錄時間戳,例如:'2017-03-13T18:05:42Z'

  • 工作階段識別碼 (sid) 分析記錄可以藉由指定此標識碼,成為相同會話的一部分。

  • user Identifier (userId) 選擇性字串,用於將記錄與用戶產生關聯。

  • SDK 名稱 (sdkName) SDK 的名稱。 包含 SDK 和平台的名稱,例如 “appcenter.ios”、“hockeysdk.android”

  • SDK 版本 (sdkVersion) semver 格式的 SDK 版本,例如 “1.2.0” 或 “0.12.3-alpha.1”

  • SDK 包裝函式版本 (包裝函式SdkVersion) semver 格式的包裝函式 SDK 版本。 當 SDK 包裝基底 SDK 時,會在此欄位中擷取包裝 SDK 版本,而基底 SDK 版本是 sdkVersion。 例如,Xamarin.Android 會包裝原生 Android。

  • SDK 包裝函式名稱 (包裝函式SdkName) 包裝函式 SDK 的名稱。 包含 SDK 的名稱和包裝函式平臺,例如 「appcenter.xamarin」、“hockeysdk.cordova”。

  • 模型 (模型) 裝置型號 (範例:iPad2,3)

  • OEM 名稱 (oemName) 裝置製造商的名稱 (範例:)

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

  • 作業系統版本 (osVersion) OS 版本 (範例:9.3.0)

  • 作業系統組建程式碼 (osBuild) OS 組建程式代碼 (範例:LMY47X)

  • 作業系統 API 層級 (osApiLevel) 在 Android (範例中適用時適用的 API 層級:15)

  • 語言和國家/地區代碼 (地區設定) ISO 語言和國家/地區代碼 (範例:en-US)

  • 時區位移 (timeZoneOffset) 裝置時區的 UTC 以分鐘為單位的位移,包括日光節約時間。

  • 螢幕大小 (螢幕大小大小) 以像素為單位的裝置畫面大小 (範例:640x480) 。

  • 應用程式版本 (appVersion) 應用程式版本通常位於主要、次要、組建 (範例:1.1.42)

  • carrier Name (carrierName) 數據格服務提供者的名稱。

  • Carrier Country (carrierCountry) 數據格服務提供者的國家/地區。

  • 應用程式組建 (appBuild) 應用程式的組建編號。 (範例:42)

  • 應用程式命名空間 (appNamespace) 套件組合標識碼、套件標識碼或命名空間,視個別平臺使用 (範例而定:com.microsoft.example)

  • live Update Release Label (liveUpdateReleaseLabel) 用來識別透過裝置上執行的 Live Update 指標發行的應用程式程式代碼 'version' 的標籤。

  • Live Update Deployment Key (liveUpdateDeploymentKey) 目前應用程式版本所屬環境標識碼,部署密鑰接著對應至生產環境、預備環境等環境

  • Live Update Package Hash (liveUpdatePackageHash) 所有檔案的哈希 (ReactNative 或 Cordova) 透過 LiveUpdate 指標部署到裝置。 協助識別裝置上的發行版本,或未來需要下載更新

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

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

分析

  • 參與計量 Engagement 會測量每個使用者和會話持續時間的每日會話。

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

    • 會話總數:會話總數。

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

    • 會話持續時間:在數個持續時間間隔內分佈會話數目。

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

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

診斷

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

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

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

  • 損毀和錯誤使用者標識碼 開發人員可以選擇性地設定這個唯一標識符,以附加特定使用者的識別來當機報告。

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

散發

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