本頁面由 Cloud Translation API 翻譯而成。

使用屬性篩選資料

透過 Performance Monitoring，您可以使用屬性來區隔成效資料及查看重點評估應用程式在各種實際環境中的表現

點選追蹤記錄表格中的追蹤記錄名稱 (位於清單底部) 這個成效資訊主頁) 後，您就可以深入細查重要指標使用「篩選器」按鈕 (畫面左上方) 根據屬性篩選資料，例如：

圖片：依屬性篩選 Firebase Performance Monitoring 資料

依「應用程式版本」篩選，即可查看過去版本或最新版本
依「裝置」篩選，瞭解舊版裝置如何處理您的應用程式
依「國家/地區」篩選，確保資料庫位置並非影響到特定區域

如要進一步以屬性為依據將效能資料匯出至 BigQuery。

預設屬性

Performance Monitoring 會根據下列條件自動收集各種預設屬性：追蹤類型

除了這些預設屬性以外在你的網站上建立自訂屬性自訂程式碼追蹤記錄，即可按照類別。舉例來說，在遊戲中，您可以按遊戲關卡。

Apple 和 Android 應用程式的預設屬性

根據預設，Apple 和 Android 應用程式的所有追蹤記錄會收集下列屬性：

應用程式版本
國家/地區
作業系統版本
裝置
電台
電信業者

此外，網路要求追蹤記錄也會收集下列屬性：

MIME 類型

收集使用者資料

收集使用者資料：Performance Monitoring 本身不會收集任何個人識別資訊 (PII)，例如姓名、電子郵件地址或電話號碼開發人員可透過以下方式收集額外資料：建立自訂程式碼追蹤記錄來監控效能。這類資料是透過 Performance Monitoring 不得包含任何可識別個人身分的資訊個人提交給 Google

以下是「不含」記錄訊息的範例個人識別資訊：

trace.putAttribute("experiment", "A");

這個範例「確實」包含個人識別資訊 (請勿使用這類個人識別資訊) 自訂屬性)：

trace.putAttribute("email", user.getEmailAddress());

洩漏任何個人識別資訊的資料而非通知即刪除

建立自訂屬性

你可以針對自己的任何檢測設備建立自訂屬性自訂程式碼追蹤記錄。

使用效能監控功能 Trace API 新增自訂屬性至自訂程式碼追蹤記錄。

如要使用自訂屬性，請在應用程式中加入用來定義該屬性的程式碼會將其與特定自訂程式碼追蹤記錄建立關聯。您可以設定屬性。

注意事項：

自訂屬性名稱必須符合下列規定：
- 開頭或結尾無空白，無前置底線 (_) 字元
- 不能有空格
- 長度上限為 32 個半形字元
- 名稱可使用的字元包括 A-Z、a-z 和 _。
每個自訂程式碼追蹤記錄最多可記錄 5 個自訂屬性。
請確認自訂屬性未包含則代表 Google 會識別個人身分。
進一步瞭解這項規範
收集使用者資料：Performance Monitoring 本身不會收集任何個人識別資訊 (PII)，例如姓名、電子郵件地址或電話號碼開發人員可透過以下方式收集額外資料：建立自訂程式碼追蹤記錄來監控效能。這類資料是透過 Performance Monitoring 不得包含任何可識別個人身分的資訊個人提交給 Google

以下是「不含」記錄訊息的範例個人識別資訊：
```
trace.putAttribute("experiment", "A");
```
這個範例「確實」包含個人識別資訊 (請勿使用這類個人識別資訊) 自訂屬性)：
```
trace.putAttribute("email", user.getEmailAddress());
```
洩漏任何個人識別資訊的資料而非通知即刪除

Kotlin+KTX

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}MainActivity.kt

Java

Trace trace = FirebasePerformance.getInstance().newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();MainActivity.java