Defina uma relação um para um entre dois schemas usando o Schema Editor

A capacidade de entender os relacionamentos entre seus clientes e suas interações com a marca em vários canais é uma parte importante do Adobe Experience Platform. Definir esses relacionamentos dentro da estrutura de Experience Data Model Os esquemas (XDM) permitem que você obtenha insights complexos sobre os dados do cliente.

Embora os relacionamentos de schema 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. Para estabelecer uma relação entre dois schemas pertencentes a classes diferentes, um campo de relacionamento dedicado deve ser adicionado a um schema de origem, que faz referência à identidade do outro schema relacionado.

Este documento fornece um tutorial para definir uma relação entre dois esquemas usando o Editor de esquemas na Experience Platform interface do usuário. Para obter etapas sobre como definir relações de esquema usando a API, consulte o tutorial em definição de um relacionamento usando a API do Registro de Esquema.

OBSERVAÇÃO

Para obter etapas sobre como criar uma relação muitos para um no Adobe Real-time Customer Data Platform B2B Edition, consulte o guia sobre criação de relações B2B.

Introdução

Este tutorial requer uma compreensão funcional do XDM System e o Editor de esquemas na Experience Platform IU. Antes de iniciar este tutorial, reveja a seguinte documentação:

Definir um schema de referência e de origem

Espera-se que você já tenha criado os dois schemas que serão definidos na relação. Para fins de demonstração, este tutorial cria uma relação entre membros do programa de fidelidade de uma organização (definido em um "Loyalty Members" schema) e seu hotel favorito (definido em um "Hotels" schema).

IMPORTANTE

Para estabelecer uma relação, ambos os esquemas devem ter identidades primárias definidas e devem ser habilitados para Real-Time Customer Profile. Consulte a seção sobre ativar um esquema para usar no Perfil no tutorial de criação de esquema se você precisar de orientação sobre como configurar seus esquemas adequadamente.

Os relacionamentos de schema são representados por um campo dedicado em um esquema de origem que aponta para outro campo dentro de um schema de referência. Nas etapas a seguir, "Loyalty Members" será o schema de origem, enquanto "Hotels" atuará como o schema de referência.

As seções a seguir descrevem a estrutura de cada schema usado neste tutorial antes que um relacionamento seja definido.

Loyalty Members schema

O schema de origem "Loyalty Members" se baseia no XDM Individual Profile classe , que contém campo que descreve membros de um programa de fidelidade. Um desses campos, personalEmail.addess, serve como a identidade primária do schema no Email namespace. Conforme visto em Propriedades do esquema, este esquema foi ativado para uso em Real-Time Customer Profile.

Hotels schema

O schema de referência "Hotels" se baseia em um " personalizadoHotels" e contém campos que descrevem um hotel. Para participar de um relacionamento, o schema de referência também deve ter uma identidade primária definida e estar habilitado para Perfil. Nesse caso, _tenantId.hotelIdatua como a identidade primária do esquema, usando um " personalizadoHotel ID" namespace de identidade.

Ativar para Perfil

OBSERVAÇÃO

Para saber como criar namespaces de identidade personalizados, consulte Documentação do Serviço de identidade.

Criar um grupo de campos de relação

OBSERVAÇÃO

Essa etapa só será necessária se o esquema de origem não tiver um campo de tipo string dedicado para ser usado como ponteiro para a identidade primária do esquema de referência. Se esse campo já estiver definido no esquema de origem, pule para a próxima etapa de definição de um campo de relacionamento.

Para definir uma relação entre dois schemas, o schema de origem deve ter um campo dedicado que indicará a identidade primária do schema de referência. É possível adicionar esse campo ao schema de origem criando um novo grupo de campos de esquema ou estendendo um existente.

No caso de Loyalty Members , um novo preferredHotel será adicionado para indicar o hotel preferencial do membro do programa de fidelidade para visitas da empresa. Comece selecionando o ícone de adição (+) ao lado do nome do schema de origem.

Um novo espaço reservado para campo aparece na tela. Em Propriedades do campo, forneça um nome de campo e nome de exibição para o campo e defina seu tipo como "String". Em Atribuir a, selecione um grupo de campos existente a ser estendido ou digite um nome exclusivo para criar um novo grupo de campos. Nesse caso, um novo "Preferred Hotel" grupo de campos é criado.

Quando terminar, selecione Aplicar.

O arquivo preferredHotel aparece na tela, localizada abaixo de um _tenantId desde que seja um campo personalizado. Selecionar Salvar para finalizar as alterações no schema.

Definir um campo de relacionamento para o schema de origem

Depois que o schema de origem tiver um campo de referência dedicado definido, você poderá designá-lo como um campo de relacionamento.

OBSERVAÇÃO

As etapas abaixo abordam como definir um campo de relação usando os controles do painel direito na tela. Se você tiver acesso ao Real-Time CDP B2B Edition, também poderá definir uma relação um para um usando o mesma caixa de diálogo como ao criar relacionamentos muitos para um.

Selecione o preferredHotel na tela, role para baixo Propriedades do campo até que o Relação será exibida. Marque a caixa de seleção para revelar os parâmetros necessários para configurar um campo de relacionamento.

Selecione a lista suspensa para Esquema de referência e selecione o schema de referência para o relacionamento ("Hotels" neste exemplo). Em Namespace da identidade de referência, selecione o namespace do campo de identidade do schema de referência (neste caso, "Hotel ID"). Selecionar Aplicar quando terminar.

O preferredHotel agora é destacado como um relacionamento na tela, exibindo o nome do schema de referência. Selecionar Salvar para salvar suas alterações e concluir o fluxo de trabalho.

Próximas etapas

Ao seguir este tutorial, você criou com êxito uma relação um para um entre dois schemas usando o Schema Editor. Para obter etapas sobre como definir relações usando a API, consulte o tutorial em definição de um relacionamento usando a API do Registro de Esquema.

Nesta página