共用方式為

App Center Analytics （MAUI 和 Xamarin）

這很重要

Visual Studio App Center 於 2025 年 3 月 31 日淘汰，但分析和診斷功能除外，這些功能將持續支援到 2026 年 6 月 30 日。 瞭解更多資訊。

App Center Analytics 可協助您了解使用者行為和客戶參與，以改善您的應用程式。 SDK 會自動擷取會話計數和裝置屬性，例如模型、OS 版本等。您可以定義自己的自定義事件，以測量對您而言很重要的事情。 您可以在 App Center 入口網站中取得擷取的所有資訊，讓您分析數據。

如果您尚未在應用程式中設定 SDK，請遵循 [開始使用 ] 區段。

會話和裝置資訊

將 App Center Analytics 新增至應用程式並啟動 SDK 之後，它會自動追蹤會話和裝置屬性，例如 OS 版本、模型等，而不需要撰寫任何其他程式碼。

國碼 (地區碼)

如果裝置已安裝行動數據數據數據機和 SIM 卡，SDK 會自動報告使用者的國家/地區代碼。 僅限WiFi的裝置預設不會回報國家/地區代碼。 若要設定這些使用者的國家/地區代碼，您必須自行擷取使用者的位置，並在 SetCountryCode: SDK 中使用 方法：

AppCenter.SetCountryCode("en");

備註

若要在 Analytics 工作階段上顯示國家/地區代碼，必須先呼叫 AppCenter.SetCountryCode，然後再呼叫 AppCenter.Start。

自訂事件

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

啟動 SDK 之後，請使用 TrackEvent() 方法來追蹤事件與屬性。 您最多可以傳送 200 個不同的事件名稱。 此外，每個事件名稱上限為 256 個字元，每個事件屬性名稱和事件屬性值各有 125 個字元。

Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi"}
});

事件的屬性是完全選擇性的 – 如果您只想追蹤事件，請改用此範例：

Analytics.TrackEvent("Video clicked");

在運行時間啟用或停用 App Center Analytics

您可以在運行時間啟用和停用 App Center Analytics。 如果您將其停用，SDK 將不會收集應用程式的任何其他分析資訊。

Analytics.SetEnabledAsync(false);

若要再次啟用App Center Analytics，請使用相同的API，但傳遞 true 做為參數。

Analytics.SetEnabledAsync(true);

您不需要等候此呼叫，即可讓其他 API 呼叫 （例如） IsEnabledAsync保持一致。

狀態會保存在裝置跨應用程式啟動時的記憶體中。

備註

只在啟動 Analytics 之後，才能使用這個方法。

檢查 App Center 分析是否已啟用

您也可以檢查 App Center Analytics 是否已啟用。

bool isEnabled = await Analytics.IsEnabledAsync();

備註

這個方法只能在 Analytics 已啟動後使用，開始之前它總是會傳回 false。

管理啟動工作階段

根據預設，會話標識碼取決於應用程式的生命週期。 如果您想要手動控制新工作階段的開始，請遵循後續步驟：

備註

請注意 ，Analytics.StartSession（） API 的每個呼叫都會產生新的會話。 如果在手動會話追蹤器模式下未呼叫此 API，則所有傳送記錄將具有空會話值。

備註

請注意，在新的應用程式啟動之後，會話標識碼將會重新產生。

  • 在 SDK 啟動之前呼叫下列方法：
Analytics.EnableManualSessionTracker();
  • 接著，您可以在 StartSession 之後使用 AppCenter.Start API。
Analytics.StartSession();

本機儲存體大小

根據預設，SDK 會將最多 10 MB 的記錄儲存在記憶體中。

沒有因特網存取

當沒有任何網路連線時，SDK 會在本機記憶體中儲存最多 10 MB 的記錄。 記憶體已滿之後，SDK 會開始捨棄舊的記錄，以騰出空間供新的記錄使用。 裝置返回因特網存取之後，SDK 會每隔 6 秒傳送 50 或之後的記錄。

批處理事件記錄

App Center SDK 會在 50 個批次中上傳記錄，如果 SDK 沒有 50 個要傳送的記錄，它仍會在 6 秒後傳送記錄。 最多可以平行傳送三個批次。

重試和退避邏輯

App Center SDK 支援可復原網路錯誤的回復重試。 以下是重試邏輯：

  • 每個請求最多可嘗試3次。
  • 每個請求都有自己的重試狀態機。
  • 在一個請求耗盡其所有重試後，所有傳輸通道都會停用（直到下一次應用程式進程）。

退後邏輯

  • 50% 隨機化，第一次重試 5 到 10 秒，第二次重試介於 2.5 到 5 分鐘之間，最後一次嘗試介於 10 到 20 分鐘之間。
  • 如果網路從關閉切換為開啟（或從 wi-fi 切換至行動裝置），則會重設重試狀態，並立即重試要求。
  • Last updated on