属性を使用してデータをフィルタする

iOS+ Android ウェブ

Performance Monitoring では、属性を使用してパフォーマンス データをセグメント化し、さまざまなシナリオにおけるアプリのパフォーマンスに焦点を当てることができます。

トレース テーブル（パフォーマンス ダッシュボードの下部）でトレース名をクリックすると、目的の指標にドリルダウンできます。[フィルタ ] ボタン（画面左上）を使用して属性でデータをフィルタできます。以下に例を示します。

• [アプリのバージョン] でフィルタし、過去のリリースや最新のリリースに関するデータを表示する
• [デバイス] でフィルタし、古いデバイスにおけるアプリの処理方法を確認する
• [国] でフィルタし、データベースのロケーションが特定のリージョンに影響していないことを確認する

属性に基づいてより強力に分析を行うには、パフォーマンス データを BigQuery にエクスポートしてください。

デフォルト属性

Performance Monitoring は、トレースの種類に応じてさまざまなデフォルト属性を自動的に収集します。

これらのデフォルト属性に加えて、カスタムコード トレースでカスタム属性を作成して、アプリ固有のカテゴリ別にデータをセグメント化することもできます。たとえばゲームの場合では、ゲームレベルでデータをセグメント化できます。

Apple アプリと Android アプリのデフォルト属性

Apple アプリと Android アプリのすべてのトレースではデフォルトで次の属性が収集されます。

• アプリのバージョン
• 国
• OS レベル
• デバイス
• 無線通信
• 携帯通信会社

さらに、ネットワーク リクエスト トレースは次の属性も収集します。

• MIME タイプ

ユーザーデータの収集

ユーザーデータの収集: Performance Monitoring は、名前、メールアドレス、電話番号などの個人情報（PII）を一切収集しません。デベロッパーは、カスタムコード トレースにカスタム属性を作成することで、Performance Monitoring を使用して追加のデータを収集できます。Performance Monitoring を通じて収集されるデータに、Google が個人を特定できる情報は含まれません。

個人を特定できる情報を含まないログ メッセージの例を次に示します。

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

次は、個人を特定できる情報を含む例です（アプリではこのようなカスタム属性を使用しないでください）。

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

個人を特定できる情報が公開されるようなデータは、予告なく削除される場合があります。

カスタム属性の作成

計測されたカスタムコード トレースのいずれかにカスタム属性を作成できます。

Performance Monitoring Trace API（Swift | Obj-C）を使用して、カスタムコード トレースにカスタム属性を追加します。

カスタム属性を使用するには、属性を定義するアプリにコードを追加して、特定のカスタムコード トレースに関連付けます。カスタム属性は、トレースの開始から停止までの間の任意の時点に設定できます。

次の点にご注意ください。

• カスタム属性の名前は次の要件を満たす必要があります。

  • 先頭や末尾に空白は使用できず、先頭にアンダースコア（_）も使用できません。
  • スペースは使用できません。
  • 最大長は 32 文字です。
  • 名前に使用できる文字は、A-Z、a-z、_ です。

• 各カスタムコード トレースでは、最大 5 つのカスタム属性を記録できます。

• カスタム属性には、Google が個人を特定できる情報が含まれていないことを確認してください。

  このガイドラインの詳細

  ユーザーデータの収集: Performance Monitoring は、名前、メールアドレス、電話番号などの個人情報（PII）を一切収集しません。デベロッパーは、カスタムコード トレースにカスタム属性を作成することで、Performance Monitoring を使用して追加のデータを収集できます。Performance Monitoring を通じて収集されるデータに、Google が個人を特定できる情報は含まれません。

  個人を特定できる情報を含まないログ メッセージの例を次に示します。

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

  次は、個人を特定できる情報を含む例です（アプリではこのようなカスタム属性を使用しないでください）。

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

  個人を特定できる情報が公開されるようなデータは、予告なく削除される場合があります。

Swift

注: この Firebase プロダクトは、macOS、Mac Catalyst、watchOS の各ターゲットでは使用できません。

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

注: この Firebase プロダクトは、macOS、Mac Catalyst、watchOS の各ターゲットでは使用できません。

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];