Criar um esquema usando o Schema Editor
A interface do usuário do Adobe Experience Platform permite criar e gerenciar 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, recomenda-se seguir primeiro juntamente com a criação do esquema de exemplo para conhecer os recursos do Schema Editor.
Introduçã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): o quadro normalizado pelo qual Platform organiza os dados de experiência do cliente.
- Noções básicas da composição do 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 Esquemas espaço de trabalho browse
A variável Esquemas espaço de trabalho no Platform A interface do usuário fornece uma visualização do Schema Library, permitindo exibir e gerenciar 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 neste tutorial.
Depois de fazer logon no Experience Platform, selecione Esquemas na navegação à esquerda, para abrir a Esquemas espaço de trabalho. A variável Procurar exibe uma lista de schemas (uma representação da variável Schema Library) para que você visualize e personalize. 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 guia sobre exploração de recursos XDM existentes na interface do para obter mais informações.
Criar e nomear um esquema create
Para começar a compor um esquema, selecione Criar esquema no canto superior direito da Esquemas espaço de trabalho.
A variável Criar esquema workflow aparece. Em seguida, escolha uma classe base para o esquema. Você pode escolher entre as classes principais de Perfil individual XDM e XDM ExperienceEventou Outro se essas classes não se adequarem aos seus objetivos. A variável Outro classes permite que você criar uma nova classe ou escolha entre outras classes pré-existentes.
Consulte a Perfil individual XDM e XDM ExperienceEvent para obter mais informações sobre essas classes. Para os fins deste tutorial, selecione Perfil individual XDM seguido por Próxima.
Depois de selecionar uma classe, a variável 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.
Entre em um Nome de exibição do esquema 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 seu esquema.
A variável Schema Editor é exibida. Esta é a tela sobre a qual você irá compor seu esquema. O esquema autointitulado é criado automaticamente na variável Estrutura seção da tela quando você chega ao editor, juntamente com os campos padrão incluídos na classe base que você selecionou. A classe atribuída para o esquema também é listada em Classe in Composição seção.
Adicionar um grupo de campos field-group
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 no Grupos de campos subseção.
Uma nova caixa de diálogo é exibida, exibindo uma lista de grupos de campos disponíveis. Cada grupo de campos deve ser usado apenas com uma classe específica, portanto, a caixa de diálogo lista apenas grupos de campos compatíveis com a classe selecionada (nesse caso, o XDM Individual Profile classe). 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.
É possível selecionar um dos filtros no painel à esquerda para restringir a lista de grupos de campos padrão a campos específicos indústrias como varejo, serviços financeiros e assistência médica.
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. Selecionar Voltar quando tiver terminado de visualizar, retorne à caixa de diálogo de seleção do grupo de campos.
Para este tutorial, selecione a variável Detalhes demográficos grupo de campos, selecione Adicionar grupo de campos.
A tela do esquema será exibida novamente. A variável Grupos de campos A seção agora lista "Detalhes demográficos" e o Estrutura inclui os campos contribuídos pelo grupo de campos. Você pode selecionar o nome do grupo de campos na Grupos de campos para realçar os campos específicos fornecidos na tela.
Este grupo de campos contribui com vários campos sob o nome do nível superior person com o tipo de dados "Person". Esse grupo de campos descreve informações sobre um indivíduo, incluindo nome, data de nascimento e sexo.
Observe que name O campo tem um tipo de dados "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 field-group-2
Agora é possível repetir as mesmas etapas para adicionar outro grupo de campos. Ao visualizar a variável Adicionar grupo de campos desta vez, observe que "Detalhes demográficosO grupo de campos "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 na lista e 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 no Composição e seus campos compostos adicionados à estrutura do schema.
Definir um grupo de campos personalizado define-field-group
A variável Membros do programa de fidelidade esquema se destina a capturar dados relacionados aos membros de um programa de fidelidade e ao padrão Detalhes de fidelidade o grupo de campos adicionado ao esquema fornece a maioria deles, incluindo o tipo de programa, pontos, 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.
- Estender o padrão Detalhes de fidelidade grupo de campos com campos personalizados. Isso causa Detalhes de fidelidade para ser convertido em um grupo de campos personalizado, e o grupo de campos padrão original não estará mais disponível. Consulte a Esquemas Guia da interface do usuário para obter mais informações sobre adição de campos personalizados à estrutura de grupos de campos padrão.
Para criar um novo grupo de campos, selecione Adicionar no Grupos de campos subseção como antes, mas dessa 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.
"Custom Loyalty Details" agora deve aparecer em Grupos de campos no lado esquerdo da tela, mas ainda não há campos associados a ela e, portanto, nenhum campo novo aparecerá em Estrutura.
Adicionar campos ao grupo de campos field-group-fields
Agora que você criou o "Custom Loyalty Details"grupo de campos, é hora de definir os campos em que o grupo de campos contribuirá para o esquema.
Para começar, selecione o mais (+) ícone ao lado do nome do schema na tela.
Um "Campo sem títuloO espaço reservado " é exibido na tela e o painel direito é atualizado para revelar as opções de configuração do campo.
Nesse cenário, o esquema precisa ter um campo do tipo objeto que descreva detalhadamente o nível de fidelidade atual da pessoa. Usando os controles no painel direito, comece criando uma loyaltyTier campo com tipo "Objeto" que serão usados 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", em seguida, selecione o grupo de campos na lista.
Quando terminar, selecione Aplicar.
As alterações são aplicadas e o recém-criado loyaltyTier é exibido. Como esse é um campo personalizado, ele é aninhado automaticamente em um objeto com nome vinculado à ID de locatário da sua organização, precedido por um sublinhado (_tenantId neste exemplo).
Selecione o mais (+) ícone ao lado do loyaltyTier objeto para começar a adicionar subcampos. Um novo espaço reservado de campo é exibido e a variável Propriedades do campo A seção 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 de 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 do campo. Isso inclui tipos escalares básicos e quaisquer tipos de dados definidos no Schema Registry. Exemplos: String, Integer, Booleano, Person, 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 a variável loyaltyTier o objeto 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. Defina o tipo do novo campo como "String", e a variável Propriedades do campo fica preenchida com várias opções para aplicar restrições, incluindo valor padrão, formato e comprimento máximo. Consulte a documentação em práticas recomendadas para campos de validação de dados para saber mais.
Desde id será uma cadeia de caracteres de forma livre gerada aleatoriamente, nenhuma outra restrição é necessária. Selecionar Aplicar para aplicar as alterações.
Adicionar mais campos ao grupo de campos field-group-fields-2
Agora que você adicionou o id você pode adicionar outros campos para capturar informações sobre o nível de fidelidade, como:
- Limite de ponto atual (número inteiro): o número mínimo de pontos de fidelidade que o membro deve manter para permanecer na camada atual.
- Limite de próximo ponto de camada (número inteiro): o número de pontos de fidelidade que o membro deve acumular para se formar no próximo nível.
- Data de efetivação (data-hora): a data em que o membro do programa de fidelidade ingressou nessa camada.
Para adicionar cada campo ao esquema, selecione a variável mais (+) ícone ao lado do loyalty e preencha as informações necessárias.
Quando concluído, o loyaltyTier o objeto conterá campos para id, currentThreshold, nextThreshold, e effectiveDate.
Adicionar um campo de enumeração ao grupo de campos enum
Ao definir campos na variável Schema Editor, há algumas opções adicionais que podem ser aplicadas a tipos básicos de campo para fornecer mais restrições sobre os dados que o campo pode conter. Os casos de uso para essas restrições são explicados na tabela a seguir:
Para este tutorial, a variável loyaltyTier o objeto no esquema requer um novo campo enum que descreve a classe de camada, onde o valor pode ser apenas uma das quatro opções possíveis. Para adicionar esse campo ao esquema, selecione a variável mais (+) ícone ao lado de loyaltyTier e preencha os campos obrigatórios para Nome do campo e Nome de exibição. Para Tipo, selecione "String".
Caixas de seleção adicionais são exibidas para o campo após a seleção do tipo, incluindo caixas de seleção para Matriz, Enumeração e valores sugeridos, Identidade, e Relacionamento.
Selecione o Enumeração e valores sugeridos e selecione Enum. Aqui você pode inserir o Valor (no camelCase) e Nome de exibição (um nome opcional e legível em Letra maiúscula ou minúscula) para cada classe de nível de fidelidade aceitável.
Quando tiver concluído todas as propriedades do campo, selecione Aplicar para adicionar o tierClass para o campo loyaltyTier objeto.
Converter um objeto de vários campos em um tipo de dados datatype
A variável loyaltyTier O objeto agora contém vários campos e representa uma estrutura de dados comum que pode ser útil em outros schemas. A variável Schema Editor O permite aplicar prontamente objetos de vários campos reutilizáveis convertendo a estrutura desses objetos em tipos de dados.
Os tipos de dados permitem o uso consistente de estruturas de vários campos e fornecem mais flexibilidade do que um grupo de campos, pois podem ser usados em qualquer lugar em um esquema. Isso é feito definindo as configurações do campo Tipo para o de qualquer tipo de dados definido na variável Schema Registry.
Para converter a variável loyaltyTier a um tipo de dados, selecione o loyaltyTier na tela e selecione Converter em novo tipo de dados no lado direito do editor, em Propriedades do campo.
Uma notificação é exibida, confirmando que o objeto foi convertido com êxito. Na tela, agora é possível ver que a variável loyaltyTier O campo agora tem um ícone de link e o painel direito indica que ele tem um tipo de dados "Loyalty Tier".
Em um esquema futuro, agora é possível atribuir um campo como "Loyalty Tier" e incluiria automaticamente campos para ID, classe de camada, limites de ponto e data de efetivação.
Pesquisar e filtrar campos de esquema
Seu esquema agora contém vários grupos de campos além dos campos fornecidos por sua classe base. Ao trabalhar com esquemas maiores, você pode marcar as caixas de seleção ao lado dos nomes dos grupos de campos no painel esquerdo para filtrar os campos exibidos somente para aqueles fornecidos pelos grupos de campos em que você está interessado.
Se estiver procurando um campo específico no esquema, também poderá usar a barra de pesquisa para filtrar os campos exibidos por nome, independentemente do grupo de campos em que são fornecidos.
Definir um campo de esquema como um campo de identidade identity-field
A estrutura de dados padrão fornecida pelos esquemas pode ser aproveitada para identificar dados pertencentes ao mesmo indivíduo em várias fontes, permitindo vários casos de uso downstream, como segmentação, relatórios, análise de ciência de dados e muito mais. Para compilar dados com base em identidades individuais, os campos principais devem ser marcados como Identidade em esquemas aplicáveis.
Experience Platform facilita a identificação de um campo de identidade através do uso de Identidade caixa de seleção na caixa Schema Editor. No entanto, você deve determinar qual campo é o melhor candidato a ser usado como identidade, com base na natureza dos dados.
Por exemplo, pode haver milhares de membros do programa de fidelidade pertencentes ao mesmo nível de fidelidade e vários que podem compartilhar o mesmo endereço físico. Nesse cenário, no entanto, no momento da inscrição, cada membro do programa de fidelidade fornece seu endereço de email pessoal. Como os endereços de email pessoais geralmente são gerenciados por uma pessoa, o campo personalEmail.address (fornecido pela Detalhes de contato pessoal grupo de campos) é um bom candidato para um campo de identidade.
identityMap campo para conter informações de identidade.identityMap, lembre-se de que ele substituirá qualquer identidade principal adicionada diretamente ao esquema. Consulte a seção sobre identityMap no guia de noções básicas da composição de esquema para obter mais informações.Selecione o personalEmail.address na tela, e o campo Identidade aparece em Propriedades do campo. Marque a caixa e a opção para definir isso como a variável Identidade principal é exibida. Selecione esta caixa também.
Em seguida, você deve fornecer um Namespace de identidade na lista de namespaces predefinidos na lista suspensa. Como esse campo é o endereço de email do cliente, selecione "E-mail" na lista suspensa. Selecionar Aplicar para confirmar as atualizações do personalEmail.address campo.
Depois de aplicar a alteração, o ícone para personalEmail.address mostra um símbolo de impressão digital, indicando que agora ele é um campo de identidade. O campo também está listado no painel à esquerda em Identidades.
Agora todos os dados assimilados na personalEmail.address O campo será usado para ajudar a identificar essa pessoa e unir uma única visualização desse cliente. Para saber mais sobre como trabalhar com identidades no Experience Platform, revise o Identity Service documentação.
Ativar o esquema para uso no Real-Time Customer Profile profile
Real-Time Customer Profile utiliza dados de identidade no Experience Platform para fornecer uma visão holística de cada cliente individual. O serviço cria perfis robustos de 360° dos atributos do cliente, bem como contas com carimbo de data e hora de cada interação que os clientes tiveram em qualquer sistema integrado com a Experience Platform.
Para que um esquema seja ativado para uso com Real-Time Customer Profile, ela deve ter uma identidade principal definida. Você receberá uma mensagem de erro se tentar ativar um esquema sem definir primeiro uma identidade primária.
Para ativar o esquema "Membros de fidelidade" para uso no Profile, comece selecionando o título do schema na tela.
No lado direito do editor, são mostradas informações sobre o esquema, incluindo o nome para exibição, a descrição e o tipo. Para além destas informações, existe uma Perfil botão de alternância.
Selecionar Perfil e um popover é exibido, pedindo que você confirme que deseja ativar o esquema para Profile.
Selecionar Ativar para confirmar sua escolha. É possível selecionar a variável Perfil alterne novamente para desativar o esquema, se desejar, mas depois que o esquema tiver sido salvo enquanto Profile estiver ativado, não poderá mais ser desativado.
Mais ações more
No Editor de esquemas, você também pode realizar ações rápidas para copiar a estrutura JSON do esquema ou excluir o esquema se ele não tiver sido ativado para o Perfil do cliente em tempo real ou tiver conjuntos de dados associados. Selecionar Mais na parte superior da exibição para exibir uma lista suspensa com ações rápidas.
A funcionalidade Copiar estrutura JSON permite ver como seria uma carga de amostra enquanto você ainda está criando o esquema e seus pipelines de dados. É especialmente útil para situações em que há estruturas complexas de mapa de objetos no esquema, como um mapa de identidade.
Próximas etapas e recursos adicionais
Agora que terminou de compor o esquema, você pode ver o esquema completo na tela. Selecionar Salvar e o esquema será salvo na variável Schema Library, tornando-o acessível pela Schema Registry.
Seu novo esquema agora pode ser usado para assimilar dados no Platform. Lembre-se de que, uma vez que o esquema tenha sido usado para assimilar dados, somente alterações aditivas poderão ser feitas. Consulte a noções básicas da composição do esquema para obter mais informações sobre controle de versão de esquema.
Agora você pode seguir o tutorial em definição de um relacionamento de esquema na interface para adicionar um novo campo de relacionamento ao esquema "Membros de fidelidade".
O esquema "Membros de fidelidade" também está disponível para ser visualizado e gerenciado usando o Schema Registry API. Para começar a trabalhar com a API, comece lendo o Schema Registry API guia do desenvolvedor.
Recursos de vídeo
O vídeo a seguir mostra como criar um esquema simples no Platform IU.
O vídeo a seguir tem como objetivo reforçar sua compreensão de trabalhar com grupos de campo e classes.
Apêndice
As seções a seguir fornecem informações adicionais sobre o uso do Schema Editor.
Criar uma nova classe create-new-class
Experience Platform O oferece a flexibilidade para definir um esquema com base em uma classe exclusiva de sua organização. Para saber como criar uma nova classe, consulte o manual sobre criação e edição de classes na interface.
Alterar a classe de um esquema change-class
Você pode alterar a classe de um esquema em qualquer momento durante o processo de composição inicial, antes que o esquema tenha sido salvo.
Para saber como alterar a classe de um schema, consulte o manual sobre gerenciamento de esquemas na interface.