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.
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): 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.
Abrir o espaço de trabalho Schemas browse
O espaço de trabalho Schemas na interface do usuário do 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 Schemas na navegação à esquerda para abrir o espaço de trabalho Schemas. A guia Browse exibe uma lista de esquemas (uma representação do Schema Library) para você visualizar e personalizar. 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 create
Para começar a compor um esquema, selecione Create schema no canto superior direito do espaço de trabalho Schemas.
A caixa de diálogo Create a schema é 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.
Beta [Criação manual ou com ML]{class="badge informative"} do esquema manual-or-assisted
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 choose-a-class
O fluxo de trabalho Create schema é exibido. Em seguida, escolha uma classe base para o esquema. Você pode escolher entre as classes principais de XDM Individual Profile e XDM ExperienceEvent, ou Other se essas classes não se adequarem 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 de XDM individual profile e XDM ExperienceEvent para obter mais informações sobre essas classes. Para os fins deste tutorial, selecione XDM Individual Profile seguido de Next.
Nomear e revisar name-and-review
Após selecionar uma classe, a seção Name and review é 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 Schema display name amigável no campo de texto. Em seguida, insira uma descrição adequada para ajudar a identificar seu esquema. Quando tiver revisado sua estrutura de esquema e estiver satisfeito com suas configurações, selecione Finish para criar seu esquema.
Compor seu esquema compose-your-schema
O Schema Editor aparece. Esta é a tela sobre a qual você irá compor seu esquema. O esquema autointitulado é criado automaticamente na seção Structure 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 Class na seção Composition.
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 Add na subseção Field groups.
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 Back quando terminar de visualizar para retornar à caixa de diálogo de seleção do grupo de campos.
Para este tutorial, selecione o grupo de campos Demographic Details e selecione Add field group.
A tela do esquema será exibida novamente. A seção Field groups agora lista "Demographic Details" e a seção Structure inclui os campos contribuídos pelo grupo de campos. Você pode selecionar o nome do grupo de campos na seção Field groups para realçar os campos específicos que ele fornece dentro da tela.
Este grupo de campos contribui com vários campos sob o nome de 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 o campo name tem um tipo de dados de "Full name", o que significa que ele 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 exibir a caixa de diálogo Add field group desta vez, observe que o grupo de campos "Demographic Details" 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 Personal Contact Details e Loyalty Details na lista, em seguida, selecione Add field groups para adicioná-los ao esquema.
A tela será exibida novamente com os grupos de campos adicionados listados em Field groups na seção Composition e seus campos compostos adicionados à estrutura do esquema.
Definir um grupo de campos personalizado define-field-group
O esquema Loyalty Members deve capturar dados relacionados aos membros de um programa de fidelidade, e o grupo de campos Loyalty Details padrão 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 grupo de campos padrão Loyalty Details com campos personalizados. Isso faz com que Loyalty Details seja convertido em um grupo de campos personalizados, e o grupo de campos padrão original não estará mais disponível. Consulte o guia da interface do usuário do Schemas 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 Add na subseção Field groups como antes, mas dessa vez selecione Create New Field group 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 Add field groups.
"Custom Loyalty Details" agora deve aparecer em Field groups no lado esquerdo da tela, mas ainda não há campos associados a ela e, portanto, nenhum campo novo aparecerá em Structure.
Adicionar campos ao grupo de campos field-group-fields
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 "Untitled Field" é 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 um campo loyaltyTier com o tipo "Object", que será usado para manter seus campos relacionados.
Em Assign to, 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 Apply.
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).
Selecione 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 Field properties está visível no lado direito da tela.
Cada campo requer as seguintes informações:
- Field Name: 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
- Display Name: 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
- Type: O tipo de dados do campo. Isso inclui tipos escalares básicos e quaisquer tipos de dados definidos em Schema Registry. Exemplos: String, Integer, Boolean, Person, Address, Phone number, etc.
- Description: 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. Defina o novo tipo de campo como "String" e a seção Field properties será preenchida 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 Apply para aplicar as alterações.
Adicionar mais campos ao grupo de campos field-group-fields-2
Agora que você adicionou o campo id, é possível adicionar outros campos para capturar informações do 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 o ícone de adição (+) ao lado do objeto loyalty e preencha as informações necessárias.
Quando concluído, o objeto loyaltyTier conterá campos para id, currentThreshold, nextThreshold e effectiveDate.
Adicionar um campo de enumeração ao grupo de campos enum
Ao definir campos no Schema Editor, há algumas opções adicionais que você pode aplicar aos tipos de campos básicos para fornecer restrições adicionais 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, o objeto loyaltyTier no esquema requer um novo campo enum que descreve a classe de camada, onde o valor só pode ser uma das quatro opções possíveis. Para adicionar este campo ao esquema, selecione o ícone de adição (+) ao lado do objeto loyaltyTier e preencha os campos obrigatórios para Field name e Display name. Para Type, selecione "String".
Caixas de seleção adicionais aparecem para o campo após o tipo ter sido selecionado, incluindo caixas de seleção para Array, Enum & Suggested Values, Identity e Relationship.
Marque a caixa de seleção Enum & Suggested Values e selecione Enum. Aqui você pode inserir o Value (em camelCase) e Display Name (um nome opcional e amigável ao leitor em Title Case) para cada classe de camada de fidelidade aceitável.
Quando tiver concluído todas as propriedades de campo, selecione Apply para adicionar o campo tierClass ao objeto loyaltyTier.
Converter um objeto de vários campos em um tipo de dados datatype
O objeto loyaltyTier agora contém vários campos e representa uma estrutura de dados comum que pode ser útil em outros esquemas. O Schema Editor 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 o valor Type do campo como aquele de qualquer tipo de dados definido em Schema Registry.
Para converter o objeto loyaltyTier em um tipo de dados, selecione o campo loyaltyTier na tela e selecione Convert to new data type no lado direito do editor em Field properties.
Uma notificação é exibida, confirmando que o objeto foi convertido com êxito. Na tela você pode ver que o campo loyaltyTier agora tem um ícone de link, e o painel direito indica que ele tem um tipo de dados de "Loyalty Tier".
Em um esquema futuro, agora você pode atribuir um campo como um tipo "Loyalty Tier" e ele incluirá 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 de chave devem ser marcados como Identity campos dentro de esquemas aplicáveis.
O Experience Platform facilita a identificação de um campo de identidade através do uso de uma caixa de seleção Identity no 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 pelo grupo de campos Personal Contact Details) é um bom candidato para um campo de identidade.
identityMap 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 composição de esquema para obter mais informações.Selecione o campo personalEmail.address na tela e a caixa de seleção Identity aparecerá em Field properties. Marque a caixa e a opção para definir isso como Primary identity será exibida. Selecione esta caixa também.
Em seguida, você deve fornecer um Identity namespace da lista de namespaces predefinidos na lista suspensa. Como este campo é o endereço de email do cliente, selecione "Email" na lista suspensa. Selecione Apply para confirmar as atualizações do campo personalEmail.address.
Depois de aplicar a alteração, o ícone de 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 esquerdo em Identities.
Agora, todos os dados assimilados no campo personalEmail.address serão usados para ajudar a identificar esse indivíduo e unir uma única visualização desse cliente. Para saber mais sobre como trabalhar com identidades em Experience Platform, reveja a documentação de Identity Service.
Habilitar o esquema para uso em Real-Time Customer Profile profile
O Real-Time Customer Profile aproveita os dados de identidade em 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 ao Experience Platform.
Para que um esquema seja habilitado para uso com Real-Time Customer Profile, ele deve ter uma identidade primária definida. Você receberá uma mensagem de erro se tentar ativar um esquema sem definir primeiro uma identidade primária.
Para habilitar o esquema "Membros de Fidelidade" para uso em Profile, comece selecionando o título do esquema 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. Além dessas informações, há um botão de alternância Profile.
Selecione Profile e um popover será exibido, pedindo sua confirmação de que você deseja habilitar o esquema para Profile.
Selecione Enable para confirmar sua escolha. Você pode selecionar a opção Profile novamente para desabilitar o esquema, se desejar, mas uma vez que o esquema tenha sido salvo enquanto Profile estiver habilitado, ele não poderá mais ser desabilitado.
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. Selecione More na parte superior da exibição para exibir um menu suspenso com ações rápidas.
Excluir um esquema delete-a-schema
Um esquema pode ser excluído na interface do usuário no Editor de Esquemas usando as ações More e também nos detalhes do esquema na guia Browse. Há determinadas condições que impedem a exclusão de um esquema. Um esquema não pode ser excluído se:
- O esquema é ativado para o Perfil.
- O esquema é ativado para o Perfil e tem conjuntos de dados associados.
- O esquema tem conjuntos de dados associados, mas não está habilitado para o Perfil.
Copiar estrutura JSON copy-json-structure
Selecione Copy JSON structure para gerar uma carga de exportação para qualquer esquema na Biblioteca de Esquemas. Essa ação copia a estrutura JSON para a área de transferência. Seu JSON exportado pode ser usado para importar o esquema e quaisquer recursos relacionados para uma sandbox ou organização diferente. Isso torna simples e eficiente o compartilhamento e a reutilização de esquemas entre diferentes ambientes.
Próximas etapas e recursos adicionais
Agora que terminou de compor o esquema, você pode ver o esquema completo na tela. Selecione Save e o esquema será salvo em Schema Library, tornando-o acessível por Schema Registry.
Seu novo esquema agora pode ser usado para assimilar dados no Experience 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 as noções básicas da composição de esquema para obter mais informações sobre o controle de versão de esquema.
Agora você pode seguir o tutorial em definição de uma relação de esquema na interface para adicionar um novo campo de relação ao esquema "Membros de Fidelidade".
O esquema "Membros de fidelidade" também está disponível para ser visualizado e gerenciado usando a API Schema Registry. 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 na interface do usuário do Experience Platform.
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
O Experience Platform fornece a flexibilidade para definir um esquema com base em uma classe que é 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 esquema, consulte o manual sobre gerenciamento de esquemas na interface.