User Reporting の設定
Customize user reports with fields, metadata, attachments, and metrics to match your game's feedback needs.
読み終わるまでの所要時間 2 分最終更新 8ヶ月前
User Reporting のデフォルト設定は通常の使用には適していますが、プロジェクトが発展するにつれて、特定のニーズに合わせて変更したくなる場合があります。アプリケーションに合った独自の UI をビルドして、カスタムフィールドを導入したり、ユーザーレポートフォームの外観を変更したりできます。パッケージで提供されているサンプルは実用的ですが、出発点として機能します。
ユーザーレポートには、メタデータ、イベント、サンプリングされた指標、スクリーンショット、添付ファイルなどの有用な情報が含まれます。例えば、ユーザーのゲームセーブファイルをユーザーのレポートに添付したり、プレイヤーが特定のアクションを実行するたびにイベントをログに記録したりできます。パフォーマンス重視のゲームプレイの状況において、パフォーマンス指標をサンプリングすることもできます。
レポートに含まれる各種のデータの最大値を設定するには、API を使用します。UserReportExample ファイル (Unity プロジェクトにインポートされたサンプル内にあります) では、レポートにデータを追加するさまざまな方法のデモが提供されています。
例えば、以下の設定をカスタマイズして、レポートに含まれる特定のデータの種類の最大値を制限できます。
- : メジャーとは、指標の収集される各サンプルでカバーされるフレームのセットです。デフォルトのメジャーの長さは 60 フレームです。
FramesPerMeasure - : メジャーとは指標のサンプルでカバーされるフレームのセットであり、レポート内のメジャーの最大数をカウントします。初期値は 300 メジャーです。
MaximumMeasureCount - : この制限は、レポートに含まれるイベントの数に適用されます。初期値は 100 イベントです。
MaximumEventCount - : レポートに添付されるスクリーンショット数の上限。初期値は 10 スクリーンショットです。
MaximumScreenshotCount - : 指標の収集モードを表します。フレーム/秒 (Graphics.FramesPerSecond) などの一部の指標は、デフォルトの設定である Automatic モードを使用してレポートに加えることができます。Manual を使用すると独自のカスタム指標のみがレポートに含まれますが、Disabled を使用するとサンプリングされた指標がレポートにまったく送信されなくなります。
MetricsGatheringMode
これらの設定に制限はありませんが、値を大きく設定するほど、収集されたデータがレポートのサイズに影響します。特に、高解像度の大きいスクリーンショットを使用すると、レポートのサイズがすぐに大きくなる可能性があります。
ユーザーレポートの設定を行うには、 メソッドを以下のように呼び出します。
UserReportingService.Instance..Configure(UserReportingClientConfiguration configuration)var customConfig = new UserReportingClientConfiguration(5, 5, 100, 100, MetricsGatheringMode.Automatic);UserReportingService.Instance.UserReporting.Configure(customConfig);
レポートの作成と送信
レポートを作成するには、 を呼び出します。
UserReportingService.Instance.UserReporting.CreateNewUserReport();レポートを送信するには、 を呼び出します。
UserReportingService.Instance.SendUserReport(Action<float> progressUpdate, Action<bool> result)サンプルの例をよく見て、アクションパラメーターを十分に理解してください。レポートの送信は必須ではありませんが、送信することをお勧めします。
メタデータの追加
ユーザーレポートにデフォルトで含まれるデバイスメタデータと共に表示される、ゲームの特定のデータを収集するには、メタデータを使用します。
カスタムメタデータを追加するには、 メソッドを呼び出します。
UserReportingService.Instance.AddMetadata(string name, string value)メタデータを追加しても、パフォーマンスへの影響はほとんどありません。
イベントのログ記録
カスタムイベントをログに記録するには、 メソッドを呼び出します。
UserReportingService.Instance.LogEvent(UserReportEventLevel level, string message)イベントをログに記録しても、パフォーマンスへの影響はほとんどありません。
サンプリング指標の追加
カスタムサンプリング指標を追加するには、 メソッドを呼び出します。
UserReportingService.Instance.SampleMetric(string name, double value)SampleMetricスクリーンショットの追加
レポートにスクリーンショットを追加するには、 メソッドを呼び出します。スクリーンショットは、ダッシュボードでレポートの一部として表示されます。
UserReportingService.Instance.TakeScreenshot(int maximumWidth, int maximumHeight)オプションで、 を使用してスクリーンショットのソース (Camera や RenderTexture など) を指定できます。
UserReportingService.Instance.TakeScreenshot(int maximumWidth, int maximumHeight, object source)画像は、ソースに関係なく、maximumWidth および maximumHeight パラメーターで定義されたサイズ内に収まるまで縮小されます。
最大幅と最大高さを選択する場合、ユーザーレポートは 10MB 未満である必要があります。最後に撮影されたスクリーンショットが、ダッシュボード内でそのレポートのサムネイルとして使用されます。
ノート: スクリーンショットの撮影はパフォーマンスに影響を与えます。ユーザーへの悪影響を避けるため、スクリーンショットはパフォーマンスが重要でないとき (例えば、プレイヤーがアイドル状態のとき) に撮影するようにしてください。
添付ファイルの追加
動画やシーングラフなどの添付ファイルを追加します。
添付ファイルは Base64 オブジェクトとしてエンコードされます。
添付ファイルを追加するには、 を使用します。
UserReportingService.Instance.AddAttachmentToReport(string title, string filename, byte[] data)レポートのディメンションの編成
Unity Dashboard でユーザーレポートをフィルター処理するには、ディメンションを使用します。ディメンションプロパティに項目を追加することで、レポートを送信する前にディメンションと指標をレポートに追加できます。ディメンションや指標には、それぞれ名前と値があります。以下を呼び出すことで、レポートに新しいディメンションを追加できます。
UserReportingService.Instance.AddDimensionValue(string dimension, string value);例えば、以下のディメンションを持つ 3 つのレポートがあるとします。
名前 | 値 |
|---|---|
| Platform (プラットフォーム) | Android |
| Version (バージョン) | 2 |
| Category (カテゴリ) | Graphics (グラフィックス) |
| Platform (プラットフォーム) | WindowsPlayer |
| Version (バージョン) | 1 |
| Language (言語) | English (英語) |
| Platform (プラットフォーム) | WindowsPlayer |
| Version (バージョン) | 1 |
| Platform.Version | WindowsPlayer.1 |
ダッシュボードには以下のフィルタリングオプションが表示されます。
ディメンション名 | ディメンション値 |
|---|---|
| Category (カテゴリ) | Graphics (グラフィックス) |
| Language (言語) | English (英語) |
| Platform (プラットフォーム) | Android |
| Platform (プラットフォーム) | WindowsPlayer |
| Platform.Version | WindowsPlayer: 1 |
| Version (バージョン) | 1 |
| Version (バージョン) | 2 |
レポートごとに異なるディメンションを追加することもできます。例えば、ローカライズされたレポートにのみ SystemLanguage をディメンションとして追加したい場合があります。
また、ユーザーはレポートのサマリーに 1 つのハッシュタグを追加できます。このハッシュタグはディメンションとして表示されます。
例えば、サマリー "I fell through the floor #FloorBug" は以下のように表示されます。
ディメンション名 | ディメンション値 |
|---|---|
| ハッシュタグ | FloorBug |