Criar e editar schemas na interface do usuário

Este guia fornece uma visão geral de como criar, editar e gerenciar schemas do Modelo de Dados de Experiência (XDM) para sua organização na interface do usuário do Adobe Experience Platform.

IMPORTANTE

Os schemas XDM são extremamente personalizáveis e, portanto, as etapas envolvidas na criação de um schema podem variar dependendo do tipo de dados que você deseja que o schema capture. Como resultado, este documento cobre apenas as interações básicas que você pode fazer com schemas na interface do usuário e exclui etapas relacionadas, como personalização de classes, combinações, tipos de dados e campos.

Para um tour completo do processo de criação do schema, siga o tutorial de criação do schema para criar um schema de exemplo completo e familiarizar-se com os vários recursos do Schema Editor.

Pré-requisitos

Este guia requer um entendimento prático do sistema XDM. Consulte Visão geral do XDM para obter uma introdução à função do XDM dentro do ecossistema do Experience Platform, e as noções básicas da composição do schema para obter uma visão geral de como os schemas são construídos.

Criar um novo schema

Na área de trabalho Schemas, selecione Criar schema no canto superior direito. Na lista suspensa que é exibida, você pode escolher entre Perfil individual XDM e ExperienceEvent XDM como a classe base do schema. Como alternativa, você pode selecionar Procurar para selecionar na lista completa das classes disponíveis, ou criar uma nova classe personalizada em vez disso.

Após selecionar uma classe, Schema Editor será exibido e a estrutura base do schema (fornecida pela classe) será mostrada na tela. Aqui, você pode usar o painel direito para adicionar um Nome de exibição e Descrição para o schema.

Agora você pode criar o start de criar a estrutura do schema ao adicionar mixins.

Editar um schema existente

OBSERVAÇÃO

Depois que um schema é salvo e usado na ingestão de dados, somente alterações aditivas podem ser feitas nele. Consulte as regras de evolução do schema para obter mais informações.

Para editar um schema existente, selecione a guia Procurar e selecione o nome do schema que deseja editar.

DICA

Você pode usar os recursos de pesquisa e filtragem do espaço de trabalho para ajudar a encontrar o schema com mais facilidade. Consulte o guia em exploração de recursos XDM para obter mais informações.

Após selecionar um schema, o Schema Editor será exibido com a estrutura do schema mostrada na tela. Agora você pode adicionar mixins ao schema, editar nomes de exibição de campos ou editar mixins personalizados existentes se o schema empregar algum.

Adicionar misturas a um schema

OBSERVAÇÃO

Esta seção aborda como adicionar misturas existentes a um schema. Se quiser criar uma nova combinação personalizada, consulte o guia em criar e editar mixins.

Depois de abrir um schema dentro de Schema Editor, é possível adicionar campos ao schema por meio do uso de mixins. Para start, selecione Adicionar ao lado de Mixins no painel esquerdo.

Uma caixa de diálogo é exibida mostrando uma lista de combinações que você pode selecionar para o schema. Como as misturas são compatíveis apenas com uma classe, somente as misturas associadas à classe selecionada do schema serão listadas. Por padrão, as misturas listadas são classificadas com base na popularidade de uso dentro da organização.

Você pode usar a barra de pesquisa para ajudar a localizar a combinação desejada. As misturas cujo nome corresponde ao query são exibidas na parte superior da lista. Em Campos padrão, as combinações que contêm campos que descrevem os atributos de dados desejados são exibidas.

Marque a caixa de seleção ao lado do nome da mistura que você deseja adicionar ao schema. É possível selecionar várias combinações na lista, com cada combinação selecionada aparecendo no painel direito.

DICA

Para qualquer combinação listada, você pode passar o mouse ou focar no ícone de informações () para visualização de uma breve descrição do tipo de dados capturados pela mistura. Você também pode selecionar o ícone de pré-visualização () para visualização da estrutura dos campos fornecidos pelo mixin antes de decidir adicioná-lo ao schema.

Depois de escolher suas combinações, selecione Adicionar mixin para adicioná-las ao schema.

