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

# Início rápido das propriedades personalizadas do jogador

> Crie, modifique e exclua propriedades personalizadas do jogador do PlayFab no Game Manager e por meio da API UpdatePlayerCustomProperties em entidades title_player_account.

> [!NOTE]
>
> O recurso de propriedades personalizadas do jogador está em versão prévia pública. Embora a funcionalidade principal esteja implementada, estamos refinando a experiência com base em feedback e padrões de uso.

Para começar a usar as propriedades personalizadas do jogador, siga os guias aqui.

## Criar, modificar e excluir propriedades personalizadas do jogador no Game Manager

Entre no [Game Manager](https://developer.playfab.com).

* Acesse a página **Players** e selecione um jogador.
* Selecione a guia **Player Data**.
* Selecione a subguia **Custom**.

![Navegar até as propriedades personalizadas do jogador](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)

### Criar uma nova propriedade personalizada:

* Selecione **Add**.
* Preencha os campos **Key** e **Value**.
* Selecione o **Type** da propriedade personalizada na lista suspensa.
* Observe que o rótulo **New** na parte inferior aumenta de acordo com o número de propriedades personalizadas que você adiciona.
* Selecione **Save player data**

![Criar novas propriedades personalizadas do jogador](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)

### Remover uma propriedade personalizada:

* Selecione a **lixeira** no lado esquerdo da propriedade personalizada.
* Observe que o rótulo **Removed** na parte inferior aumenta de acordo com o número de propriedades personalizadas que você remove.
* Selecione **Save player data**.

![Remover propriedades personalizadas do jogador](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)

![Resultado da remoção de propriedades personalizadas do jogador](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)

Para modificar uma propriedade personalizada:

* Selecione os campos **Key** e **Value** e altere os valores neles.
* Observe que o rótulo **Changed** na parte inferior aumenta de acordo com o número de propriedades personalizadas que você modifica.
* Selecione **Save player data**.

![Modificar propriedades personalizadas do jogador](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)

![Resultado da modificação de propriedades personalizadas do jogador](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)

## Criar e modificar propriedades personalizadas em um jogador por meio de regras do PlayStream

> [!NOTE]
>
> Eventos do PlayStream V1 e V2 podem ser usados para definir ou atualizar propriedades personalizadas.

* Entre no [Game Manager](https://developer.playfab.com).
* Acesse a página **Automation** e selecione a guia **Rules**.
* Selecione o botão **New rule** no canto superior direito da página.
* Preencha as caixas de texto **Name** e **Event** type. Os eventos V1 têm o prefixo **com.playfab.** ou **title.**, enquanto os eventos V2 têm o prefixo **playfab.** ou **custom.**
* Se desejar, defina **Conditions** para disparar essa regra com base no conteúdo do evento.
* Para criar uma propriedade personalizada, em **Actions**, selecione **Adding custom property** e preencha os campos.
* Para modificar uma propriedade personalizada, em **Actions**, selecione **Update player custom properties**. A ação aceita uma lista expansível de propriedades, conforme mostrado abaixo.
* Selecione **Save action**.

![Criar e modificar propriedades personalizadas do jogador com regras do 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]
>
> Se o evento escolhido para a regra for um evento padrão, você terá uma lista de propriedades disponíveis para escolher. Se o evento for personalizado, a caixa de entrada será um campo de texto livre.


## Related topics

- [Propriedades personalizadas do jogador](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [Início rápido do inventário do jogador](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [Início rápido de dados do jogador](https://docs.xbox.com/pt-BR/services/playfab/player-progression/player-data/quickstart.md)
- [Listar propriedades personalizadas do jogador](https://docs.xbox.com/pt-BR/services/playfab/api-references/rest/server/player-data-management/list-player-custom-properties.md)
- [Obter propriedade personalizada do jogador](https://docs.xbox.com/pt-BR/services/playfab/api-references/rest/admin/player-data-management/get-player-custom-property.md)
