Crie um esquema usando o Schema Editor

A interface do usuário do Adobe Experience Platform permite criar e gerenciar esquemas Experience Data Model (XDM) em uma tela visual interativa chamada de Schema Editor. Este tutorial aborda como criar um schema usando o Schema Editor.

OBSERVAÇÃO

Para fins de demonstração, as etapas neste tutorial envolvem a criação de um schema de exemplo que descreve membros de um programa de fidelidade do cliente. Embora você possa usar essas etapas para criar um schema diferente para seus próprios propósitos, é recomendável seguir primeiro juntamente com a criação do schema de exemplo para aprender os recursos do Schema Editor.

Se preferir compor um schema usando a API Schema Registry, comece lendo o Schema Registry guia do desenvolvedor antes de tentar o tutorial em criar um schema usando a API.

Introdução

Este tutorial requer uma compreensão funcional dos vários aspectos do Adobe Experience Platform envolvidos na criação do schema. Antes de iniciar este tutorial, reveja a documentação dos seguintes conceitos:

  • Experience Data Model (XDM): A estrutura padronizada pela qual Platform organiza os dados de experiência do cliente.
    • Noções básicas da composição do schema: 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 e em tempo real com base em dados agregados de várias fontes.

Abra o espaço de trabalho Schemas

A área de trabalho Schemas na interface do usuário Platform fornece uma visualização do Schema Library, permitindo visualizar o gerenciamento dos schemas disponíveis para sua organização. O espaço de trabalho também inclui a Schema Editor, a tela na qual você pode compor um schema neste 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 schemas (uma representação do Schema Library) que você pode visualizar e personalizar. A lista inclui o nome, o tipo, a classe e o comportamento (registro ou série de tempo) em que o schema se baseia, bem como a data e a hora em que o schema foi modificado pela última vez.

Consulte o guia sobre exploração de recursos XDM existentes na interface do usuário para obter mais informações.

Criar e nomear um esquema

Para começar a compor um schema, selecione Create schema no canto superior direito do espaço de trabalho Schemas. Um menu suspenso é exibido, dando a você a opção de escolher entre as classes principais Perfil individual XDM e ExperiênciaEvento XDM. Se essas classes não atenderem aos seus propósitos, você também poderá selecionar Procurar para escolher de outras classes disponíveis ou criar uma nova classe.

Para os fins deste tutorial, selecione Perfil individual XDM.

Como você escolheu uma classe XDM padrão para basear o esquema, a caixa de diálogo Adicionar grupo de campos é exibida, permitindo que você comece imediatamente a adicionar campos ao esquema. Por enquanto, selecione Cancelar para sair da caixa de diálogo.

O Schema Editor é exibido. Essa é a tela sobre a qual você irá compor o esquema. Um schema sem título é criado automaticamente na seção Structure da tela ao chegar ao editor, juntamente com os campos padrão incluídos em todos os schemas com base nessa classe. A classe atribuída ao schema também é listada em Class na seção Composition.

OBSERVAÇÃO

Você pode alterar a classe de um schema em qualquer ponto durante o processo de composição inicial antes que o schema tenha sido salvo, mas isso deve ser feito com extremo cuidado. Os grupos de campos são compatíveis apenas com determinadas classes e, portanto, alterar a classe redefinirá a tela e quaisquer campos adicionados.

Use os campos no lado direito do editor para fornecer um nome de exibição e uma descrição opcional para o esquema. Depois que um nome é inserido, a tela é atualizada para refletir o novo nome do schema.

Há várias considerações importantes a serem feitas ao decidir um nome para o esquema:

  • Os nomes de esquema devem ser curtos e descritivos para que o esquema possa ser facilmente encontrado posteriormente.
  • Os nomes de esquema devem ser exclusivos, o que significa que também devem ser específicos o suficiente para que não sejam reutilizados no futuro. Por exemplo, se sua organização tivesse programas de fidelidade separados para diferentes marcas, seria recomendável nomear seu esquema como "Membros da Fidelidade da Marca A" para facilitar a distinção entre outros esquemas relacionados à fidelidade que você poderá definir posteriormente.
  • Você também pode usar a descrição do schema para fornecer quaisquer informações contextuais adicionais relacionadas ao schema.

