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

使用屬性篩選資料

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

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

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

按「網頁網址」篩選，即可查看特定網頁的資料網站
依「有效連線類型」篩選，瞭解 3G 連線方式對您的應用程式有影響
依「國家/地區」篩選，確保資料庫位置並非影響到特定區域

預設屬性

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

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

系統為網頁應用程式收集的預設屬性

網頁應用程式的所有追蹤記錄預設都會收集下列屬性：

瀏覽器
國家/地區
有效的連線類型
網頁網址
Service worker 狀態
瀏覽權限狀態

收集使用者資料

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

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

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

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

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

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

建立自訂屬性

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

使用 Performance Monitoring Trace API 新增自訂屬性至自訂程式碼追蹤記錄。

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

注意事項：

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

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

Web

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

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

// Read attributes
const traceAttributes = t.getAttributes();perf_add_custom_attributes.js

Web

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

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

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

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

// Read attributes
const traceAttributes = trace.getAttributes();index.js