> ## 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.

# プレイヤー セグメンテーション

> Game Manager で統計、タグ、通貨に基づいて PlayFab プレイヤー セグメントを定義し、プレイヤーがセグメントに入ったときに CloudScript アクションをトリガーします。

プレイヤー セグメンテーションは [Game Manager](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/gamemanager/quickstart.md) で定義されます。セグメントを使用すると、有用または興味深いプレイヤー グループを定義し、そのグループに対して排他的なアクションを実行できます。

## 要件

* PlayFab に定義された、特徴のあるプレイヤーとないプレイヤー。

* 定義された [CloudScript PlayStream フック](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream.md)。

### 例のケース: ゲーム内目標に達したすべてのプレイヤーに対してカスタム CloudScript を実行する

プレイヤーの *定義特性* には、次のようなものが考えられます:

* ログイン時刻
* リンクされたデバイス タイプ
* タグ
* 実世界の場所
* 統計値
* 仮想通貨の値
* 実マネーの購入など

この例では、私たちの特徴的な特性は統計 - 具体的には **50 str** を達成したプレイヤーです。

> [!NOTE]
>
> 統計は多くの可能なオプションの 1 つで、この例に特に必要なだけです。統計要件を、お好みの別のフィルターに自由に置き換えてください。

私たちのアクションは CloudScript 関数の実行です。CloudScript は圧倒的に最も柔軟なトリガー オプションで、セグメント遷移時のプレイヤーとセグメント化情報の完全な制御を提供します。

**Game Manager** 画面から:

* **Title** に移動します。
* 左側のメニューから **Players** を選択します。
* **Segments** タブに移動します。
* **New Segment** を選択します。

以下に示す画面は、上記の **Segment** の例です。

![Game Manager - players - segments - 新しいセグメント](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-new-segment.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=816790fcff260f025fe164429652ba7f)

この例で最も複雑な部分は CloudScript です。[CloudScript ハンドラー](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream.md) の 2 番目のパラメーター、*Context* を使用して、プレイヤーとセグメント遷移を特定します。

その後、[インベントリ アイテム](https://docs.xbox.com/ja-jp/services/playfab/player-progression/player-data/player-inventory.md)、[仮想通貨](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md)、[プレイヤー データ](https://docs.xbox.com/ja-jp/services/playfab/player-progression/player-data/quickstart.md)、[統計](https://docs.xbox.com/ja-jp/services/playfab/community/leaderboards/tournaments-leaderboards/using-player-statistics.md) の付与など、プレイヤーに対して任意のアクションを実行します。

関連項目: [ストア セグメンテーションのベスト プラクティス](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/overview.md)


## Related topics

- [セグメンテーション](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/segmentation-overview.md)
- [PlayFab ライブ サービス管理ドキュメント](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/index.md)
- [Economy (Legacy) のプレイヤー セグメント向けカスタム ストア](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
- [Live Service Management の概要](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/overview.md)
- [player_action_executed](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/Player/player-action-executed.md)
