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

# 玩家自訂屬性快速入門

> 在 Game Manager 中以及透過 UpdatePlayerCustomProperties API，在 title_player_account 實體上建立、修改和刪除 PlayFab 玩家自訂屬性。

<Note>
  玩家自訂屬性功能目前為公開預覽版。雖然核心功能已就緒，但我們正根據意見反應和使用模式持續改善體驗。
</Note>

若要開始使用玩家自訂屬性，請依照此處的指南操作。

## 在 Game Manager 中建立、修改、刪除玩家自訂屬性

登入 [Game Manager](https://developer.playfab.com)。

* 前往 **Players** 頁面並選取玩家。
* 選取 **Player Data** 索引標籤。
* 選取 **Custom** 子索引標籤。

<img src="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" alt="瀏覽至玩家自訂屬性" width="1248" height="1100" data-path="images/playfab/data-analytics/acting-data/navigate-to-custom-properties.png" />

### 建立新的自訂屬性：

* 選取 **Add**。
* 填寫 **Key** 和 **Value** 欄位。
* 從下拉式清單中選取自訂屬性 **Type**。
* 請注意，底部的 **New** 標籤會依您新增的自訂屬性數目增加。
* 選取 **Save player data**

<img src="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" alt="建立新的玩家自訂屬性" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/create-new-custom-property.png" />

### 移除自訂屬性：

* 選取自訂屬性左側的**垃圾桶**。
* 請注意，底部的 **Removed** 標籤會依您移除的自訂屬性數目增加。
* 選取 **Save player data**。

<img src="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" alt="移除玩家自訂屬性" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/remove-custom-property.png" />

<img src="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" alt="移除玩家自訂屬性的結果" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/remove-custom-property-result.png" />

若要修改自訂屬性：

* 選取 **Key** 和 **Value** 欄位並變更其中的值。
* 請注意，底部的 **Changed** 標籤會依您修改的自訂屬性數目增加。
* 選取 **Save player data**。

<img src="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" alt="修改玩家自訂屬性" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/modify-custom-property.png" />

<img src="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" alt="修改玩家自訂屬性的結果" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/modify-custom-property-result.png" />

## 透過 PlayStream 規則在玩家上建立和修改自訂屬性

<Note>
  V1 和 V2 PlayStream 事件都可用來設定或更新自訂屬性。
</Note>

* 登入 [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**。

<img src="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" alt="使用 PlayStream 規則建立和修改玩家自訂屬性" width="726" height="381" data-path="images/playfab/data-analytics/acting-data/custom-properties-with-playstream-rules.png" />

<Note>
  如果為規則選擇的事件是標準事件，您會有可供選擇的可用屬性清單。如果事件是自訂事件，則輸入方塊會是開放式文字欄位。
</Note>


## Related topics

- [玩家自訂屬性](/zh-TW/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [列出玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/client/player-data-management/list-player-custom-properties.md)
- [刪除玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/client/player-data-management/delete-player-custom-properties.md)
- [取得玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/admin/player-data-management/get-player-custom-property.md)