Definir um relacionamento de “muitos para um” entre dois esquemas na Real-time Customer Data Platform B2B Edition relationship-b2b

O Adobe Real-time Customer Data Platform B2B Edition fornece várias classes do Experience Data Model (XDM) que capturam entidades fundamentais de dados B2B, incluindo contas, oportunidades, campanhas e muito mais. Ao criar esquemas com base nessas classes e habilitá-los para uso no Perfil do cliente em tempo real, é possível mesclar dados de fontes diferentes em uma representação unificada chamada de esquema de união.

No entanto, os esquemas de união só podem conter campos capturados por esquemas que compartilham a mesma classe. É aqui que entram as relações de esquema. Ao implementar relacionamentos em seus esquemas B2B, você pode descrever como essas entidades de negócios se relacionam entre si e pode incluir atributos de várias classes em casos de uso de segmentação downstream.

O diagrama a seguir fornece um exemplo de como as diferentes classes B2B podem se relacionar entre si em uma implementação básica:

Relacionamentos de classe B2B

Este tutorial aborda as etapas para definir uma relação muitos para um entre dois esquemas no Real-Time CDP B2B Edition.

NOTE
Se você não estiver usando o Real-time Customer Data Platform B2B Edition ou quiser criar uma relação um para um, consulte o manual em criando uma relação um para um.
Este tutorial foca em como estabelecer manualmente relações entre esquemas B2B na interface do usuário da plataforma. Se você estiver trazendo dados de uma conexão de origem B2B, poderá usar um utilitário de geração automática para criar os esquemas, identidades e relacionamentos necessários. Consulte a documentação de origens em namespaces e esquemas B2B para obter mais informações sobre uso do utilitário de geração automática.

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 oportunidades de negócios (definidas em um esquema "Opportunities") e sua conta de negócios associada (definida em um esquema "Accounts").

As relações de esquema são representadas por um campo dedicado dentro de um esquema de origem que faz referência ao campo de identidade primário de um esquema de referência. Nas etapas a seguir, "Opportunities" serve como esquema de origem, enquanto "Accounts" atua como esquema de referência.

Noções básicas sobre identidades em relacionamentos B2B

Para estabelecer uma relação, o schema de referência deve ter uma identidade primária definida. Ao definir uma identidade primária para uma entidade B2B, lembre-se de que as IDs de entidade baseadas em sequência podem se sobrepor se você as estiver coletando em diferentes sistemas ou locais, o que pode levar a conflitos de dados na Platform.

Para levar em conta isso, todas as classes B2B padrão contêm campos "key" que estão em conformidade com o tipo de dados B2B Source. Esse tipo de dados fornece campos para um identificador de sequência para a entidade B2B, juntamente com outras informações contextuais sobre a origem do identificador. Um desses campos, sourceKey, concatena os valores dos outros campos no tipo de dados para produzir um identificador totalmente exclusivo para a entidade. Este campo deve ser sempre usado como a identidade principal para esquemas de entidade B2B.

campo sourceKey

NOTE
Ao definir um campo XDM como uma identidade, você deve fornecer um namespace de identidade para definir a identidade em. Pode ser um namespace padrão fornecido pelo Adobe ou um namespace personalizado definido por sua organização. Na prática, o namespace é simplesmente uma sequência contextual e pode ser definido com qualquer valor desejado, desde que seja significativo para sua organização categorizar o tipo de identidade. Consulte a visão geral em namespaces de identidade para obter mais informações.

Para fins de referência, as seções a seguir descrevem a estrutura de cada esquema usado neste tutorial antes que uma relação seja definida. Anote onde as identidades primárias foram definidas na estrutura do esquema e nos namespaces personalizados que elas usam.

Esquema de oportunidades

O esquema de origem "Opportunities" é baseado na classe Oportunidade Comercial XDM. Um dos campos fornecidos pela classe, opportunityKey, serve como o identificador do esquema. Especificamente, o campo sourceKey sob o objeto opportunityKey é definido como a identidade primária do esquema sob um namespace personalizado chamado B2B Opportunity.

Conforme visto em Propriedades do Campo, este esquema foi habilitado para uso em Real-Time Customer Profile.

O esquema de Oportunidades no Editor de Esquemas com o objeto opportunityKey e a opção Enable for profile foram realçados.

Esquema Accounts

O esquema de referência "Accounts" é baseado na classe Conta XDM. O campo accountKey de nível raiz contém o sourceKey que atua como sua identidade primária em um namespace personalizado chamado B2B Account. Este esquema também foi ativado para uso no Perfil.

O esquema Contas no Editor de Esquemas com o objeto accountKey e a opção Enable for profile realçados.

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