O Schema Editor reaparece com os campos fornecidos pela combinação representados na tela.

Ative um schema para o Perfil do cliente em tempo real

Os Perfis de clientes em tempo real emergem dados de fontes diferentes para construir uma visualização completa de cada cliente individual. Se quiser que os dados capturados por um schema participem desse processo, ative o schema para uso em Profile.

IMPORTANTE

Para habilitar um schema para Profile, ele deve ter um campo de identidade primário definido. Consulte o guia em definindo campos de identidade para obter mais informações.

Para habilitar o schema, selecione o nome do schema no painel esquerdo e, em seguida, selecione o botão Perfil no painel direito.

Um schema é exibido, avisando que, uma vez ativado e salvo, ele não pode ser desativado. Selecione Ativar para continuar.

A tela de desenho é exibida novamente com a alternância Perfil ativada.

IMPORTANTE

Como o schema ainda não foi salvo, este é o ponto de não retorno se você mudar de ideia sobre permitir que o schema participe do Perfil do cliente em tempo real: depois de salvar um schema ativado, ele não poderá mais ser desativado. Selecione a alternância Perfil novamente para desativar o schema.

Para concluir o processo, selecione Salvar para salvar o schema.

O schema agora está habilitado para uso no Perfil do cliente em tempo real. Quando a Platform ingressar dados em conjuntos de dados baseados nesse schema, esses dados serão incorporados aos dados do Perfil agrupado.

Editar nomes de exibição para campos de schema

Depois de atribuir uma classe e adicionar combinações a um schema, você pode editar os nomes de exibição de qualquer um dos campos do schema, independentemente de esses campos terem sido fornecidos por recursos XDM padrão ou personalizados.

OBSERVAÇÃO

Lembre-se de que os nomes de exibição de campos que pertencem a classes ou combinações padrão só podem ser editados no contexto de um schema específico. Em outras palavras, alterar o nome de exibição de um campo padrão em um schema não afeta outros schemas que usam a mesma classe ou combinação associada.

Para editar o nome de exibição de um campo de schema, selecione o campo na tela. No painel direito, forneça o novo nome em Nome de exibição.

Selecione Aplicar no painel direito e a tela é atualizada para mostrar o novo nome de exibição do campo. Selecione Salvar para aplicar as alterações ao schema.

Alterar uma classe de schema

É possível alterar a classe de um schema em qualquer ponto durante o processo de composição inicial antes que o schema seja salvo.

AVISO

A reatribuição da classe para um schema deve ser feita com extrema cautela. Misturas são compatíveis somente com certas classes, e, portanto, alterar a classe redefinirá a tela de desenho e quaisquer campos adicionados.

Para reatribuir uma classe, selecione Atribuir no lado esquerdo da tela.

Será exibida uma caixa de diálogo que exibe uma lista de todas as classes disponíveis, incluindo qualquer classe definida por sua organização (sendo o proprietário "Customer"), bem como as classes padrão definidas pelo Adobe.

Selecione uma classe na lista para exibir sua descrição no lado direito da caixa de diálogo. Você também pode selecionar estrutura de classe de Pré-visualização para ver os campos e metadados associados à classe. Selecione Atribuir classe para continuar.

Uma nova caixa de diálogo é aberta, solicitando que você confirme que deseja atribuir uma nova classe. Selecione Atribuir para confirmar.

Após confirmar a alteração de classe, a tela será redefinida e todo o progresso da composição será perdido.

Próximas etapas

Este documento abordou as noções básicas de criação e edição de schemas na interface do usuário da plataforma. É altamente recomendável que você reveja o tutorial de criação de schemas para obter um fluxo de trabalho abrangente para a criação de um schema completo na interface do usuário, incluindo a criação de mixins personalizados e tipos de dados para casos de uso exclusivos.

Para obter mais informações sobre os recursos do espaço de trabalho Schemas, consulte a visão geral do espaço de trabalho dos Schemas.

Para saber como gerenciar schemas na API Schema Registry, consulte o guia de ponto de extremidade de schemas.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free