Trabalhando com entidades
Entidades são o que a plataforma governa. Este guia cobre criá-las, lê-las e entender o que a visão 360 reúne.
Entidades e suas origens
A visão 360. A faixa de abas é o dado conectado descrito abaixo; os atributos exibidos são o registro dourado.
Uma entidade é uma coisa do mundo real. Por trás dela estão os registros de origem que contribuíram, cada um ligado por um crosswalk que registra de qual sistema veio e o identificador dele para ela.
Um crosswalk liga um registro a um sistema de origem. Mapear o valor de código de um sistema para um canônico é outra coisa, chamada transcodificação. Algumas plataformas usam "crosswalk" para essa segunda ideia; esta documentação não.
É isso que torna a linhagem respondível. Para qualquer valor num registro dourado é possível determinar qual sistema o forneceu, e quando.
A visão 360
Ler uma entidade devolve a entidade. Ler sua visão 360 devolve tudo o que está conectado a ela:
| Incluído | O que informa |
|---|---|
| Atributos | Os valores dourados, com suas origens contribuintes |
| Crosswalks | Quais sistemas conhecem esta entidade, e por qual identificador |
| Relacionamentos | Vínculos com outras entidades, nas duas direções |
| Interações | Eventos registrados envolvendo-a |
| Consentimentos | O que ela consentiu, e sob qual base |
| Histórico de consolidação | O que foi absorvido nela, e quando |
| Qualidade de dados | Sua pontuação atual e violações pendentes |
Você pode conhecer a visão 360 como perfil.
Atributos e proveniência
Cada atributo num registro dourado carrega suas origens contribuintes, então você vê não apenas o valor vencedor, mas o que cada sistema disse e por que este venceu.
Quando vários sistemas discordam, a sobrevivência decidiu o resultado — e a visão 360 mostra as entradas a partir das quais a decisão foi tomada.
O mascaramento se aplica em toda parte
O mascaramento de campos é aplicado quando a resposta é gerada, em toda superfície que devolve dados de entidade — ler uma entidade, a visão 360, resultados de busca, telas de comparação, entradas de auditoria.
Como o mascaramento é aplicado na geração da resposta e não por tela, não existe endpoint que devolva o valor sem máscara a quem não tem permissão. Um valor mascarado no console está mascarado na API e na camada de IA também.
Entidades consolidadas
Quando entidades se consolidam, o registro absorvido não desaparece. Ele vira um apelido resolvível: solicitá-lo resolve para o sobrevivente, e a resposta informa isso. Integrações que guardam um identificador antigo seguem funcionando.
Consolidações são reversíveis. Desfazer restaura o registro absorvido com o estado que carregava.
A seguir
Última verificação no commit d3c2586b (2026-08-03)