Este tutorial compõe um schema para assimilar dados relacionados aos membros de um programa de fidelidade e, portanto, o schema é chamado de "Membros de fidelidade".

Adicionar 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 são frequentemente usados em conjunto para descrever um conceito específico. Este tutorial usa grupos de campos para descrever os membros do programa de fidelidade e capturar informações-chave 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 deve ser usado somente com uma classe específica, portanto, a caixa de diálogo lista apenas grupos de campos compatíveis com a classe selecionada (neste caso, a classe XDM Individual Profile ). Se você estiver usando uma classe XDM padrão, a lista de grupos de campo será classificada de forma inteligente com base na popularidade do uso.

Selecionar um grupo de campos na lista faz com que ele apareça no painel direito. É possível 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 atualmente selecionado, permitindo que você visualize 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. Também é possível 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 terminar de visualizar para retornar à caixa de diálogo de seleção de grupo de campos.

Para este tutorial, selecione o grupo de campos Detalhes demográficos e selecione Adicionar grupo de campos.

A tela do esquema é 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 fornecidos na tela.

Esse grupo de campos contribui com vários campos sob o nome de nível superior person com o tipo de dados "Pessoa". Este grupo de campos descreve informações sobre um indivíduo, incluindo nome, data de nascimento e gênero.

OBSERVAÇÃO

Lembre-se de que os campos podem usar tipos escalares (como string, integer, matriz ou data), bem como qualquer tipo de dados (um grupo de campos que representa um conceito comum) definido dentro do Schema Registry.

Observe que o campo name tem um tipo de dados de "Nome da pessoa", 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 que contribuem para a estrutura do schema.

Adicionar outro grupo de campos

Agora é possível repetir as mesmas etapas para adicionar outro grupo de campos. Ao visualizar 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 evita a duplicação acidental de grupos de campos que já foram incluídos no esquema atual.

Para este tutorial, selecione o grupo de campos "Personal Contact Details" na caixa de diálogo e selecione Adicionar grupo de campos para adicioná-lo ao esquema.

Depois de adicionada, a tela reaparece. "Detalhes do Contato Pessoal" agora está listado em Grupos de campos na seção Composição, e os campos para endereço residencial, telefone celular e muito mais foram adicionados em Estrutura.

Semelhante ao campo name, os campos que você acabou de adicionar representam os conceitos de vários campos. Por exemplo, homeAddress tem um tipo de dados de "Endereço postal" e mobilePhone tem um tipo de dados de "Número de telefone". Você pode selecionar cada um desses campos para expandi-los e ver os campos adicionais incluídos no tipo de dados.

Definir um grupo de campos personalizado

O schema "Loyalty Members" destina-se a capturar dados relacionados aos membros de um programa de fidelidade, de modo que exigirá alguns campos específicos relacionados a fidelidade.

Existe um grupo de campos padrão Detalhes da Fidelidade que você pode adicionar ao schema para capturar campos comuns relacionados a um programa de fidelidade. Embora seja altamente recomendável usar grupos de campos padrão para representar conceitos capturados por seus esquemas, a estrutura do grupo de campos de fidelidade padrão pode não ser capaz de capturar todos os dados relevantes para seu programa de fidelidade específico. Nesse cenário, você pode optar por definir um novo grupo de campos personalizados para capturar esses campos.

Abra a caixa de diálogo Adicionar grupo de campos novamente, mas desta vez selecione Criar novo grupo de campos próximo à parte superior. Em seguida, é necessário fornecer um nome de exibição e uma descrição para o grupo de campos.

Assim como com os nomes de classe, o nome do grupo de campos deve ser curto e simples, descrevendo o que o grupo de campos contribuirá para o schema. Eles também são exclusivos, portanto, você não poderá reutilizar o nome e, portanto, deve garantir que seja específico o suficiente.

Para este tutorial, nomeie o novo grupo de campos "Detalhes de fidelidade".

Selecione Adicionar grupo de campos para retornar ao Schema Editor. "Detalhes da Fidelidade" agora deve aparecer em Grupos de campos no lado esquerdo da tela, mas ainda não há campos associados a ela e, portanto, nenhum novo campo aparece em Estrutura.

Adicionar campos ao grupo de campos

