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

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

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

<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="Navegar até as propriedades personalizadas do jogador" width="1248" height="1100" data-path="images/playfab/data-analytics/acting-data/navigate-to-custom-properties.png" />

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

<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="Criar novas propriedades personalizadas do jogador" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/create-new-custom-property.png" />

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

<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="Remover propriedades personalizadas do jogador" 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="Resultado da remoção de propriedades personalizadas do jogador" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/remove-custom-property-result.png" />

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

<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="Modificar propriedades personalizadas do jogador" 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="Resultado da modificação de propriedades personalizadas do jogador" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/modify-custom-property-result.png" />

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

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

<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="Criar e modificar propriedades personalizadas do jogador com regras do PlayStream" width="726" height="381" data-path="images/playfab/data-analytics/acting-data/custom-properties-with-playstream-rules.png" />

<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.
</Note>


## Related topics

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