> ## 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` 命令系列為實驗性功能。其 CLI 介面可能會根據意見反應而變更或移除。

讀取遊戲的 PlayFab Experimentation A/B 實驗。這些命令只會讀取；若要建立、啟動或停止實驗，請使用 [`playfab api`](https://docs.xbox.com/zh-TW/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` (兩者皆為必要)。若是玩家，請搭配 `--entity-type title_player_account` 傳遞其遊戲玩家帳戶 ID，而不是其主要玩家帳戶 ID；[`playfab player account get`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/player) 會以 `UserInfo.TitleInfo.TitlePlayerAccount.Id` 傳回該 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`；另外兩個命令則不接受。請參閱[表格輸出](https://docs.xbox.com/zh-TW/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/zh-TW/services/playfab/live-service-management/game-configuration/experiments/index.md)
- [實驗 API](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/game-configuration/experiments/experimentation-apis.md)
- [管理實驗](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/game-configuration/experiments/manage-experiments.md)
- [分析實驗](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/game-configuration/experiments/analyze-experiments.md)
- [取得實驗](https://docs.xbox.com/zh-TW/services/playfab/api-references/rest/experimentation/experimentation/get-experiments.md)