Depois de criar o grupo de campos "Detalhes de fidelidade", é hora de definir os campos que o grupo de campos contribuirá para o esquema.

Para começar, selecione o nome do grupo de campos na seção Field groups. Depois disso, as propriedades do grupo de campos aparecerão no lado direito do editor e um ícone de mais (+) aparecerá ao lado do nome do schema em Estrutura.

Selecione o ícone de mais (+) ao lado de "Loyalty Members" para criar um novo nó na estrutura. Esse nó (chamado _tenantId neste exemplo) representa a ID do locatário da Organização IMS, precedida por um sublinhado. A presença da ID do locatário indica que os campos que você está adicionando estão contidos no namespace da sua organização.

Em outras palavras, os campos que você está adicionando são exclusivos de sua organização e serão salvos em Schema Registry em uma área específica acessível somente à sua organização. Os campos definidos devem sempre ser adicionados ao namespace do locatário para evitar colisões com nomes de outras classes padrão, grupos de campos, tipos de dados e campos.

Dentro desse nó namespaced há um "New Field". Este é o início do grupo de campos "Detalhes da Fidelidade".

Usando os controles no lado direito do editor, comece criando um campo loyalty com o tipo "Object" que será usado para manter seus campos relacionados à fidelidade. Quando terminar, selecione Aplicar.

As alterações são aplicadas e o objeto loyalty recém-criado é exibido. Selecione o ícone de mais (+) ao lado do objeto para adicionar mais campos relacionados à fidelidade. Um "New Field" é exibido e a seção Field properties é visível no lado direito da tela.

Cada campo requer as seguintes informações:

  • Nome do campo: o nome do campo, escrito em camel case. Exemplo: loyaltyLevel
  • Nome de exibição: o nome do campo, escrito no caso de título. 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: Cadeia de caracteres, Número inteiro, Booliano, Pessoa, Endereço, Número de telefone, etc.
  • Descrição: Uma descrição opcional do campo deve ser incluída, escrita em caso de frase, com no máximo 200 caracteres.

O primeiro campo para o objeto Loyalty será uma string chamada loyaltyId. Ao definir o tipo do novo campo como "String", a seção Field properties é preenchida com várias opções para aplicar restrições, incluindo valor padrão, formato e comprimento máximo.

Diferentes opções de restrição estão disponíveis dependendo do tipo de dados selecionado. Como loyaltyId será um endereço de email, selecione "email" no menu suspenso Formato. Selecione Aplicar para aplicar as alterações.

Adicionar mais campos ao grupo de campos

Agora que você adicionou o campo loyaltyId, é possível adicionar campos adicionais para capturar informações relacionadas à fidelidade, como:

  • Pontos (número inteiro)
  • Membro desde (data)

Para adicionar cada campo ao schema, selecione o ícone de adição (+)ao lado do objeto loyalty e preencha as informações necessárias.

Quando concluído, o objeto de Fidelidade conterá campos para ID de fidelidade, pontos e desde-o-membro.

Adicionar um campo enum ao grupo de campos

Ao definir campos no Schema Editor, há algumas opções adicionais que podem ser aplicadas aos tipos básicos de campos para fornecer restrições adicionais sobre os dados que o campo pode conter. Os casos de uso dessas restrições são explicados na tabela a seguir:

Restrição Descrição
Obrigatório Indica que o campo é obrigatório para a assimilação de dados. Qualquer dado carregado em um conjunto de dados com base nesse esquema que não contenha esse campo falhará ao ser assimilado.
Matriz Indica que o campo contém uma matriz de valores, cada um com o tipo de dados especificado. Por exemplo, usar essa restrição em um campo com um tipo de dados de "String" especifica que o campo conterá uma matriz de cadeias de caracteres.
Enum Indica que este campo deve conter um dos valores de uma lista enumerada de valores possíveis.
Identidade Indica que este campo é um campo de identidade. Mais informações sobre campos de identidade são fornecidas posteriormente neste tutorial.
Relação Embora os relacionamentos de esquema possam ser inferidos por meio do uso do schema de união e Real-time Customer Profile, isso se aplica somente a esquemas que compartilham a mesma classe. A restrição Relationship indica que este campo faz referência à identidade primária de um esquema com base numa classe diferente, implicando uma relação entre os dois esquemas. Consulte o tutorial em definindo um relacionamento para obter mais informações.
OBSERVAÇÃO

