Espaços de nomes e esquemas B2B

Este documento fornece informações sobre a configuração subjacente para os namespaces e esquemas a serem usados com fontes B2B. Este documento também fornece detalhes sobre como configurar seu utilitário de automação do Postman necessário para gerar namespaces e esquemas B2B.

IMPORTANTE

Você deve ter acesso ao Real-time Customer Data Platform B2B Edition para que os esquemas B2B participem em Perfil do cliente em tempo real.

Configurar namespaces B2B e utilitário de geração automática de esquema

A primeira etapa no uso do namespace B2B e do utilitário de geração automática de esquema é configurar o console do desenvolvedor do Platform e Postman ambiente.

Com um console de desenvolvedor do Platform e Postman , agora é possível começar a aplicar os valores de ambiente apropriados ao Postman ambiente.

A tabela a seguir contém valores de exemplo e informações adicionais sobre como preencher Postman ambiente:

Variable Descrição Exemplo
CLIENT_SECRET Um identificador exclusivo usado para gerar o {ACCESS_TOKEN}. Veja o tutorial em autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar seu {CLIENT_SECRET}. {CLIENT_SECRET}
JWT_TOKEN O JSON Web Token (JWT) é uma credencial de autenticação usada para gerar seu {ACCESS_TOKEN}. Veja o tutorial em autenticação e acesso às APIs do Experience Platform para obter informações sobre como gerar seu {JWT_TOKEN}. {JWT_TOKEN}
API_KEY Um identificador exclusivo usado para autenticar chamadas para APIs do Experience Platform. Veja o tutorial em autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar seu {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN O token de autorização necessário para concluir chamadas para APIs do Experience Platform. Veja o tutorial em autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar seu {ACCESS_TOKEN}. Bearer {ACCESS_TOKEN}
META_SCOPE No que diz respeito à Marketo, esse valor é fixo e sempre está definido como: ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID O global O container contém todas as classes, grupos de campos do esquema, tipos de dados e esquemas fornecidos pelo Adobe e parceiro de Experience Platform. No que diz respeito à Marketo, esse valor é fixo e sempre está definido como global. global
PRIVATE_KEY Uma credencial usada para autenticar seu Postman para APIs do Experience Platform. Consulte o tutorial sobre como configurar o console do desenvolvedor e configurar o console do desenvolvedor e Postman para obter instruções sobre como recuperar o {PRIVATE_KEY}. {PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID Uma credencial usada para integrar ao Adobe I/O. D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS O Sistema Identity Management (IMS) fornece a estrutura para autenticação dos serviços da Adobe. No que diz respeito à Marketo, esse valor é fixo e sempre está definido como: ims-na1.adobelogin.com. ims-na1.adobelogin.com
IMS_ORG Uma entidade corporativa que pode ser proprietária ou licenciar produtos e serviços e permitir o acesso a seus membros. Veja o tutorial em configurar o console do desenvolvedor e Postman para obter instruções sobre como recuperar seu {IMS_ORG} informações. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME O nome da partição da sandbox virtual que você está usando. prod
TENANT_ID Uma ID usada para garantir que os recursos criados sejam namespacados corretamente e estejam contidos na organização IMS. b2bcdpproductiontest
PLATFORM_URL O endpoint de URL para o qual você está fazendo chamadas de API. Esse valor é fixo e sempre está definido como: http://platform.adobe.io/. http://platform.adobe.io/

Execução dos scripts

Com seu Postman coleção e ambiente configuradas, agora é possível executar o script pelo Postman interface.

No Postman selecione a pasta raiz do utilitário autogerador e selecione Run no cabeçalho superior.

pasta raiz

O Runner é exibida. A partir daqui, verifique se todas as caixas de seleção estão selecionadas e, em seguida, selecione Run Namespaces and Schemas Autogeneration Utility.

gerador de rodagem

Uma solicitação bem-sucedida cria os namespaces e schemas necessários para o B2B.

Namespaces B2B

Os namespaces de identidade são um componente do Identity Service que servem para distinguir o contexto ou o tipo de uma identidade. Uma identidade totalmente qualificada inclui um valor de ID e um namespace. Consulte a visão geral do namespaces para obter mais informações.

Os namespaces B2B são usados na identidade primária da entidade.

A tabela a seguir contém informações sobre a configuração subjacente para namespaces B2B.

OBSERVAÇÃO

Role a tela para a esquerda/direita para exibir o conteúdo completo da tabela.

Nome de exibição Símbolo de identidade Tipo de identidade
Pessoa B2B b2b_person CROSS_DEVICE
Conta B2B b2b_account B2B_ACCOUNT
Oportunidade B2B b2b_opportunity B2B_OPPORTUNITY
Relação de Pessoa da Oportunidade B2B b2b_opportunity_person_relation B2B_OPPORTUNITY_PERSON
Campanha B2B b2b_campaign B2B_CAMPAIGN
Membro da Campanha B2B b2b_campaign_member B2B_CAMPAIGN_MEMBER
Lista de marketing B2B b2b_marketing_list B2B_MARKETING_LIST
Membro da Lista de Marketing B2B b2b_marketing_list_member B2B_MARKETING_LIST_MEMBER
Relação de Pessoa da Conta B2B b2b_account_person_relation B2B_ACCOUNT_PERSON

Esquemas B2B

A Experience Platform utiliza esquemas para descrever a estrutura dos dados de forma consistente e reutilizável. Ao definir os dados de forma consistente em todos os sistemas, fica mais fácil manter o significado e, portanto, obter valor dos dados.

Para que os dados possam ser assimilados na Platform, um schema deve ser composto para descrever a estrutura dos dados e fornecer restrições ao tipo de dados que pode ser contido em cada campo. Os esquemas consistem em uma classe base e zero ou mais grupos de campos de esquema.

Para obter mais informações sobre o modelo de composição de schema, incluindo princípios de design e práticas recomendadas, consulte o noções básicas da composição do schema.

A tabela a seguir contém informações sobre a configuração subjacente dos esquemas B2B.

OBSERVAÇÃO

Role a tela para a esquerda/direita para exibir o conteúdo completo da tabela.

Nome do esquema Classe base Grupos de campos Profile no Esquema Identidade primária Namespace da identidade primária Identidade secundária Namespace de identidade secundária Relação Notas
Conta B2B Conta Comercial XDM Detalhes da conta comercial XDM Ativado accountKey.sourceKey na classe base Conta B2B extSourceSystemAudit.externalKey.sourceKey na classe base Conta B2B
  • accountParentKey.sourceKey no grupo de campos Detalhes da conta comercial XDM
  • Propriedade de destino: /accountKey/sourceKey
  • Tipo: um para um
  • Esquema de referência: Conta B2B
  • Namespace: Conta B2B
Pessoa B2B Perfil individual XDM
  • Detalhes da Pessoa Comercial XDM
  • Componentes de Pessoa Comercial XDM
  • IdentityMap
  • Detalhes de consentimento e preferência
Ativado b2b.personKey.sourceKey no Grupo de campos Detalhes da pessoa comercial do XDM Pessoa B2B
  1. extSourceSystemAudit.externalKey.sourceKey do grupo de campos Detalhes da Pessoa Comercial XDM
  2. workEmail.address do grupo de campos Detalhes da Pessoa Comercial XDM
  1. Pessoa B2B
  2. Email
  • personComponents.sourceAccountKey.sourceKey do grupo de campos Componentes da Pessoa Comercial XDM
  • Tipo: Muitos para um
  • Esquema de referência: Conta B2B
  • Namespace: Conta B2B
  • Propriedade de destino: accountKey.sourceKey
  • Nome do relacionamento do schema atual: Conta
  • Nome do relacionamento do schema de referência: Pessoas
Oportunidade B2B Oportunidade de negócios XDM Detalhes da oportunidade de negócios XDM Ativado opportunityKey.sourceKey na classe base Oportunidade B2B extSourceSystemAudit.externalKey.sourceKey na classe base Oportunidade B2B
  • accountKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Conta B2B
  • Namespace: Conta B2B
  • Propriedade de destino: accountKey.sourceKey
  • Nome do relacionamento do schema atual: Conta
  • Nome do relacionamento do schema de referência: Oportunidades
Relação de Pessoa da Oportunidade B2B Relação de Pessoa da Oportunidade de Negócios XDM None Ativado opportunityPersonKey.sourceKey na classe base Relação de Pessoa da Oportunidade B2B extSourceSystemAudit.externalKey.sourceKey na classe base Relação de Pessoa da Oportunidade B2B Primeira relação
  • personKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Pessoa B2B
  • Namespace: Pessoa B2B
  • Propriedade de destino: b2b.personKey.sourceKey
  • Nome do relacionamento do schema atual: Pessoa
  • Nome do relacionamento do schema de referência: Oportunidades
Segunda relação
  • opportunityKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Oportunidade B2B
  • Namespace: Oportunidade B2B
  • Propriedade de destino: opportunityKey.sourceKey
  • Nome do relacionamento do schema atual: Oportunidade
  • Nome do relacionamento do schema de referência: Pessoas
Campanha B2B Campanha comercial XDM Detalhes da campanha comercial XDM Ativado campaignKey.sourceKey na classe base Campanha B2B extSourceSystemAudit.externalKey.sourceKey na classe base Campanha B2B
Membro da Campanha B2B Membros da Campanha Comercial XDM Detalhes do Membro da Campanha Empresarial XDM Ativado ccampaignMemberKey.sourceKey na classe base Membro da Campanha B2B extSourceSystemAudit.externalKey.sourceKey na classe base Membro da Campanha B2B Primeira relação
  • personKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Pessoa B2B
  • Namespace: Pessoa B2B
  • Propriedade de destino: b2b.personKey.sourceKey
  • Nome do relacionamento do schema atual: Pessoa
  • Nome do relacionamento do schema de referência: Campanhas
Segunda relação
  • campaignKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Campanha B2B
  • Namespace: Campanha B2B
  • Propriedade de destino: campaignKey.sourceKey
  • Nome do relacionamento do schema atual: Campanha
  • Nome do relacionamento do schema de referência: Pessoas
Lista de marketing B2B Lista de marketing comercial XDM Nenhum Ativado marketingListKey.sourceKey na classe base Lista de marketing B2B Nenhum Nenhum Nenhum A Lista Estática não é sincronizada a partir de Salesforce e, portanto, não tem uma identidade secundária.
Membro da Lista de Marketing B2B Membros da Lista de Marketing Comercial XDM Nenhum Ativado marketingListMemberKey.sourceKey na classe base Membro da Lista de Marketing B2B Nenhum Nenhum Primeira relação
  • PersonKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Pessoa B2B
  • Namespace: Pessoa B2B
  • Propriedade de destino: b2b.personKey.sourceKey
  • Nome do relacionamento do schema atual: Pessoa
  • Nome do relacionamento do schema de referência: Listas de marketing
Segunda relação
  • marketingListKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Lista de marketing B2B
  • Namespace: Lista de marketing B2B
  • Propriedade de destino: marketingListKey.sourceKey
  • Nome do relacionamento do schema atual: Lista de marketing
  • Nome do relacionamento do schema de referência: Pessoas
O membro da lista estática não é sincronizado do Salesforce e, portanto, não tem uma identidade secundária.
Atividade B2B ExperiênciaEvento XDM
  • Visitar WebPage
  • Novo cliente potencial
  • Converter lead
  • Adicionar à lista
  • Remover da lista
  • Adicionar à Oportunidade
  • Remover da Oportunidade
  • Formulário preenchido
  • Cliques em links
  • Email Entregue
  • Email aberto
  • Email clicado
  • Rejeição de email
  • Enviar email com rejeição suave
  • Email Inscrito
  • Pontuação alterada
  • Oportunidade Atualizada
  • Status in Campaign Progression Changed (Status da Progressão da Campanha Alterado)
  • Identificador de pessoa
  • URL da Web do Marketo
  • Momento interessante
Ativado personKey.sourceKey do grupo de campos Identificador de Pessoa Pessoa B2B Nenhum Nenhum Primeira relação
  • listOperations.listKey.sourceKey campo
  • Tipo: um para um
  • Esquema de referência: Lista de marketing B2B
  • Namespace: Lista de marketing B2B
Segunda relação
  • opportunityEvent.opportunityKey.sourceKey campo
  • Tipo: um para um
  • Esquema de referência: Oportunidade B2B
  • Namespace: Oportunidade B2B
Terceiro relacionamento
  • leadOperation.campaignProgression.campaignKey.sourceKey campo
  • Tipo: um para um
  • Esquema de referência: Campanha B2B
  • Namespace: Campanha B2B
ExperienceEvent é diferente das entidades. A identidade do evento de experiência é a pessoa que fez a atividade.
Relação de Pessoa da Conta B2B Relação de Pessoa da Conta Comercial XDM Mapa de identidade Ativado accountPersonKey.sourceKey na classe base Relação de Pessoa da Conta B2B Nenhum Nenhum Primeira relação
  • personKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Pessoa B2B
  • Namespace: Pessoa B2B
  • Propriedade de destino: b2b.personKey.SourceKey
  • Nome do relacionamento do schema atual: Pessoas
  • Nome do relacionamento do schema de referência: Conta
Segunda relação
  • accountKey.sourceKey na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Conta B2B
  • Namespace: Conta B2B
  • Propriedade de destino: accountKey.sourceKey
  • Nome do relacionamento do schema atual: Conta
  • Nome do relacionamento do schema de referência: Pessoas

Próximas etapas

Para saber como conectar seu Marketo dados para a Platform, consulte o tutorial em criar um conector de origem do Marketo na interface do usuário.

Nesta página