> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# タイトルからのレピュテーション フィードバックの送信

> タイトルが XBOX Live Reputation サービスにプレイヤー フィードバックを送信する方法 (フィードバックの種類、API 呼び出し、レポートのベスト プラクティスを含む) について説明します。

<a id="top" />

このトピックでは、プレイヤーのフィードバックを Reputation サービスに送信することで、ポジティブなプレイヤー エクスペリエンスを促進する方法について説明します。

XBOX Live メンバーの大部分はうまく一緒にプレイしますが、他のメンバーのゲーム体験を損なう問題のあるメンバーが少数存在します。
私たちは、プレイヤーやタイトルからのフィードバックを通じて、これらの問題のあるメンバーを特定します。
また、これらのメンバーが倫理的なプレイヤーのゲームに干渉できないよう、限定的なマルチプレイヤー エクスペリエンスに制限することで、他の XBOX Live ゲーマー人口を保護します。

XBOX Live はシステムの正確性を保つために、プレイヤーが他のプレイヤーをレポートすることに大きく依存しています。しかし、タイトルはレポートに直接参加することができ、プレイヤー レピュテーション人口の正確性を大幅に向上させるのに役立ちます。

このトピックでは、以下について説明します。

* [タイトルまたはタイトル サービスからフィードバックを送信する手順](#stsfftots)
* [Partner フィードバック使用シナリオの例](#epfus)
* [動作フィードバック オプションの一覧](#cbfo)
* [フィードバック API 呼び出し](#fac)
* [Feedback オブジェクト](#fo)
* [フィードバック Q\&A](#fqaa)

<a id="stsfftots" />

## タイトルまたはタイトル サービスからフィードバックを送信する手順

1. フィードバック モーメント (違反時間を伝達) をタイトルまたはタイトル サービスに追加します。
2. 正しいフィードバックの種類を判断します。
3. フィードバックとともに Reputation Feedback API を呼び出します。

### フィードバック モーメントをタイトルまたはタイトル サービスに追加する

プレイヤーは、自分側のチームを妨害するチームメイト、積極的にプレイせずに何もしないプレイヤー、ゲームを台無しにするチーターとの間で悪い経験をする可能性があります。
XBOX Live では、プレイヤーが直接これらの問題のあるプレイヤーをレポートできます。しかし、ユーザー フィードバックは完璧ではありません。

タイトルは、プレイヤーがゲーム内でアイドル状態のままだったり早期に離脱したりするような単純なことを簡単に判定できます。タイトルは、プレイヤーがチートしているかどうかを判定できる場合もあります。
タイトルは、さまざまなフィードバック モーメントでフィードバックを送信することができ、これはすべての倫理的なプレイヤーのエクスペリエンス改善に役立ちます。

### 正しいフィードバックの種類を判断する

Reputation サービスには、プレイヤーがフィードバックを受けるに値するさまざまな方法を捉えるための多くのフィードバック種類があります。
詳細については、以下の表を参照してください。
フィードバック種類のほとんどは否定的なものですが、肯定的なフィードバックによってプレイヤーのレピュテーションを向上させることもできます。

XBOX システム UI は、プレイヤーがゲーム内で他のプレイヤーに関するフィードバックを送信する方法を提供します。
このプレイヤー間のフィードバックはあまり重視されません。というのも、負けたときに互いに嫌がらせをする傾向があるプレイヤーもいるためです。

タイトルは、このシステム UI を補完し、プレイヤーが他のプレイヤーに関するフィードバックを直接送信するための UI を提供できます。私たちは、信頼度が高いため、Partner フィードバックを使用してタイトル自身に代わってフィードバックを送信することを推奨します。

[このトピックの先頭へ戻る。](#top)

<a id="epfus" />

## Partner フィードバック使用シナリオの例

### プレイヤーが試合の途中でゲームを離脱する

プレイヤーがゲームで負けており、ゲームのメニューを使ってゲームを離脱し、チームメイトを見捨てます。
タイトルがこの動作を検出すると、`FairPlayQuitter` を使ってその動作をレポートできます。

### ゲーム内でマッチが見つかった後のアイドル

プレイヤーが他のプレイヤーと一緒にプレイするようマッチメイキングされますが、チームを助ける代わりに常にゲーム内でアイドル状態のままです。
タイトルは `FairPlayIdler` を使用してそのプレイヤーの動作をレポートできます。

### ゲーム内でチームメイトを殺害する

ゲーム内のプレイヤーが遊びでチームメイトを絶え間なく殺害しています。
タイトルがプレイヤーが常にチームキルしていることを検出した場合、`FairPlayKillsTeammates` を使ってそのプレイヤーをレポートできます。

### タイトルにコミュニティ キック / 投票機能がある

プレイヤーが悪い行為のためにラウンド内のプレイヤーによってセッションから削除するよう投票されました。
タイトルがこのプレイヤーをセッションから削除する場合、`FairPlayKicked` を使ってレポートできます。

### 役立つプレイヤーのコミュニティ投票

ゲームの数ラウンド後、タイトルはチームを最も助けたプレイヤーを選ぶオプションを提供します。
タイトルがこのアクションを検出すると、`PositiveHelpfulPlayer` を使って動作をレポートできます。

### 高品質のユーザー生成コンテンツ (UGC)

タイトルには、プレイヤーが車両の最良のデザインを選択できるシーンがあります。
タイトルがこのアクションを検出すると、`PositiveHighQualityUGC` を使って動作をレポートできます。

### 熟練したプレイヤー

ゲームの数ラウンド後、タイトルは MVP (最優秀プレイヤー) を選ぶオプションを提供します。
タイトルが、あるプレイヤーが常に MVP ステータスを獲得していることを検出すると、`PositiveSkilledPlayer` を使って動作をレポートできます。

### プレイヤーがタイトル内の疑わしい UGC をレポートする

タイトルには、プレイヤーが車両デザインを見ることができるシーンがあります。
プレイヤーが攻撃的なデザインに気付き、レポートしたいと考えます。
タイトルがこのアクションを検出すると、`UserContentInappropriateUGC` を使って違反者をレポートできます。

### タイトルがプレイヤーの XBOX Live BAN 審査をリクエストしたい

タイトルのコミュニティ マネージャーが、そのゲームで常に問題を起こしているレピュテーションの低いプレイヤーに気付きました。
タイトルは `FairPlayUserBanRequest` を使って、XBOX Family, Trust, and Safety (XFTS) の審査をリクエストできます。

[このトピックの先頭へ戻る。](#top)

<a id="cbfo" />

## 動作フィードバック オプションの一覧

以下の表は、タイトルに代わってプレイヤー フィードバックを送信するためのフィードバック種類を示しています。

Reputation サービスは柔軟であり、以下の種類がタイトルのニーズを満たさないと思われる場合、新しいフィードバック種類を簡単に追加できます。
新しいフィードバック種類を追加するには、アカウント マネージャーに連絡してください。

| **フェア プレイ フィードバック種類**                | **説明**                                                                           |
| ------------------------------------ | -------------------------------------------------------------------------------- |
| `FairPlayKillsTeammates`             | 意図的に自分のチームメイトを殺害しているプレイヤーをレポートします。                                               |
| `FairPlayCheater`                    | 確実にチートしているプレイヤーをレポートします。                                                         |
| `FairPlayTampering`                  | 確実にゲーム ディスクを改ざんしたか、ゲームのソフトウェアやハードウェアを改ざんしたプレイヤーをレポートします。                         |
| `FairPlayUserBanRequest`             | 停止処分に値すると思われるプレイヤーをレポートします。                                                      |
| `FairPlayConsoleBanRequest`          | XBOX Live への接続を BAN すべきと思われるコンソールをレポートします。                                       |
| `FairPlayUnsporting`                 | 確実にスポーツマンシップに反する行為を行っているプレイヤーをレポートします。                                           |
| `FairPlayIdler`                      | マルチプレイヤー マッチに参加するが、積極的にプレイしないプレイヤーをレポートします。                                      |
| `FairPlayLeaderboardCheater`         | 確実にチートしてリーダーボードの上位に表示されているプレイヤーをレポートします。                                         |
| **コミュニケーション フィードバック種類**              | **説明**                                                                           |
| `CommsInappropriateVideo`            | ビデオ チャットで不適切な行為をしているプレイヤーをレポートします。                                               |
| **UGC フィードバック種類**                    | **説明**                                                                           |
| `UserContentInappropriateUGC`        | プレイヤーがタイトル内で作成した不適切なコンテンツをレポートします。                                               |
| `UserContentReviewRequest`           | XFTS が審査できるよう、コンテンツを事前にレポートします。                                                  |
| `UserContentReviewRequestBroadcast`  | XFTS が審査できるよう、ブロードキャストを事前にレポートします。                                               |
| `UserContentReviewRequestGameDVR`    | XFTS が審査できるよう、Game DVR クリップを事前にレポートします。                                          |
| `UserContentReviewRequestScreenshot` | XFTS が審査できるよう、スクリーンショットを事前にレポートします。                                              |
| **ポジティブ フィードバック種類**                  | **説明**                                                                           |
| `PositiveSkilledPlayer`              | プレイヤーが投票して MVP を決定できる場合、そのプレイヤーがポジティブなフィードバックに値することを確信しているときに、熟練したプレイヤーをレポートします。 |
| `PositiveHelpfulPlayer`              | ゲームがプレイヤーに、他のプレイヤーが役立ったことをレポートする UI を提供している場合、役立つプレイヤーをレポートします。                  |
| `PositiveHighQualityUGC`             | ゲームがプレイヤーに、他のプレイヤーのコンテンツを称賛する UI を提供している場合、そのコンテンツをポジティブにレポートします。                |

[このトピックの先頭へ戻る。](#top)

<a id="fac" />

## フィードバック API 呼び出し

タイトルは、Reputation サービスを呼び出すために 2 つの戦略を使用できます。

* パートナー サービスから、認証にサービス トークンを使用してプレイヤーをまとめてレポートします (推奨)。
* クライアントから直接プレイヤーをレポートします。

クライアント API には不正防止テクノロジが組み込まれています。有効と見なされるには、プレイヤーに対する複数のレポートが必要です。

両方の API はバッチ処理され、複数のプレイヤーを同時にレポートできます。

タイトルは以下の XBOX Live API を使用して、プレイヤーのレピュテーション フィードバックを送信できます。

| 言語  | API                                                                                |
| --- | ---------------------------------------------------------------------------------- |
| C   | `XblSocialSubmitBatchReputationFeedbackAsync`                                      |
| C++ | `xbox::services::social::reputation_service.submit_batch_reputation_feedback(...)` |

あるいは、タイトルは以下の直接的な REST メソッドを使用できます。

| API           | URL                                                        | 認証要件                            |
| ------------- | ---------------------------------------------------------- | ------------------------------- |
| サービス `POST`   | `https://reputation.xboxlive.com/users/batchfeedback`      | パートナーおよびサンドボックスの要求を持つ `S-token` |
| クライアント `POST` | `https://reputation.xboxlive.com/users/batchtitlefeedback` | タイトルおよびサンドボックスの要求を持つ `Xtoken`   |

[このトピックの先頭へ戻る。](#top)

<a id="fo" />

## Feedback オブジェクト

`Feedback` オブジェクトは、最新バージョン (101) では以下の仕様を持ちます。
両方の API は、以下のオブジェクトのバッチを想定しています。

| メンバー           | 型      | 説明                                                                               |
| -------------- | ------ | -------------------------------------------------------------------------------- |
| `sessionRef`   | Object | このフィードバックが関連する Multiplayer Session Directory (MPSD) セッションを記述するオブジェクト、または `null`。 |
| `feedbackType` | String | フィードバックの種類。可能な値は `ReputationFeedbackType` 列挙型で定義されています。                          |
| `textReason`   | String | 送信者がフィードバック送信の理由を説明するために追加したプレイヤー提供のテキスト。このテキストは XFTS にとって非常に価値があります。            |
| `evidenceId`   | String | 送信されるフィードバックの証拠として使用できるリソースの ID。たとえば、ゲームプレイ中に録画された動画ファイルやアクティビティ フィード アイテムなどです。  |
| `titleID`      | String | プレイされたタイトルのタイトル ID。この ID は、トークンに存在しない場合にのみ必要です。                                  |
| `targetXuid`   | String | レポートするプレイヤーの XUID。                                                               |

以下のサンプル コードは、`FairPlayKillsTeammates` の使用を示しています。

```json theme={null}
POST https://reputation.xboxlive.com/users/batchtitlefeedback
{
    "items" :
    [
        {
            "targetXuid": "33445566778899",
            "titleId" : null,
            "sessionRef": {
  "scid": "372D829B-FA8E-471F-B696-07B61F09EC20",
  "templateName": "CaptureFlag5",
  "name": "Title56932",
           },
            "feedbackType": "FairPlayKillsTeammates",
            "textReason": "Title detected this player killing team members 19 times",
            "evidenceId": null
        }
    ]
}
```

[このトピックの先頭へ戻る。](#top)

<a id="fqaa" />

## フィードバック Q\&A

### Q: プレイヤー レポートを見る担当者を助けるために、システムにヒントを送信できますか?

**A:** はい。これらのヒントは非常に役立ちます。XFTS を助けるために `textReason` パラメーターを使用してください。XFTS は送信されたフィードバックを確認します。たとえば、アイドラーの場合、「ゲームの最初の 5 秒後、このプレイヤーからのユーザー入力を受信しませんでした」というテキスト理由を追加できます。

このテキスト理由は XFTS にとって価値があります。テキスト理由が役立つ、説明的なものであることを確認してください。

### Q: プレイヤーに関するフィードバックの送信頻度を考慮すべきですか?

**A:** いいえ。プレイヤーがフィードバックを受けるに値することが確信できたときに、タイトルは Reputation サービスを呼び出す必要があります。
サービスには、タイトルやプレイヤーが他のプレイヤーに過度に影響を与えることを防ぐ複数の安全システムがあります。

### Q: 送信されるフィードバックの重みを調整できますか?

**A:** いいえ。Reputation サービスがフィードバックの重みを決定します。
私たちは、より公平なスコアリングのために常に重みを調整しています。

### Q: プレイヤーについて送信したフィードバックを取り消すことはできますか?

**A:** いいえ。フィードバックは最終的なものです。
タイトルにバグがあり、誤ったフィードバックを送信していると思われる場合はお知らせください。バグを修正するまで、タイトルをブロックします。

### Q: プレイヤーから送信された自分のタイトルに関するフィードバックを見ることはできますか?

**A:** はい。現時点では、この情報を自分で表示することはできません。
フィードバックを確認するには、アカウント マネージャーに連絡してください。タイトルごとの共有可能なデータがあります。

### Q: コンソールまたはプレイヤー BAN 審査リクエストを送信した場合、何が起こったかどうすればわかりますか?

**A:** 現時点では、審査の情報は XFTS に送信されますが、BAN 審査に関する更新は受け取れません。

### Q: タイトルごとのレピュテーション スコアはありますか?

**A:** いいえ。
現時点では、フェア プレイ、コミュニケーション、UGC 用のレピュテーション サブスコアはありますが、タイトルごとではありません。

[このトピックの先頭へ戻る。](#top)


## Related topics

- [レピュテーションの概要](/ja-jp/services/xbox-services/community/reputation/live-reputation-overview.md)
- [レピュテーションの概念](/ja-jp/services/xbox-services/community/reputation/concepts/live-reputation-concepts-nav.md)
- [レピュテーション フィードバックの送信](/ja-jp/services/xbox-services/community/reputation/how-to/live-submitting-reputation-feedback.md)
- [レピュテーションのサンプル コード](/ja-jp/services/xbox-services/community/reputation/how-to/live-reputation-howto-nav.md)
- [概念](/ja-jp/services/xbox-services/community/reputation/concepts/index.md)
