> ## 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 で、また title_player_account エンティティ上の UpdatePlayerCustomProperties API を介して、PlayFab プレイヤー カスタム プロパティを作成、変更、削除します。

> [!NOTE]
>
> プレイヤー カスタム プロパティ機能はパブリック プレビュー中です。中核となる機能は整っていますが、フィードバックと使用パターンに基づいて体験を洗練させているところです。

プレイヤー カスタム プロパティの使用を開始するには、ここに記載されているガイドに従ってください。

## Game Manager でのプレイヤー カスタム プロパティの作成、変更、削除

[Game Manager](https://developer.playfab.com) にサインインします。

* **Players** ページに移動し、プレイヤーを選択します。
* **Player Data** タブを選択します。
* **Custom** サブタブを選択します。

![プレイヤー カスタム プロパティへ移動](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/navigate-to-custom-properties.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=3c435e7318840d0aa58d8bdc062371fb)

### 新しいカスタム プロパティを作成する:

* **Add** を選択します。
* **Key** と **Value** フィールドに入力します。
* ドロップダウンからカスタム プロパティの **Type** を選択します。
* 追加したカスタム プロパティの数だけ、下部の **New** ラベルが増えることに注目してください。
* **Save player data** を選択します

![新しいプレイヤー カスタム プロパティを作成する](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/create-new-custom-property.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=78abd82d2114ef5eb5c536832f42180f)

### カスタム プロパティを削除する:

* カスタム プロパティの左側の **Trash can** を選択します。
* 削除したカスタム プロパティの数だけ、下部の **Removed** ラベルが増えることに注目してください。
* **Save player data** を選択します。

![プレイヤー カスタム プロパティを削除する](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/remove-custom-property.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=883b09a703986fb3026f9739fdc22f99)

![プレイヤー カスタム プロパティを削除した結果](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/remove-custom-property-result.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=7bd397fd042746ad73728c12c8427ff8)

カスタム プロパティを変更するには:

* **Key** と **Value** フィールドを選択して、その中の値を変更します。
* 変更したカスタム プロパティの数だけ、下部の **Changed** ラベルが増えることに注目してください。
* **Save player data** を選択します。

![プレイヤー カスタム プロパティを変更する](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/modify-custom-property.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=c5e61d47fe847f6c5a92631e30b0bef8)

![プレイヤー カスタム プロパティを変更した結果](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/modify-custom-property-result.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=7f7b75304a2a06ebe408f695b6c1f807)

## PlayStream ルールを使用したプレイヤーのカスタム プロパティの作成と変更

> [!NOTE]
>
> V1 および V2 PlayStream イベントを使用して、カスタム プロパティを設定または更新できます。

* [Game Manager](https://developer.playfab.com) にサインインします。
* **Automation** ページに移動し、**Rules** タブを選択します。
* ページ右上の **New rule** ボタンを選択します。
* **Name** と **Event** タイプのテキスト ボックスに入力します。V1 イベントは **com.playfab.** または **title.** で始まり、v2 イベントは **playfab.** または **custom.** で始まります。
* 必要に応じて、イベントの内容に基づいてこのルールをトリガーするための **Conditions** を設定します。
* カスタム プロパティを作成するには、**Actions** の下で **Adding custom property** を選択し、フィールドに入力します。
* カスタム プロパティを変更するには、**Actions** の下で **Update player custom properties** を選択します。以下に示すように、このアクションは展開可能なプロパティのリストを受け入れます。
* **Save action** を選択します。

![PlayStream ルールを使用したプレイヤー カスタム プロパティの作成と変更](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/custom-properties-with-playstream-rules.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=2e8e25751465ae49c593b1b512f9f20b)

> [!NOTE]
>
> ルールに選択したイベントが標準イベントの場合は、選択可能なプロパティのリストが表示されます。イベントがカスタム イベントの場合、入力ボックスは自由入力のテキスト フィールドになります。


## Related topics

- [プレイヤー カスタム プロパティ](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [クイックスタート: プレイヤー データ](https://docs.xbox.com/ja-jp/services/playfab/player-progression/player-data/quickstart.md)
- [クイックスタート (Windows) - Party とマルチプレイヤー](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/quickstart-windows-party.md)
- [プレイヤー インベントリのクイックスタート](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [プレイヤー カスタム プロパティによる高度なセグメント化](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)