Para definir uma relação entre dois esquemas, o esquema de origem deve ter um campo dedicado que indique a identidade primária do esquema de referência. As classes B2B padrão incluem campos de chave de origem dedicada para entidades de negócios comumente relacionadas. Por exemplo, a classe Oportunidade Comercial XDM contém campos de chave de origem para uma conta relacionada (accountKey) e uma campanha relacionada (campaignKey). No entanto, você também pode adicionar outros campos B2B Source ao esquema usando grupos de campos personalizados se precisar de mais do que os componentes padrão.

NOTE
Atualmente, somente as relações muitos para um e um para um podem ser definidas de um esquema de origem para um esquema de referência. Para relações um para muitos, você deve definir o campo de relacionamento no esquema que representa o "muitos".

Para definir um campo de relação, selecione o campo em questão na tela, seguido por Adicionar relação na barra lateral Propriedades de esquema. No caso do esquema Opportunities, este é o campo accountKey.sourceKey, já que o objetivo é estabelecer uma relação muitos para um com uma conta.

O Editor de Esquemas com o campo sourceKey e a relação Add realçados.

A caixa de diálogo Adicionar relação é exibida. Use esta caixa de diálogo para especificar detalhes do relacionamento. O tipo de relação é definido como Muitos para um por padrão.

A caixa de diálogo Adicionar relação com relação de esquema Muitos para um foi realçada.

Em Esquema de Referência, use a barra de pesquisa ou o menu suspenso para localizar o nome do esquema de referência. Quando você realça o nome do esquema de referência, o campo Namespace de identidade de referência atualiza automaticamente para o namespace da identidade principal do esquema de referência.

NOTE
A lista de esquemas de referência disponíveis é filtrada para conter apenas esquemas adequados. Os esquemas devem ter uma identidade primária atribuída e ser uma classe B2B ou a classe Perfil Individual. Os esquemas de classe de cliente potencial não podem ter relacionamentos.

A caixa de diálogo Adicionar relacionamento com os campos Esquema de Referência e Namespace de Identidade de Referência foi realçada.

Em Nome do Relacionamento do Esquema Atual e Nome do Relacionamento do Esquema de Referência, forneça nomes amigáveis para o relacionamento no contexto dos esquemas de origem e de referência, respectivamente. Quando terminar, selecione Aplicar para confirmar as alterações e salvar a relação.

NOTE
Os nomes dos relacionamentos devem ter 35 caracteres ou menos.

A caixa de diálogo Adicionar relacionamento com os campos Nome da Relação foi realçada.

A tela será exibida novamente, com o campo de relacionamento agora marcado com o nome amigável fornecido anteriormente. O nome do relacionamento também está listado no painel esquerdo para facilitar a referência.

O Editor de Esquemas com o novo nome de relação aplicado.

Se você visualizar a estrutura do esquema de referência, o marcador de relacionamento aparecerá ao lado do campo de identidade principal do esquema e no painel esquerdo.

O esquema de destino no Editor de Esquemas com o novo marcador de relação realçado.

Editar uma relação de esquema B2B edit-schema-relationship

Depois que uma relação de esquema for estabelecida, selecione o campo de relação no esquema de origem seguido por Editar relação.

NOTE
Para exibir todas as relações associadas, selecione o campo de identidade principal no esquema de referência seguido por Exibir relações.
O Editor de esquemas com um campo de relacionamento selecionado e Exibir relacionamento realçado. {width="100" modal="regular"}

O Editor de Esquemas com um campo de relação e Editar relação está realçado.

A caixa de diálogo Editar relação é exibida. Nessa caixa de diálogo, é possível alterar o esquema de referência e os nomes dos relacionamentos ou excluir os relacionamentos. O tipo de relação muitos para um não pode ser alterado.

A caixa de diálogo Editar relação.

Para manter a integridade dos dados e evitar interrupções na segmentação e em outros processos, considere as seguintes diretrizes ao gerenciar relações de esquema com conjuntos de dados vinculados:

  • Evite excluir diretamente as relações se um esquema estiver associado a um conjunto de dados, pois isso pode afetar negativamente a segmentação. Em vez disso, exclua o conjunto de dados associado antes de remover a relação.
  • Não é possível alterar o esquema de referência sem primeiro excluir a relação existente. No entanto, isso deve ser feito com cuidado, pois excluir uma relação com um conjunto de dados associado pode causar consequências não intencionais.
  • A adição de novas relações a um esquema com conjuntos de dados vinculados existentes pode não funcionar conforme o esperado e pode levar a possíveis conflitos.

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.

A guia Relações no espaço de trabalho Esquemas.

Próximas etapas

Seguindo este tutorial, você criou com êxito uma relação muitos para um entre dois esquemas usando o Schema Editor. Depois que os dados forem assimilados usando conjuntos de dados com base nesses esquemas e esses dados forem ativados no armazenamento de dados do Perfil, você poderá usar atributos de ambos os esquemas para casos de uso de segmentação de várias classes.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07