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:
This tutorial covers the steps to define a many-to-one relationship between two schemas in Real-Time CDP B2B Edition.
Introdução
This tutorial requires a working understanding of XDM System and the Schema Editor in the Experience Platform UI. Antes de iniciar este tutorial, reveja a seguinte documentação:
- XDM System in Experience Platform: An overview of XDM and its implementation in Experience Platform.
- Basics of schema composition: An introduction of the building blocks of XDM schemas.
- Create a schema using the Schema Editor: A tutorial covering the basics of how to build and edit schemas in the UI.
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 principal 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 no Experience 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.
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 XDM Business Opportunity. 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.
Como visto em Field Properties, este esquema foi habilitado para uso em Real-Time Customer Profile.
Esquema Accounts
O esquema de referência "Accounts" é baseado na classe XDM Account. 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.
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 XDM Business Opportunity 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.
Para definir um campo de relação, selecione o campo em questão na tela, seguido por Add relationship na barra lateral Schema properties. No caso do esquema Opportunities, este é o campo accountKey.sourceKey, já que o objetivo é estabelecer uma relação muitos para um com uma conta.
A caixa de diálogo Add relationship é exibida. Use esta caixa de diálogo para especificar detalhes do relacionamento. O tipo de relação está definido como Many-to-one por padrão.
Em Reference Schema, use a barra de pesquisa ou o menu suspenso para localizar o nome do esquema de referência. When you highlight the reference schema's name, the Reference Identity Namespace field automatically updates to the namespace of the reference schema's primary identity.
Em Relationship Name From Current Schema e Relationship Name From Reference Schema, forneça nomes amigáveis para a relação no contexto dos esquemas de origem e referência, respectivamente. Quando terminar, selecione Apply para confirmar as alterações e salvar a relação.
The canvas reappears, with the relationship field now marked with the friendly name you provided earlier. The relationship name is also listed on the left rail for easy reference.
If you view the structure of the reference schema, the relationship marker appears next to the schema's primary identity field and in the left rail.
Edit a B2B schema relationship edit-schema-relationship
Once a schema relationship is established, select the relationship field in the source schema followed by Edit relationship.
A caixa de diálogo Edit relationship é 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.
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.
Filtrar e pesquisar relacionamentos filter-and-search
Você pode filtrar e pesquisar relações específicas nos esquemas na guia Relationships do espaço de trabalho Schemas. 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 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.