Definir um relacionamento de “um para um” entre dois esquemas usando o Schema Editor relationship-ui

A capacidade de entender os relacionamentos entre seus clientes e as interações deles com sua marca em vários canais é uma parte importante do Adobe Experience Platform. A definição dessas relações na estrutura dos esquemas do Experience Data Model (XDM) permite que você obtenha insights complexos sobre os dados do cliente.

Embora as relações de esquema possam ser inferidas por meio do uso do esquema 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 esquemas pertencentes a classes diferentes, um campo de relação dedicado deve ser adicionado a um esquema de origem, que faz referência à identidade do outro esquema relacionado.

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

Introdução

Este tutorial requer entendimento prático do XDM System e do Editor de Esquemas na interface do usuário do Experience Platform. Antes de iniciar este tutorial, reveja a seguinte documentação:

Definir um esquema de origem e de referência

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

As relações de esquema são representadas por um campo dedicado em um esquema de origem que aponta para outro campo em um esquema de referência. Nas etapas a seguir, "Loyalty Members" será o esquema de origem, enquanto "Hotels" atuará como o esquema de referência.

As seções a seguir descrevem a estrutura de cada esquema usado neste tutorial antes que uma relação seja definida.

Esquema Loyalty Members

O esquema de origem "Loyalty Members" é baseado na classe XDM Individual Profile, contendo o campo que descreve os membros de um programa de fidelidade. Um desses campos, personalEmail.addess, serve como a identidade principal do esquema no namespace Email. Conforme visto em Propriedades do Esquema, este esquema foi habilitado para uso em Real-Time Customer Profile.

Esquema Hotels

O esquema de referência "Hotels" é baseado em uma classe "Hotels" personalizada e contém campos que descrevem um hotel. Para participar de uma relação, o esquema de referência também deve ter uma identidade primária definida e estar habilitado para Perfil. Nesse caso, _tenantId.hotelId atua como a identidade principal do esquema, usando um namespace de identidade personalizado "Hotel ID".

Criar um grupo de campos de relacionamento

Para definir uma relação entre dois esquemas, o esquema de origem deve ter um campo dedicado que indicará a identidade principal do esquema de referência. Você pode adicionar este campo ao esquema de origem criando um novo grupo de campos de esquema ou estendendo um existente.

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

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

Quando terminar, selecione Aplicar.

O campo preferredHotel atualizado aparece na tela, localizada sob um objeto _tenantId, já que é um campo personalizado. Selecione Salvar para finalizar as alterações no esquema.

Definir um campo de relacionamento para o esquema de origem relationship-field

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

Selecione o campo preferredHotel na tela e selecione Adicionar relacionamento na barra lateral Propriedades do campo.

A caixa de diálogo Adicionar relação é exibida. Nessa caixa de diálogo, é possível definir os parâmetros necessários para configurar um campo de relacionamento. Para usuários B2C do Real-Time CDP, você pode somente definir uma relação um para um entre o esquema de origem e de referência.

Use a lista suspensa para Esquema de referência e selecione o esquema de referência para a relação ("Hotels" neste exemplo).

O namespace de identidade do esquema de referência (neste caso, "Hotel ID") é preenchido automaticamente em Namespace de identidade de referência. Selecione Aplicar quando terminar.

O campo preferredHotel agora está realçado como uma relação na tela, exibindo o nome do esquema de referência. Selecione Salvar para salvar suas alterações e concluir o fluxo de trabalho.

Editar um campo de relacionamento existente edit-relationship

Para alterar o esquema de referência, selecione um campo com uma relação existente e selecione Editar relação na barra lateral Propriedades do campo.

A caixa de diálogo Editar relação é exibida. Aqui, você pode seguir o processo descrito em definindo um campo de relação ou excluir a relação. Selecione Excluir relação para remover a relação com o esquema de referência.

Filtrar e pesquisar relacionamentos filter-and-search

Você pode filtrar e pesquisar relações específicas em seus esquemas na guia Relações do espaço de trabalho Esquemas. Você pode usar essa visualização para localizar e gerenciar rapidamente seus relacionamentos. Leia o documento em explorando recursos de esquema para obter instruções detalhadas sobre as opções de filtragem.

Próximas etapas

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