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

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 文字です
  • 名前に使用できる文字は、 AZ 、 az 、および_です。

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

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

  このガイドラインの詳細

  ユーザー データの収集: Performance Monitoring 自体は、名前、電子メール アドレス、電話番号などの個人を特定できる情報 (PII) を収集しません。開発者は、カスタム コード トレースにカスタム属性を作成することにより、Performance Monitoring を使用して追加のデータを収集できます。 Performance Monitoring を通じて収集されたこのようなデータには、Google が個人を特定できる情報が含まれていてはなりません。

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

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

  個人を特定できる情報を含む例を次に示します(アプリでこのタイプのカスタム属性を使用しないでください)。

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

  個人を特定できる情報を公開するデータは、予告なしに削除されることがあります。

迅速

注:この 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];