Criar um esquema usando o Schema Editor
A interface de usuário do Adobe Experience Platform permite criar e gerenciar esquemas do Experience Data Model (XDM) em uma tela visual interativa chamada de Schema Editor. Este tutorial aborda como criar um esquema usando o Schema Editor.
Para fins de demonstração, as etapas deste tutorial envolvem a criação de um schema de exemplo que descreve os membros de um programa de fidelidade do cliente. Embora você possa usar essas etapas para criar um esquema diferente para suas próprias finalidades, é recomendável que você siga primeiro juntamente com a criação do esquema de exemplo para conhecer os recursos do Schema Editor.
NOTEIntrodução
Este tutorial requer uma compreensão funcional dos vários aspectos do Adobe Experience Platform envolvidos na criação do esquema. Antes de iniciar este tutorial, revise a documentação dos seguintes conceitos:
- Experience Data Model (XDM): a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Noções básicas sobre a composição de esquema: uma visão geral dos esquemas XDM e seus blocos de construção, incluindo classes, grupos de campos de esquema, tipos de dados e campos individuais.
- Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
Abra o espaço de trabalho Esquemas
O espaço de trabalho Esquemas da interface do usuário Experience Platform fornece uma visualização do Schema Library, permitindo que você visualize e gerencie os esquemas disponíveis para sua organização. O espaço de trabalho também inclui o Schema Editor, a tela na qual você pode compor um esquema através deste tutorial.
Depois de fazer logon em Experience Platform, selecione Esquemas na navegação à esquerda para abrir o espaço de trabalho Esquemas. A guia Procurar exibe uma lista de esquemas (uma representação do Schema Library) para que você possa exibi-los e personalizá-los. A lista inclui o nome, o tipo, a classe e o comportamento (registro ou série temporal) em que o esquema se baseia, bem como a data e a hora em que o esquema foi modificado pela última vez.
Consulte o manual sobre exploração de recursos XDM existentes na interface para obter mais informações.
Criar e nomear um esquema
Para começar a compor um esquema, selecione Criar esquema no canto superior direito do espaço de trabalho Esquemas.
A caixa de diálogo Criar um esquema é exibida. Nesta caixa de diálogo, você pode optar por criar manualmente um esquema adicionando campos e grupos de campos ou pode fazer upload de um arquivo CSV e usar algoritmos de ML para gerar um esquema. Selecione um workflow de criação de esquema na caixa de diálogo.
Criação manual ou assistida por aprendizado de máquina do {Beta
Para saber como usar um algoritmo de ML para recomendar uma estrutura de esquema com base em um arquivo carregado, consulte o guia de criação de esquema assistido por aprendizado de máquina. Este guia de interface do usuário se concentra no fluxo de trabalho de criação manual.
Escolha uma classe base
O fluxo de trabalho Criar esquema é exibido. Em seguida, escolha uma classe base para o esquema. Você pode escolher entre as classes principais do Perfil Individual XDM e do XDM ExperienceEvent ou Outras se essas classes não atenderem aos seus objetivos. A opção de classes Other permite criar uma nova classe ou escolher entre outras classes pré-existentes.
Consulte a documentação do Perfil individual XDM e do XDM ExperienceEvent para obter mais informações sobre essas classes. Para os fins deste tutorial, selecione Perfil Individual XDM seguido de Próximo.
Nomear e revisar
Após selecionar uma classe, a seção Nome e revisão é exibida. Nesta seção, você fornece um nome e uma descrição para identificar o esquema. Há várias considerações importantes a serem feitas ao decidir sobre um nome para o esquema:
- Os nomes do esquema devem ser curtos e descritivos para que o esquema possa ser facilmente encontrado posteriormente.
- Os nomes do esquema devem ser exclusivos, o que significa que também devem ser específicos o suficiente para não serem reutilizados no futuro. Por exemplo, se sua organização tivesse programas de fidelidade separados para marcas diferentes, seria interessante nomear seu esquema como "Membros da fidelidade da marca A" para facilitar a distinção de outros esquemas relacionados à fidelidade que você poderia definir posteriormente.
- Também é possível usar a descrição do schema para fornecer informações contextuais adicionais sobre o schema.
Este tutorial compõe um esquema para assimilar dados relacionados aos membros de um programa de fidelidade e, portanto, o esquema é nomeado como "Loyalty Members".
A estrutura base do esquema (fornecida pela classe) é mostrada na tela para que você revise e verifique a classe selecionada e a estrutura do esquema.
Insira um Nome para exibição do esquema amigável no campo de texto. Em seguida, insira uma descrição adequada para ajudar a identificar seu esquema. Quando tiver revisado a estrutura do esquema e estiver satisfeito com as configurações, selecione Concluir para criar o esquema.
Compor seu esquema
O Schema Editor aparece. Esta é a tela sobre a qual você irá compor seu esquema. O esquema autointitulado é criado automaticamente na seção Estrutura da tela quando você chega ao editor, juntamente com os campos padrão incluídos na classe base selecionada. A classe atribuída para o esquema também está listada em Classe na seção Composição.
NOTE
NOTEAdicionar um grupo de campos
Agora é possível começar a adicionar campos ao esquema adicionando grupos de campos. Um grupo de campos é um grupo de um ou mais campos que geralmente são usados juntos para descrever um conceito específico. Este tutorial usa grupos de campos para descrever os membros do programa de fidelidade e capturar informações importantes, como nome, aniversário, número de telefone, endereço e muito mais.
Para adicionar um grupo de campos, selecione Adicionar na subseção Grupos de campos.
Uma nova caixa de diálogo é exibida, exibindo uma lista de grupos de campos disponíveis. Cada grupo de campos destina-se apenas ao uso com uma classe específica, portanto, a caixa de diálogo lista apenas grupos de campos compatíveis com a classe selecionada (nesse caso, a classe XDM Individual Profile). Se você estiver usando uma classe XDM padrão, a lista de grupos de campos será classificada de forma inteligente com base na popularidade do uso.
Você pode selecionar um dos filtros no painel esquerdo para restringir a lista de grupos de campos padrão a setores específicos, como varejo, serviços financeiros e área de saúde.
Selecionar um grupo de campos na lista faz com que ele apareça no painel direito. Você pode selecionar vários grupos de campos, se desejar, adicionando cada um à lista no painel direito antes de confirmar. Além disso, um ícone é exibido no lado direito do grupo de campos selecionado no momento, o que permite visualizar a estrutura dos campos fornecidos.
Ao visualizar um grupo de campos, uma descrição detalhada do esquema do grupo de campos é fornecida no painel direito. Você também pode navegar pelos campos do grupo de campos na tela fornecida. À medida que você seleciona campos diferentes, o painel direito é atualizado para mostrar detalhes sobre o campo em questão. Selecione Voltar quando tiver terminado de visualizar para retornar à caixa de diálogo de seleção do grupo de campos.
Para este tutorial, selecione o grupo de campos Detalhes demográficos e selecione Adicionar grupo de campos.
A tela do esquema será exibida novamente. A seção Grupos de campos agora lista "Detalhes Demográficos" e a seção Estrutura inclui os campos contribuídos pelo grupo de campos. Você pode selecionar o nome do grupo de campos na seção Grupos de campos para realçar os campos específicos que ele fornece na tela.
NOTE
Este grupo de campos contribui com vários campos sob o nome de nível superior person com o tipo de dados "Pessoa". Esse grupo de campos descreve informações sobre um indivíduo, incluindo nome, data de nascimento e sexo.
NOTEObserve que o campo name tem um tipo de dados of "Nome completo", o que significa que também descreve um conceito comum e contém subcampos relacionados ao nome, como nome, sobrenome, título de cortesia e sufixo.
Selecione os diferentes campos na tela para revelar quaisquer campos adicionais com que eles contribuam para a estrutura do esquema.
Adicionar mais grupos de campos
Agora é possível repetir as mesmas etapas para adicionar outro grupo de campos. Ao exibir a caixa de diálogo Adicionar grupo de campos desta vez, observe que o grupo de campos "Detalhes Demográficos" foi esmaecido e a caixa de seleção ao lado dele não pode ser selecionada. Isso impede a duplicação acidental de grupos de campos que você já incluiu no esquema atual.
Para este tutorial, selecione os grupos de campos padrão Detalhes de contato pessoal e Detalhes de fidelidade da lista, em seguida, selecione Adicionar grupos de campos para adicioná-los ao esquema.
A tela será exibida novamente com os grupos de campos adicionados listados em Grupos de campos na seção Composição e seus campos compostos adicionados à estrutura do esquema.
Definir um grupo de campos personalizado
O esquema Membros de Fidelidade deve capturar dados relacionados aos membros de um programa de fidelidade, e o grupo de campos padrão Detalhes de Fidelidade que você adicionou ao esquema fornece a maioria deles, incluindo o tipo de programa, points, data de adesão e muito mais.
No entanto, pode haver um cenário em que você deseje incluir campos personalizados adicionais não cobertos por grupos de campos padrão para atingir seus casos de uso. No caso de adicionar campos de fidelidade personalizados, você tem duas opções:
- Crie um novo grupo de campos personalizado para capturar esses campos. Este é o método que será abordado neste tutorial.
- Estenda o grupo de campos padrão Detalhes de fidelidade com campos personalizados. Isso faz com que Detalhes de fidelidade sejam convertidos em um grupo de campos personalizado, e o grupo de campos padrão original não estará mais disponível. Consulte o guia de interface do usuário Esquemas para obter mais informações sobre como adicionar campos personalizados à estrutura de grupos de campos padrão.
Para criar um novo grupo de campos, selecione Adicionar na subseção Grupos de campos como antes, mas desta vez selecione Criar novo grupo de campos próximo à parte superior da caixa de diálogo exibida. Em seguida, você será solicitado a fornecer um nome de exibição e uma descrição para o novo grupo de campos. Para este tutorial, nomeie o novo grupo de campos "Custom Loyalty Details" e selecione Adicionar grupos de campos.
NOTE"Custom Loyalty Details" agora deve aparecer em Grupos de campos no lado esquerdo da tela, mas ainda não há campos associados a ele e, portanto, nenhum campo novo aparece em Estrutura.
Adicionar campos ao grupo de campos
Agora que você criou o grupo de campos "Custom Loyalty Details", é hora de definir os campos nos quais o grupo de campos contribuirá para o esquema.
Para começar, selecione o ícone de adição (+) ao lado do nome do esquema na tela.
Um espaço reservado para "Campo sem título" é exibido na tela e o painel direito é atualizado para revelar as opções de configuração do campo.
Neste cenário, o esquema precisa ter um tipo de objeto field que descreve detalhadamente o nível de fidelidade atual da pessoa. Usando os controles no painel direito, comece criando um campo loyaltyTier com o tipo "Objeto" que será usado para manter seus campos relacionados.
Em Atribuir a, você deve selecionar um grupo de campos ao qual atribuir o campo. Lembre-se de que todos os campos de esquema pertencem a uma classe ou a um grupo de campos e, como esse esquema usa uma classe padrão, sua única opção é selecionar um grupo de campos. Comece a digitar o nome "Custom Loyalty Details" e selecione o grupo de campos na lista.
Quando terminar, selecione Aplicar.
As alterações são aplicadas e o objeto loyaltyTier recém-criado é exibido. Como esse é um campo personalizado, ele é aninhado automaticamente em um objeto com namespace à ID de locatário da sua organização, precedido por um sublinhado (_tenantId neste exemplo).
NOTESelecione o ícone de mais (+) ao lado do objeto loyaltyTier para começar a adicionar subcampos. Um novo espaço reservado de campo é exibido e a seção Propriedades do campo está visível no lado direito da tela.
Cada campo requer as seguintes informações:
- Nome do Campo: O nome do campo, de preferência escrito em camelCase. Não são permitidos caracteres de espaço. Esse é o nome usado para fazer referência ao campo no código e em outros aplicativos downstream.
- Exemplo: fidelizlevel
- Nome para Exibição: O nome do campo, escrito em letra maiúscula. Esse é o nome que será exibido na tela ao visualizar ou editar o esquema.
- Exemplo: Nível de fidelidade
- Tipo: O tipo de dados of o campo. Isso inclui tipos escalares básicos and quaisquer tipos de dados defined no Schema Registry. Exemplos: Cadeia de caracteres, Inteiro, Booleano, Pessoa, Endereço, Número de telefone, etc.
- Descrição: Uma descrição opcional do campo deve ser incluída com no máximo 200 caracteres.
O primeiro campo para o objeto loyaltyTier será uma cadeia de caracteres chamada id, representando a ID da camada atual do membro de fidelidade. A ID da camada será exclusiva para cada membro do programa de fidelidade, já que essa empresa define diferentes limites de ponto da camada de fidelidade para cada cliente com base em diferentes fatores. Definir o tipo do novo campo to A seção Cadeia de caracteres" e as Propriedades do campo são populadas com várias opções para aplicar restrições, incluindo valor padrão, formato e comprimento máximo. Consulte a documentação sobre práticas recomendadas para campos de validação de dados para saber mais.
Como id será uma cadeia de caracteres de forma livre gerada aleatoriamente, nenhuma outra restrição será necessária. Selecione Aplicar para aplicar as alterações.
