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

# 実験

> タイトルの A/B 実験、スコアカード、トリートメントの割り当て、除外グループを読み取ります。

`playfab experiment` コマンド ファミリーは試験段階 (Experimental) です。CLI インターフェイスは、フィードバックに基づいて
変更または削除される可能性があります。

タイトルの PlayFab 実験の A/B 実験を読み取ります。これらのコマンドは読み取りのみを行います。実験を作成、
開始、または停止するには、[`playfab api`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/api) でその API を呼び出します。

| コマンド | PlayFab API パス | 説明 |
| - | - | - |
| `playfab experiment list` | `/Experimentation/GetExperiments` | タイトルの実験を一覧表示します。 |
| `playfab experiment scorecard get` | `/Experimentation/GetLatestScorecard` | 実験の最新のスコアカードを取得します。 |
| `playfab experiment treatment get` | `/Experimentation/GetTreatmentAssignment` | エンティティのトリートメントの割り当てを取得します。 |
| `playfab experiment exclusion-group list` | `/Experimentation/GetExclusionGroups` | 除外グループを一覧表示します。 |

| コマンド | オプション |
| - | - |
| `experiment list` | なし。 |
| `experiment scorecard get` | `--experiment-id` (必須)。 |
| `experiment treatment get` | `--entity-id` と `--entity-type` (どちらも必須)。プレイヤーの場合は、マスター プレイヤー アカウント ID ではなく、タイトル プレイヤー アカウント ID を `--entity-type title_player_account` と共に渡します。この ID は、[`playfab player account get`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/player) から `UserInfo.TitleInfo.TitlePlayerAccount.Id` として返されます。 |
| `experiment exclusion-group list` | なし。 |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab experiment list
xbox --playfab-title-id ABC123 playfab experiment scorecard get --experiment-id 11111111-2222-3333-4444-555555555555
xbox --playfab-title-id ABC123 playfab experiment treatment get --entity-id TITLEPLAYER123 --entity-type title_player_account
xbox --playfab-title-id ABC123 playfab experiment exclusion-group list
```

## 表形式の出力

次のコマンドは `--output table` を受け付けます。その他の 2 つのコマンドは受け付けません。
[テーブル出力](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands.md#table-output)を参照してください。

| コマンド | 列 |
| - | - |
| `playfab experiment list` | `ID`、`NAME`、`STATE`、`TYPE` |
| `playfab experiment exclusion-group list` | `GROUP ID`、`NAME`、`DESCRIPTION` |

`STATE` は `New`、`Started`、`Stopped`、または `Deleted` で、`TYPE` は `Active` または
`Snapshot` です。実験のバリアント、セグメント、スケジュールは JSON 出力にのみ含まれます。

```bash theme={null}
xbox --playfab-title-id ABC123 playfab experiment list --output table
```

```text theme={null}
ID                                    NAME            STATE    TYPE
------------------------------------  --------------  -------  --------
11111111-2222-3333-4444-555555555555  weapon-balance  Started  Active
22222222-3333-4444-5555-666666666666  store-layout    New      Snapshot
```


## Related topics

- [実験](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/experiments/index.md)
- [実験の API](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/experiments/experimentation-apis.md)
- [実験の管理](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/experiments/manage-experiments.md)
- [実験の分析](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/experiments/analyze-experiments.md)
- [実験の取得](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/experimentation/experimentation/get-experiments.md)