Todos os campos obrigatórios, de identidade ou de relacionamento são mostrados no painel esquerdo, permitindo localizar esses campos facilmente, independentemente da complexidade do esquema.

Para este tutorial, o objeto “loyalty” no schema requer um novo campo enum que descreve o “nível de fidelidade” de um cliente, onde o valor pode ser apenas uma das quatro opções possíveis. Para adicionar esse campo ao schema, selecione o ícone de mais (+) ao lado do objeto loyalty e preencha os campos obrigatórios para Nome do campo e Nome de exibição. Para Type, selecione “String”.

Caixas de seleção adicionais aparecem para o campo depois que seu tipo é selecionado, incluindo caixas de seleção para Array, Enum e Identity.

Marque a caixa de seleção Enum para abrir a seção Enum values abaixo. Aqui, você pode inserir o Value (em camelCase) e o Label (um nome opcional e amigável para o leitor no Título) para cada nível de fidelidade aceitável.

Após concluir todas as propriedades do campo, selecione Apply para adicionar o campo "loyaltyLevel" ao objeto loyalty.

Converter um objeto de vários campos em um tipo de dados

O objeto loyalty agora contém vários campos específicos de fidelidade e representa uma estrutura de dados comum que pode ser útil em outros schemas. 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 dentro de um esquema. Isso é feito definindo o valor Type do campo como aquele de qualquer tipo de dados definido no Schema Registry.

Para converter o objeto loyalty em um tipo de dados, selecione o campo loyalty em Estrutura e selecione Converter em novo tipo de dados no lado direito do editor em Propriedades do campo. Uma tampa verde é exibida, confirmando que o objeto foi convertido com êxito.

Agora, ao olhar em Estrutura, você pode ver que o campo loyalty tem um tipo de dados de "Loyalty" e os campos têm pequenos ícones de bloqueio ao seu lado, indicando que não são mais campos individuais, mas sim parte de um tipo de dados de vários campos.

Em um schema futuro, agora é possível atribuir um campo como um tipo "Loyalty" e ele incluirá automaticamente campos para ID, nível de fidelidade, membro desde e pontos.

OBSERVAÇÃO

Você também pode criar e editar tipos de dados personalizados independentemente dos esquemas de edição. Consulte o guia sobre criação e edição de tipos de dados para obter mais informações.

Pesquisar e filtrar campos de esquema

O esquema agora contém vários grupos de campos além dos campos fornecidos pela 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 à esquerda para filtrar os campos exibidos somente para aqueles fornecidos pelos grupos de campos em que está interessado.

Se você 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 foram fornecidos.

IMPORTANTE

A função de pesquisa considera todos os filtros de grupo de campos selecionados ao exibir campos correspondentes. Se uma consulta de pesquisa não estiver exibindo os resultados esperados, talvez seja necessário verificar novamente se você não está filtrando nenhum grupo de campo relevante.

Definir um campo de esquema como um campo de identidade

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 da ciência de dados e muito mais. Para compilar dados com base em identidades individuais, os campos principais devem ser marcados como campos Identity nos esquemas aplicáveis.

Experience Platform facilita a identificação de um campo de identidade por meio do uso de uma caixa de seleção ​Identificador no Schema Editor. No entanto, você deve determinar qual campo é o melhor candidato a usar como identidade, com base na natureza de seus dados.

Por exemplo, pode haver milhares de membros do programa de fidelidade pertencentes ao mesmo "nível de fidelidade", mas cada membro do programa de fidelidade tem um loyaltyId exclusivo (que neste caso é o endereço de email de cada membro). O fato de loyaltyId ser um identificador exclusivo para cada membro faz dele um bom candidato para um campo de identidade, enquanto loyaltyLevel não é.

IMPORTANTE

As etapas descritas abaixo abordam como adicionar um descritor de identidade a um campo de esquema existente. Como alternativa à definição de campos de identidade na estrutura do próprio schema, também é possível usar um campo identityMap para conter informações de identidade.

Se você planeja usar identityMap, lembre-se de que isso substituirá qualquer identidade primária adicionada ao schema diretamente. Consulte a seção identityMap no básico do guia de composição de schema para obter mais informações.

