Quais são os melhores usos para grupos de campos em relação aos tipos de dados?
Grupos de campos são componentes que definem um ou mais campos em um esquema. Os grupos de campos impõem como os campos aparecem na hierarquia do esquema e, portanto, exibem a mesma estrutura em cada esquema em que estão incluídos. Os grupos de campos são compatíveis apenas com classes específicas, conforme identificado pelo seu atributo meta:intendedToExtend
.
Os tipos de dados também podem fornecer um ou mais campos para um esquema. No entanto, diferentemente dos grupos de campos, os tipos de dados não estão restritos a uma classe específica. Isso torna os tipos de dados uma opção mais flexível para descrever estruturas de dados comuns que são reutilizáveis em vários esquemas com classes potencialmente diferentes.
Qual é o identificador exclusivo de um esquema?
Todos os recursos do Schema Registry (esquemas, grupos de campos, tipos de dados, classes) têm um URI que atua como uma ID exclusiva para fins de referência e pesquisa. Ao visualizar um esquema na API, ele pode ser encontrado nos atributos $id
e meta:altId
de nível superior.
Para obter mais informações, consulte a seção identificação de recursos no guia de API Schema Registry.
Qual é o tamanho máximo de um tipo de campo longo?
Um tipo de campo longo é um inteiro com um tamanho máximo de 53(+1) bits, dando a ele um intervalo potencial entre -9007199254740992 e 9007199254740992. Isso se deve a uma limitação de como as implementações do JavaScript de JSON representam números inteiros longos.
Para obter mais informações sobre tipos de campos, consulte o documento sobre Restrições de tipo de campo XDM.
O que é meta:AltId?
meta:altId
é um identificador exclusivo para um esquema. O meta:altId
fornece uma ID de referência fácil para uso em chamadas de API. Essa ID evita a necessidade de ser codificada/decodificada sempre que for usada como com o formato JSON URI.
Quais são as restrições de uso para um tipo de dados de mapa?
O XDM impõe as seguintes restrições ao uso desse tipo de dados:
- Os tipos de mapa DEVEM ser do tipo objeto.
- Os tipos de mapa NÃO DEVEM ter propriedades definidas (em outras palavras, eles definem objetos "vazios").
- Os tipos de mapa DEVEM incluir um campo additionalProperties.type que descreve os valores que podem ser colocados no mapa, seja string ou inteiro.
- A segmentação de várias entidades só pode ser definida com base nas chaves do mapa, e não nos valores.
- Os mapas não são compatíveis com os públicos-alvo da conta.
Consulte as restrições de uso para mapear objetos para obter mais detalhes.
Schema Identity Management
Esta seção contém respostas a perguntas comuns sobre a definição e o gerenciamento de identidades em seus esquemas.
Como definir identidades para meu esquema?
Em Experience Platform, as identidades são usadas para identificar um assunto (normalmente uma pessoa física) independentemente das fontes de dados que estão sendo interpretadas. Eles são definidos em esquemas ao marcar campos principais como "Identidade". Os campos comumente usados para identidade incluem endereço de email, número de telefone, Experience Cloud ID (ECID), ID de CRM e outros campos de ID exclusivos.
Os campos podem ser marcados como identidades usando a API ou a interface do usuário.
Definição de identidades na API
Na API, as identidades são estabelecidas por meio da criação de descritores de identidade. Os descritores de identidade sinalizam que uma propriedade específica de um esquema é um identificador exclusivo.
Os descritores de identidade são criados por uma solicitação POST para o endpoint /descriptors. Se for bem-sucedido, você receberá um Status HTTP 201 (Criado) e um objeto de resposta contendo os detalhes do novo descritor.
Para obter mais detalhes sobre como criar descritores de identidade na API, consulte o documento na seção descritores no guia do desenvolvedor Schema Registry.
Definição de identidades na interface
Com o esquema aberto no Editor de esquemas, selecione o campo na seção Estrutura do editor que você deseja marcar como uma identidade. Em Propriedades do campo no lado direito, marque a caixa de seleção Identidade.
Para obter mais detalhes sobre como gerenciar identidades na interface, consulte a seção sobre definição de campos de identidade no tutorial do Editor de esquemas.
Meu esquema precisa de uma identidade principal?
As identidades primárias são opcionais, pois os esquemas podem ter zero ou uma delas. No entanto, um esquema deve ter uma identidade primária para que o esquema seja habilitado para uso em Real-Time Customer Profile. Consulte a seção identity do tutorial do Editor de esquemas para obter mais informações.
Ativação do perfil de esquema
Esta seção fornece orientação sobre como ativar esquemas para uso com o Perfil de cliente em tempo real.
Como habilitar um esquema para uso no Real-Time Customer Profile?
Os esquemas estão habilitados para uso em Real-Time Customer Profile por meio da adição de uma tag de "união" no atributo meta:immutableTags
do esquema. A habilitação de um esquema para uso com Profile pode ser feita usando a API ou a interface do usuário.
Habilitando um esquema existente para Profile usando a API
Faça uma solicitação PATCH para atualizar o esquema e adicionar o atributo meta:immutableTags
como uma matriz contendo o valor "union". Se a atualização for bem-sucedida, a resposta mostrará o esquema atualizado que agora contém a tag de união.
Para obter mais informações sobre como usar a API para habilitar um esquema para uso em Real-Time Customer Profile, consulte o documento unions do guia do desenvolvedor Schema Registry.
Habilitando um esquema existente para Profile usando a interface
Em Experience Platform, selecione Esquemas no menu de navegação esquerdo e selecione o nome do esquema que deseja habilitar na lista de esquemas. Em seguida, no lado direito do editor, em Propriedades do esquema, selecione Perfil para ativá-lo.
Para obter mais informações, consulte a seção sobre usar em Perfil de cliente em tempo real no tutorial Editor de esquemas.
Quando os dados do Adobe Analytics são importados como uma origem, o esquema criado automaticamente é ativado para o Perfil?
O esquema não é ativado automaticamente para o Perfil de cliente em tempo real. Você precisa ativar explicitamente o conjunto de dados para o Perfil com base no esquema que está ativado para o Perfil. Consulte a documentação para saber as etapas e os requisitos necessários para habilitar um conjunto de dados para uso no Perfil do Cliente em Tempo Real.
Posso excluir esquemas habilitados para perfil?
Não é possível excluir um esquema depois que ele é ativado para o Perfil de cliente em tempo real. Depois que um esquema é ativado para o Perfil, ele não pode ser desativado ou excluído e os campos não podem ser removidos do esquema. Portanto, é crucial planejar e verificar cuidadosamente a configuração do esquema antes de habilitá-lo para o Perfil. No entanto, você pode excluir um conjunto de dados habilitado para perfil. Informações encontradas aqui: https://experienceleague.adobe.com/pt-br/docs/experience-platform/catalog/datasets/user-guide#delete-a-profile-enabled-dataset
Se você não quiser mais que um esquema habilitado para perfil seja usado, é recomendável renomear o esquema para incluir Não usar ou Inativo.
Modificação e restrições do esquema
Esta seção fornece esclarecimentos sobre as regras de modificação de schema e sobre a prevenção de alterações.
Quando um esquema começa a impedir alterações?
Alterações interruptivas podem ser feitas em um esquema desde que ele nunca tenha sido usado na criação de um conjunto de dados ou esteja habilitado para uso no Real-Time Customer Profile. Depois que um esquema é usado na criação do conjunto de dados ou habilitado para uso com Real-Time Customer Profile, as regras de Evolução do Esquema tornam-se estritamente aplicadas pelo sistema.
Posso editar um esquema de união diretamente?
Os esquemas de união são somente leitura e são gerados automaticamente pelo sistema. Eles não podem ser editados diretamente. Os esquemas de união são criados para uma classe específica quando uma tag de "união" é adicionada ao esquema que implementa essa classe.
Para obter mais informações sobre uniões no XDM, consulte a seção uniões no guia de API Schema Registry.
Como devo formatar meu arquivo de dados para assimilar dados no meu esquema?
Experience Platform aceita arquivos de dados no formato Parquet ou JSON. O conteúdo desses arquivos deve estar em conformidade com o esquema referenciado pelo conjunto de dados. Para obter detalhes sobre as práticas recomendadas para assimilação de arquivos de dados, consulte a visão geral de assimilação em lote.
Como posso converter um esquema em um esquema somente leitura?
No momento, não é possível converter um esquema em somente leitura.
Erros e solução de problemas
Esta é uma lista de mensagens de erro que você pode encontrar ao trabalhar com a API Schema Registry.
Recurso não encontrado
{
"type": "http://ns.adobe.com/aep/errors/XDM-1010-404",
"title": "Resource not found",
"status": 404,
"report": {
"registryRequestId": "a15996b5-5133-4cec-9bf7-7d1207904ae3",
"timestamp": "06-01-2021 04:11:06",
"detailed-message": "The requested class resource https://ns.adobe.com/{TENANT_ID}/classes/11447bb484d4599d2cd9b0aseefff78b463cbbde1527f498 with version 1 is not found.",
"sub-errors": []
},
"detail": "The requested class resource https://ns.adobe.com/{TENANT_ID}/classes/11447bb484d4599d2cd9b0aseefff78b463cbbde1527f498 with version 1 is not found."
}
Esse erro é exibido quando o sistema não consegue encontrar um recurso específico. O recurso pode ter sido excluído ou o caminho na chamada à API é inválido. Verifique se você inseriu um caminho válido para a chamada de API antes de tentar novamente. Você pode verificar se inseriu a ID correta para o recurso e se o caminho foi namespace corretamente com o container apropriado (global ou locatário).
type
URIs a seguir:http://ns.adobe.com/aep/errors/XDM-1010-404
http://ns.adobe.com/aep/errors/XDM-1011-404
http://ns.adobe.com/aep/errors/XDM-1012-404
http://ns.adobe.com/aep/errors/XDM-1013-404
http://ns.adobe.com/aep/errors/XDM-1014-404
http://ns.adobe.com/aep/errors/XDM-1015-404
http://ns.adobe.com/aep/errors/XDM-1016-404
http://ns.adobe.com/aep/errors/XDM-1017-404
Para obter mais informações sobre como construir caminhos de pesquisa na API, consulte as seções contêiner e identificação de recursos no guia do desenvolvedor Schema Registry.