Verificações de integridade de esquemas e identidades
As verificações de integridade de esquemas e identidades verificam os esquemas e namespaces de identidade em busca de práticas recomendadas e configurações incompletas que resultam em resolução de identidade incompleta, contagens de perfis aumentadas e ativação imprecisa.
Validação do campo de identidade identity-field-validation
Verificações para garantir que os campos de identidade tenham restrições de comprimento mínimo e máximo e regras de padrão regex para integridade dos dados.
Ao selecionar o cartão Validação do campo de identidade, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: verifica se os campos de identidade têm comprimentos mín/máx e regras de padrão regex para integridade de dados. Lista esquemas e campos afetados.
- Impacto: se os campos de identidade nos esquemas não tiverem tamanhos mínimos/máximos e validações de padrão definidas, isso poderá levar a dados inconsistentes, o que pode comprometer a integridade e a qualidade dos dados.
- Áreas gerais de impacto: identificadores de baixa qualidade em Identity Service; compilação não confiável.
- Documentação do Experience League: um link para as práticas recomendadas de modelagem de dados.
- Esquemas afetados: uma lista de esquemas afetados, cada um com um expansor para exibir mais detalhes e um link para abrir o esquema.
Para obter mais informações, consulte as dicas de integridade de dados na documentação de práticas recomendadas do esquema.
Regras de vinculação do gráfico de identidade identity-graph-linking-rules
Verifica se as regras de vinculação do gráfico de identidade estão configuradas para uma sandbox para impedir perfis recolhidos.
Ao selecionar o cartão Regras de vinculação do gráfico de identidade, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: verifica se as regras de vinculação apropriadas estão configuradas para impedir perfis recolhidos. Ele mostra o status atual da regra e identidades exclusivas por gráfico.
- Impacto: se as regras de vinculação do gráfico de identidade não estiverem definidas, determinados dados poderão tentar mesclar vários perfis diferentes em um único perfil. Para evitar mesclagens indesejadas, as configurações fornecidas por meio das regras de vinculação do gráfico de identidade devem ser usadas.
- Áreas gerais de impacto: perfis recolhidos ou mesclados.
- Documentação do Experience League: um link para a visão geral das Regras de vinculação do gráfico de identidade para obter mais informações.
- Configurar regras de vinculação: quando a verificação falha, um botão é exibido para que você possa configurar regras de vinculação diretamente do painel.
Para obter mais informações, consulte a visão geral das regras de vinculação do gráfico de identidade e o guia de implementação.
Configuração de identidade de pessoas e não pessoas people-non-people-identity
Valida o uso correto de tipos de identidade de pessoas e não pessoas em classes de esquema.
Ao selecionar o cartão Configuração de identidade de pessoas e não pessoas, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: valida o uso correto de tipos de identidade em classes de esquema. Lista esquemas configurados incorretamente e destaca atribuições incorretas.
- Impacto: se uma entidade que não seja de pessoas receber uma identidade de pessoa, isso aumentará a contagem de perfis e tornará esses dados inelegíveis como uma pesquisa. Se uma entidade de pessoa receber uma identidade que não seja de pessoas, os dados não estarão disponíveis para transmissão ou segmentação de borda.
- Áreas gerais de impacto: gráficos de identidade incompletos; contagens de perfis aumentadas; pesquisa de uso incorreto.
- Esquemas afetados: uma lista de esquemas com problemas. Expanda uma linha de esquema para ver o caminho, o nome da identidade e o tipo de esquema para cada erro de configuração. Use o ícone de link para abrir o esquema.
Para obter mais informações, consulte a documentação do tipo de identidade e as práticas recomendadas do esquema.
Descrição do namespace de identidade personalizado namespace-missing-description
Verificações para garantir que os metadados e as descrições do namespace de identidade personalizado estejam completos.
Ao selecionar o cartão Descrição de namespace de identidade personalizado, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: verifica se os metadados e as descrições do namespace foram concluídos. Exibe namespaces e proprietários com campos de descrição vazios.
- Impacto: definir uma descrição em um namespace de identidade personalizado aumenta a clareza, fornecendo o contexto da finalidade de cada namespace. Isso ajuda os membros da equipe e as partes interessadas a entender rapidamente a função de cada namespace sem confusão.
- Áreas gerais de impacto: depuração ou confusão de uso; intenção de validação não clara.
- Documentação do Experience League: um link para Criar Namespaces Personalizados para obter mais informações.
- Namespaces afetados: uma lista de namespaces de identidade personalizados que não têm descrições. Use o ícone de link ao lado de cada namespace para exibi-lo ou editá-lo.
Para obter mais informações, consulte a documentação em criando namespaces personalizados.
O namespace de identidade não está em uso namespace-not-in-use
Detecta namespaces de identidade obsoletos ou não utilizados que devem ser marcados para limpeza. Essa verificação foi documentada anteriormente como “Namespace de identidade obsoleto”.
Ao selecionar o cartão Namespace de identidade não em uso, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: detecta namespaces de identidade obsoletos ou não utilizados para limpeza. Lista os namespaces não utilizados com o último carimbo de data e hora de uso ou referência de esquema.
- Impacto: namespaces de identidade não usados em nenhum esquema devem ser marcados para remoção adicionando uma marca “DEPRECATED” ou “DO NOT USE” a seus nomes. No momento, não há suporte para a exclusão de namespaces de identidade.
- Áreas gerais de impacto: risco de confusão e erro de rotulagem.
- Documentação do Experience League: um link para Namespaces de Identidade Obsoletos para documentação adicional.
- Namespaces afetados: uma lista de namespaces de identidade obsoletos ou não utilizados. Use o ícone de link ao lado de cada namespace para exibi-lo ou gerenciá-lo.
Para obter mais informações, consulte o artigo da base de conhecimento da Experience Cloud sobre namespaces obsoletos.
Identidade não pessoal no campo de relacionamento non-person-identity-relationship-field
Sinaliza campos de esquema que contêm um descritor de identidade e um descritor de relacionamento ao mesmo tempo.
Ao selecionar o cartão Identidade não pessoal no campo de relacionamento, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que colocar um descritor de relacionamento em um campo de esquema estabelece uma associação direta e dinâmica entre dois esquemas separados. Ele informa ao Real-Time Customer Profile armazenamento e ao Construtor de público-alvo que um campo no esquema primário ou de origem atua como uma chave estrangeira apontando para uma pesquisa ou registro de dimensão no esquema de destino. Esta verificação inspeciona os campos de esquema que contêm um descritor de identidade e um descritor de relacionamento para o mesmo campo.
- Impacto: esses descritores são mutuamente exclusivos e a inclusão de ambos no mesmo campo é um erro de modelagem de dados. Os resultados podem incluir segmentação incorreta e ativações de público.
- Áreas gerais de impacto: Qualidade do público-alvo.
- Documentação do Experience League: um link para a composição do esquema XDM para a identidade.
- Esquemas afetados: uma lista de esquemas com campos que têm descritores conflitantes, quando aplicável. Quando nenhum problema for detectado, o painel exibirá uma confirmação Verificação aprovada.
Para obter mais informações, consulte a documentação sobre a composição do esquema.
Contagem de relacionamentos de várias entidades multi-entity-relationship-count
Monitora o número de relacionamentos de várias entidades definidos em uma sandbox à medida que se aproximam do limite da plataforma.
Ao selecionar o cartão Contagem de Relacionamento de Várias Entidades, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que os relacionamentos de várias entidades vinculam entidades primárias, como Real-Time Customer Profiles ou ExperienceEvents, a entidades de dimensão secundárias, como catálogos de produtos, locais de loja ou contas comerciais. Essa verificação inspeciona se o limite de 5 relacionamentos de várias entidades definido na sandbox é excedido.
- Impacto: alta cardinalidade e excesso de junções de esquema aumentam a complexidade computacional no repositório Real-Time Customer Profile. Exceder o limite pode prejudicar o desempenho do Serviço de segmentação e aumentar a latência de avaliação do público-alvo.
- Áreas gerais de impacto: segmentação em lote.
- Documentação do Experience League: um link para as práticas recomendadas de modelagem de dados.
Para obter mais informações, consulte as práticas recomendadas de modelagem de dados e o tutorial de segmentação de várias entidades.
Grupo de campos de auditoria ausente missing-audit-field-group
Verifica se os esquemas do Perfil individual XDM incluem o grupo de campos Detalhes de auditoria do sistema Source externo.
Ao selecionar o cartão Grupo de campos de auditoria ausente, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: verifica se os esquemas de Perfil Individual XDM incluem o grupo de campos Detalhes de Auditoria do Sistema Source Externo, que é necessário para rastrear a origem do registro e atualizar carimbos de data/hora.
- Impacto: sem campos de auditoria, não há visibilidade em nível de registro sobre quando os dados foram assimilados em Experience Platform, o que dificulta a solução de problemas de registros obsoletos ou duplicados.
- Áreas gerais de impacto: incapacidade de auditar alterações de dados externos.
- Documentação do Experience League: um link para o grupo de campos Detalhes de auditoria do sistema Source externo.
- Recomendação: quando ausente, adicione o grupo de campos Detalhes de Auditoria do Sistema Source Externo.
- Esquemas afetados: uma lista de esquemas com o grupo de campos ausente. Use o ícone de link ao lado de cada esquema para abri-lo.
Para obter mais informações, consulte a documentação do grupo de campos Detalhes de Auditoria do Sistema Source Externo.
Exclusividade de identidade principal primary-identity-uniqueness
Compara como os namespaces de identidade são usados como identidades primárias com a forma como são definidos nas regras de vinculação do gráfico de identidade.
Ao selecionar o cartão Exclusividade de identidade principal, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que as identidades primárias orientam o assembly de Real-Time Customer Profiles. As regras de vinculação definem quais namespaces de identidade devem e não devem ter permissão para aparecer mais de uma vez no mesmo gráfico de identidade. Essa verificação compara como os namespaces de identidade são usados como identidades primárias com a forma como são definidos nas regras de vinculação do gráfico de identidade.
- Impacto: o armazenamento de registros da classe Profile com valores escalares simples usando uma identidade de perfil não exclusiva resulta na ignorância de todos os registros, exceto um, no acesso ao perfil. Duas exceções se aplicam: esquemas que contêm apenas arrays mesclados e casos em que o registro desejado é sempre selecionado com base no tempo de assimilação e na política de mesclagem.
- Áreas gerais de impacto: correção de perfil, qualidade do público-alvo e qualidade da ativação.
- Documentação do Experience League: um link para a visão geral das regras de vinculação do gráfico de identidade.
Para obter mais informações, consulte a visão geral das regras de vinculação do gráfico de identidade.
Relacionamentos de vários níveis multi-level-relationships
Detecta relações que estão incorretamente definidas entre esquemas bidimensionais.
Ao selecionar o cartão Relações de vários níveis, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que as relações só devem ser estabelecidas entre esquemas da classe Perfil Individual XDM ou XDM ExperienceEvent e esquemas dimensionais. Esta verificação verifica os relacionamentos definidos incorretamente entre esquemas bidimensionais.
- Impacto: cadeias de relações de vários níveis não têm suporte e causam comportamento imprevisível durante a segmentação.
- Áreas gerais de impacto: Segmentação e qualidade de público.
- Documentação do Experience League: um link para as práticas recomendadas de modelagem de dados.
Para obter mais informações, consulte as práticas recomendadas de modelagem de dados.
Profundidade do campo de identidade principal primary-identity-field-depth
Verifica se os campos de identidade primários não estão aninhados muito profundamente na hierarquia de campos de esquema.
Ao selecionar o cartão Profundidade do campo de identidade principal, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que a profundidade do campo de identidade principal se refere ao local na hierarquia de campos de um esquema XDM em que um campo de identidade principal é colocado, bem como às restrições e práticas recomendadas que regem esse local. Essa verificação verifica se os campos de identidade primários não estão aninhados a mais de quatro níveis de profundidade.
- Impacto: campos de identidade primários aninhados além de quatro níveis podem causar comportamento imprevisível na assimilação e segmentação de dados.
- Áreas gerais de impacto: assimilação de dados, segmentação e qualidade do público-alvo.
- Documentação do Experience League: um link para as práticas recomendadas de modelagem de dados.
Para obter mais informações, consulte as práticas recomendadas de modelagem de dados.
Duplicar grupos de campos em esquemas duplicate-field-groups-across-schemas
Detecta grupos de campos que não são de identidade que permanecem ativos em mais de um esquema.
Ao selecionar o cartão Duplicar grupos de campos em esquemas, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que Experience Platform permite a inclusão de grupos de campos específicos em vários esquemas. Embora esse seja um uso normal ao criar esquemas, não é uma prática de modelagem de dados manter campos individuais de não identidade visíveis em mais de um esquema. Esta verificação inspeciona se algum campo que não seja de identidade é deixado ativo em vários esquemas.
- Impacto: a origem de valores em vários conjuntos de dados para o mesmo campo de esquema pode tornar imprevisíveis os resultados de público-alvo que testam esses campos. As políticas de mesclagem podem minimizar esse problema, mas nunca eliminá-lo completamente, e as variações resultantes geralmente são difíceis de depurar.
- Áreas gerais de impacto: Segmentação e resultados de público.
- Documentação do Experience League: um link para adicionar grupos de campos a um esquema.
- Recomendação: edite esquemas usando o recurso de campos relacionados gerenciados e oculte campos que não sejam de identidade em todos os esquemas, exceto um.
- Grupos de campos afetados: uma lista de grupos de campos compartilhados entre esquemas, com a referência de grupo de campos e o nome do esquema. Use o ícone de link para abrir o esquema.
Para obter mais informações, consulte Adicionar grupos de campos a um esquema.
Grupo de campos de detecção de bot ausente bot-detection-field-group-missing
Verifica se os esquemas ExperienceEvent incluem o grupo de campos Bot Detection Information.
botDetection.isBot usando um sinal de detecção de bot e, em seguida, exclua bots de seus segmentos.Ao selecionar o cartão Grupo de campos de detecção de bot ausente, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que Experience Platform fornece um grupo de campos de Detecção de bot para esquemas XDM ExperienceEvent. Esse grupo de campos permite a sinalização de tráfego não humano, como rastreadores da Web, raspadores e agentes automatizados, no nível do evento. Essa verificação verifica se o grupo de campos foi incluído no esquema ExperienceEvent, conforme necessário.
- Impacto: quando este grupo de campos está ausente dos esquemas ExperienceEvent que capturam dados de interação na Web ou no aplicativo, não há um mecanismo padronizado para identificar eventos gerados por bot a partir de atividades legítimas do cliente.
- Áreas gerais de impacto: segmentação de público e taxa de transferência de desempenho de avaliação de público de streaming.
- Documentação do Experience League: um link para o grupo de campos Informações de detecção de bot.
- Recomendação: adicione o grupo de campos Informações de detecção de bot a cada esquema ExperienceEvent sinalizado. Preencha o campo
botDetection.isBotusando um sinal de detecção de bot e, em seguida, exclua bots de seus segmentos.
Para obter mais informações, consulte a documentação do grupo de campos Informações sobre a detecção de bot.
Cadeias de caracteres de comprimento zero permitidas zero-length-strings-allowed
Verifica se os campos de sequência exigem um comprimento mínimo de um caractere.
Ao selecionar o cartão Cadeias de caracteres de comprimento zero permitidas, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que Experience Platform permite valores nulos e valores de sequência de caracteres de comprimento zero durante a assimilação de dados por padrão. A prática recomendada é não permitir valores de sequência de caracteres de comprimento zero, atribuindo um comprimento mínimo de um em todos os campos de sequência. Esta verificação inspeciona esquemas que não têm essa configuração de comprimento mínimo.
- Impacto: quando os campos da cadeia de caracteres não têm uma restrição de comprimento mínimo, cadeias de caracteres de comprimento zero podem ser assimiladas, o que complica o uso desses dados durante definições de público-alvo, criação de SQL, Adobe Journey Optimizer regras e outras funcionalidades.
- Áreas gerais de impacto: Qualidade do público-alvo.
- Documentação do Experience League: um link para as práticas recomendadas de modelagem de dados.
- Recomendação: adicione restrições de comprimento mínimo a todos os campos da cadeia de caracteres.
- Esquemas afetados: uma lista de esquemas e caminhos de campo afetados. Use o ícone de link para abrir o esquema.
Para obter mais informações, consulte as práticas recomendadas de modelagem de dados.
Matrizes sem restrições arrays-without-constraints
Verifica se os campos de matriz definem restrições mínimas e máximas de item.
Ao selecionar o cartão Matrizes sem restrições, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que Experience Platform permite a especificação de tamanhos mínimo e máximo para o número de itens em campos de matriz. Essa verificação verifica se os campos de matriz não têm restrições no número de itens que podem conter.
- Impacto: sem restrições de comprimento mínimo ou máximo definidas no esquema, não há validação no número de itens em uma matriz durante a assimilação de dados, o que pode resultar em registros de assimilação que excedem as medidas de proteção.
- Áreas gerais de impacto: assimilação de dados e qualidade do público-alvo.
- Documentação do Experience League: um link para as práticas recomendadas de modelagem de dados.
Para obter mais informações, consulte as práticas recomendadas de modelagem de dados.
Grupo de campos de consentimento ausente consent-field-group-missing
Verifica se os esquemas ativados por perfil incluem o grupo de campos Detalhes do consentimento e da preferência.
Ao selecionar o cartão Grupo de campos de consentimento ausente, um painel de detalhes é aberto à direita. O painel mostra:
- Descrição: explica que o grupo de campos Consentimentos e Preferências captura os sinais de consentimento do cliente, como preferências de aceitação e recusa para canais de marketing, personalização e coleta de dados, em uma estrutura padronizada. Esta verificação inspeciona se o grupo de campos está incluído em pelo menos um esquema habilitado para perfil.
- Impacto: quando este grupo de campos está ausente de esquemas habilitados para perfil, o Experience Platform não pode impor políticas de consentimento no nível do perfil usando sua infraestrutura de consentimento nativa.
- Áreas gerais de impacto: qualidade da ativação.
- Documentação do Experience League: um link para o grupo de campos Consentimentos e Preferências.
Para obter mais informações, consulte a documentação do grupo de campos Consentimentos e Preferências.
Próximas etapas next-steps
- Retorne à visão geral das verificações de integridade para explorar outras categorias de verificação.
- Saiba mais sobre as práticas recomendadas de esquema para criar modelos de dados confiáveis.
- Entenda as regras de vinculação de gráfico de identidade para evitar o colapso do perfil.
- Consulte a documentação de namespace de identidade para obter as práticas recomendadas de gerenciamento de namespace.