Na seção Estrutura do editor, selecione o campo loyaltyId e a caixa de seleção Identidade aparece em Propriedades de campo. Marque a caixa e a opção para definir isso quando a Primary identity for exibida. Selecione essa caixa também.

OBSERVAÇÃO

Cada schema pode conter apenas um campo de identidade primário. Depois que um campo de esquema tiver sido definido como a identidade primária, você receberá uma mensagem de erro se, posteriormente, tentar definir outro campo de identidade no esquema como primário.

Em seguida, você deve fornecer um Namespace de identidade da lista de namespaces predefinidos na lista suspensa. Como loyaltyId é o endereço de email do cliente, selecione "Email" na lista suspensa. Selecione Aplicar para confirmar as atualizações no campo loyaltyId.

OBSERVAÇÃO

Para obter uma lista de namespaces padrão e suas definições, consulte a Identity Service documentação.

Depois de aplicar a alteração, o ícone para loyaltyId mostra um símbolo de impressão digital, indicando que agora é um campo de identidade.

Agora, todos os dados assimilados no campo loyaltyId 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, consulte a documentação Identity Service.

Ative o esquema para usar em Real-time Customer Profile

Real-time Customer Profile O usa os dados de identidade do Experience Platform para fornecer uma visualização holística de cada cliente individual. O serviço cria perfis robustos e de 360° de atributos do cliente, bem como contas com carimbos de data e hora de cada interação que os clientes tiveram em qualquer sistema integrado com Experience Platform.

Para que um schema seja ativado para uso com Real-time Customer Profile, ele deve ter uma identidade primária definida. Você receberá uma mensagem de erro ao tentar ativar um esquema sem primeiro definir uma identidade primária.


Para ativar o schema "Membros de Fidelidade" para uso em Profile, comece selecionando "Loyalty Members" na seção Estrutura do editor.

No lado direito do editor, são mostradas informações sobre o schema, incluindo o nome de 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 provedor será exibido, solicitando que você confirme que deseja habilitar o schema para Profile.


AVISO

Depois que um schema é ativado para Real-time Customer Profile e salvo, ele não pode ser desativado.

Selecione Enable para confirmar sua escolha. Você pode selecionar a opção Profile novamente para desativar o schema, se desejar, mas uma vez que o schema foi salvo enquanto Profile está ativado, ele não poderá mais ser desativado.

Próximas etapas e recursos adicionais

Agora que você terminou de compor o schema, é possível ver o schema completo na tela. Selecione Save e o esquema será salvo no Schema Library, tornando-o acessível pelo Schema Registry.

O novo schema agora pode ser usado para assimilar dados em Platform. Lembre-se de que, uma vez que o schema tenha sido usado para assimilar dados, somente alterações aditivas poderão ser feitas. Consulte as noções básicas da composição do schema para obter mais informações sobre o controle de versão do schema.

Agora você pode seguir o tutorial em definindo uma relação de schema na interface do usuário para adicionar um novo campo de relacionamento ao schema "Membros de fidelidade".

O schema "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

AVISO

A interface Platform mostrada nos vídeos a seguir está desatualizada. Consulte a documentação acima para obter as capturas de tela e a funcionalidade mais recentes da interface do usuário.

O vídeo a seguir mostra como criar um esquema simples na interface do usuário Platform.

O vídeo a seguir destina-se a reforçar sua compreensão sobre como trabalhar com grupos e classes de campo.

Apêndice

As seções a seguir fornecem informações adicionais sobre o uso do Schema Editor.

Criar uma nova classe

Experience Platform O oferece a flexibilidade para definir um schema com base em uma classe exclusiva para sua organização. Para saber como criar uma nova classe, consulte o guia em criar e editar classes na interface do usuário.

Alterar a classe de um schema

Você pode alterar a classe de um schema em qualquer ponto durante o processo de composição inicial antes que o schema tenha sido salvo.

AVISO

A reatribuição da classe para um schema deve ser feita com extremo cuidado. Os grupos de campos são compatíveis apenas com determinadas classes e, portanto, alterar a classe redefinirá a tela e quaisquer campos adicionados.

Para saber como alterar a classe de um schema, consulte o guia em gerenciar schemas na interface do usuário.

Nesta página