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

# Propriedades personalizadas do jogador

> Visão geral das propriedades personalizadas do jogador do PlayFab: pares chave-valor que armazenam dados de string, numéricos, boolianos ou datetime em entidades title_player_account, com limites.

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

As propriedades personalizadas são pares de dados chave-valor que armazenam informações adicionais sobre os jogadores. O tipo desses pares de dados pode ser string, numérico, booliano ou datetime.

As propriedades personalizadas e seus valores são armazenados com outras informações do jogador, como nome de exibição, estatísticas e marcas.

<Note>
  As propriedades personalizadas só têm suporte em entidades title\_player\_account.
</Note>

## Configurar propriedades personalizadas

As propriedades personalizadas podem ser configuradas de diferentes formas:

* Por meio da ação **UpdatePlayerCustomProperties**, que atualiza as propriedades do jogador.
* Você também pode remover propriedades personalizadas usando a ação **DeletePlayerCustomProperties**.
* E também pode modificar as propriedades de um único jogador pela interface do usuário do Game Manager.

## Limites

Algumas limitações das propriedades personalizadas são:

* Os nomes das propriedades devem ser do tipo string e ter um comprimento máximo de 36 caracteres
* Os nomes das propriedades diferenciam maiúsculas de minúsculas; por exemplo, prop e PROP são nomes diferentes
* Os valores de string têm um comprimento máximo de 36 caracteres
* Os valores numéricos compatíveis são de ponto flutuante duplo (padrão IEEE 754)
* Os valores de string datetime devem usar o formato ISO 8601, e todas as comparações são feitas em relação ao UTC
* Pode haver apenas 5 propriedades personalizadas exclusivas por jogador (não é necessário que cada jogador tenha exatamente os mesmos 5 nomes de propriedade)

## Benefícios

As propriedades personalizadas são poderosas: elas permitem o desenvolvimento sem código que correlaciona vários eventos existentes do PlayStream, o que permite acompanhar o estado entre eventos relacionados ao mesmo jogador.


## Related topics

- [Listar propriedades personalizadas do jogador](/pt-BR/services/playfab/api-references/rest/server/player-data-management/list-player-custom-properties.md)
- [Excluir propriedades personalizadas do jogador](/pt-BR/services/playfab/api-references/rest/server/player-data-management/delete-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)