イベント メトリック

  • [アーティクル]

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

サポートタイムラインと代替手段の詳細については、こちらを参照してください。

イベントは、ユーザーがアプリで実行するアクションです。 アプリでイベントを追跡することで、ユーザーの動作の詳細を学習し、ユーザーとアプリの間の相互作用を理解します。 イベントにプロパティをアタッチすると、イベントに関するコンテキスト情報が提供されます。

アプリ内のイベントを追跡すると、次のような質問に回答できます。

  • 上位 N 個のコンテンツは何を表示しますか?
  • 最も気に入ったコンテンツは何ですか?
  • ユーザーが送信するファイルの種類

アプリでカスタム イベントを追跡するには、App Center Analytics SDK の API を使用 trackEvent します。 SDK を使用してカスタム イベントを定義する方法の詳細については、「App Center SDK Documentation for Android、iOS、React Native、MAUI/Xamarin、Windows、macOS、Unity」を参照してください。

一般情報

イベント ページは 、時間範囲 (過去 1 日、7 日、または 28 日間) と、選択した アプリバージョンでフィルター処理できます。 これらのフィルターを使用すると、選択した期間またはアプリのバージョンにイベント データをドリルダウンできます。

[イベント] ページ

[イベント] ページには、アプリで発生するイベントの概要を示す表が表示されます。 このテーブルは、降順と昇順の両方で count で並べ替えることができます。 テーブル内のイベントは、その名前で検索することもできます。 イベントごとに、次の情報が提供されます。

  • Count: イベントがトリガーされた回数。
  • 傾向: 前の選択した期間と比較した絶対値と割合の変化のカウントの変化。
  • ユーザー: イベントをトリガーしたユーザーの数。
  • ユーザーの変更: 前に選択した期間と比較して、絶対値と割合でのユーザー数の変更。
  • ユーザーあたりのカウント: ユーザーごとにイベントがトリガーされた平均回数。

イベント詳細ビュー

イベント テーブル内のイベントを選択して、より詳細な情報を表示します。

  • ユーザー: イベントをトリガーしたユーザーの合計数。 LAST (n) DAYS は傾向の計算です。
  • Count: イベントがトリガーされた回数の合計。
  • ユーザーあたりのカウント: ユーザーごとにイベントがトリガーされた平均回数。
  • [セッションあたりの数]: セッションごとにイベントがトリガーされる平均回数。

イベント履歴の削除

ページの右上にある設定オプションをクリックし、[イベント履歴の削除] を選択して、[イベントの詳細] ビューから個々のイベントを削除します。 この削除操作は元に戻すことができません。

イベントのプロパティ

イベントのプロパティは、イベントに関するコンテキスト情報を提供します。 これにより、ユーザーがアプリで実行するアクションについてより深く理解できます。

イベントとプロパティの例を次に示します。

  • イベント名: "ファイルのアップロード"、 イベントのプロパティ: ".PDF"、".txt"、".PNG"。
  • イベント名: "質問に回答しました"、 イベントのプロパティ: "Accept"、"Decline"、"Ignore"。

プロパティ値は、型 'String' の値に対して最適化されています。

制限

  • 毎日追跡できる個別のカスタム イベントの最大数は 200 です。 このカウントは午前 12 時 (UTC) にリセットされます。 ただし、デバイスごとに送信されるイベント インスタンスの最大数には制限はありません。
  • イベントごとのイベント プロパティ名または値の最大数は 20 です。 20 を超えるプロパティ名や値が送信されると、最初の 20 個のみが処理され、残りは自動的に削除されます。
  • SDK では、イベント名が最初の 256 文字に切り捨てられます。
  • SDK では、各プロパティ キーと値が最初の 125 文字に切り捨てられます。
  • ポータルには、最大カウントの 10 個のプロパティ値が表示されます。

イベントは、アプリのクラッシュの根本原因を特定するのに役立ちます。 App Center Crashs サービスの一部として、特定のセッションのクラッシュ前に発生したすべてのイベントを確認できます。

クラッシュ前にイベントを表示するには、Analytics SDK をアプリに統合し、1 つ以上のイベントを定義します。

階層リンクは 28 日間保存されますが、クラッシュは無期限に格納される可能性があります。 つまり、28 日を超えるクラッシュを確認している場合、対応する階層リンクは表示されません。

処理されたエラー

App Center で処理されたエラーを追跡するには、その特定の機能を使用することをお勧めします。 このトピックの詳細については、 公式ドキュメントを参照してください。