Namespaces e esquemas B2B

OBSERVAÇÃO

Você pode usar modelos na interface do usuário do Adobe Experience Platform para agilizar a criação de ativos para dados B2B e B2C. Para obter mais informações, leia o guia em uso de modelos na interface do usuário da Platform.

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

IMPORTANTE

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

Configurar namespaces B2B e o 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 da Platform e Postman ambiente.

Com um console de desenvolvedor da Platform e Postman configurada, agora é possível começar a aplicar os valores de ambiente apropriados às suas Postman ambiente.

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

Variable Descrição Exemplo
CLIENT_SECRET Um identificador exclusivo usado para gerar sua {ACCESS_TOKEN}. Veja o tutorial sobre autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar o {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 sobre autenticação e acesso às APIs do Experience Platform para obter informações sobre como gerar seus {JWT_TOKEN}. {JWT_TOKEN}
API_KEY Um identificador exclusivo usado para autenticar chamadas para APIs Experience Platform. Veja o tutorial sobre autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar o {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN O token de autorização necessário para completar chamadas para APIs de Experience Platform. Veja o tutorial sobre autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar o {ACCESS_TOKEN}. Bearer {ACCESS_TOKEN}
META_SCOPE No que diz respeito a Marketo, esse valor é fixo e sempre é definido como: ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID A variável global o container contém todas as classes padrão fornecidas por Adobe e parceiros de Experience Platform, grupos de campos de esquema, tipos de dados e esquemas. No que diz respeito a Marketo, esse valor é fixo e sempre é definido como global. global
PRIVATE_KEY Uma credencial usada para autenticar seu Postman para APIs Experience Platform. Consulte o tutorial sobre a configuração do console do desenvolvedor e configuração do console do desenvolvedor e Postman para obter instruções sobre como recuperar sua {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 de serviços da Adobe. No que diz respeito a Marketo, esse valor é fixo e sempre é 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 acesso a seus membros. Veja o tutorial sobre configuração do console do desenvolvedor e Postman para obter instruções sobre como recuperar o {ORG_ID} informações. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME O nome da partição de sandbox virtual que você está usando. prod
TENANT_ID Uma ID usada para garantir que os recursos criados tenham o namespace adequado e estejam contidos na organização. b2bcdpproductiontest
PLATFORM_URL O endpoint de URL para o qual você está fazendo chamadas de API. Esse valor é fixo e sempre é definido como: http://platform.adobe.io/. http://platform.adobe.io/

Execução dos scripts

Com o seu Postman coleção e ambiente configurados, agora é possível executar o script por meio da variável Postman interface.

No Postman , selecione a pasta raiz do utilitário gerador automático e selecione Run no cabeçalho superior.

pasta-raiz

A variável Runner é exibida. Aqui, verifique se todas as caixas de seleção estão marcadas e selecione Run Namespaces and Schemas Autogeneration Utility.

run-generator

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

Namespaces B2B

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

Os namespaces B2B são usados na identidade principal 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 visualizar 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 pessoal 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 pessoal 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.

Antes que os dados possam ser assimilados na Platform, um esquema deve ser composto para descrever a estrutura dos dados e fornecer restrições ao tipo de dados que podem estar contidos 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 do schema, incluindo princípios de design e práticas recomendadas, consulte o noções básicas da composição do esquema.

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

OBSERVAÇÃO

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

Nome do esquema Classe base Grupos de campos Profile no esquema Identidade principal Namespace de identidade primário Identidade secundária Namespace de identidade secundário Relação Notas
Conta B2B Conta de negócios XDM Detalhes da conta de negócios 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 de negócios 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 de pessoa de negócios XDM
  • Componentes de pessoa de negócios XDM
  • IdentityMap
  • Detalhes sobre consentimento e preferência
 Ativado b2b.personKey.sourceKey no Grupo de campos Detalhes da pessoa de negócios XDM Pessoa B2B
  1. extSourceSystemAudit.externalKey.sourceKey do grupo de campos Detalhes da pessoa de negócios XDM
  2. workEmail.address do grupo de campos Detalhes da pessoa de negócios XDM
  1. Pessoa B2B
  2. Email
  • personComponents.sourceAccountKey.sourceKey do grupo de campos Componentes de pessoa de negócios XDM
  • Tipo: De muitos para um
  • Esquema de referência: conta B2B
  • Namespace: conta B2B
  • Propriedade de destino: accountKey.sourceKey
  • Nome do relacionamento do esquema atual: Conta
  • Nome do relacionamento do esquema de referência: Pessoas
Oportunidade B2B Oportunidade de negócios XDM Detalhes de oportunidades 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: De muitos para um
  • Esquema de referência: conta B2B
  • Namespace: conta B2B
  • Propriedade de destino: accountKey.sourceKey
  • Nome do relacionamento do esquema atual: Conta
  • Nome do relacionamento do esquema de referência: Oportunidades
Relação pessoal da oportunidade B2B Relação pessoal de oportunidade de negócios XDM None Ativado opportunityPersonKey.sourceKey na classe base Relação pessoal da oportunidade B2B extSourceSystemAudit.externalKey.sourceKey na classe base Relação pessoal da oportunidade B2B Primeiro relacionamento
  • personKey.sourceKey na classe base
  • Tipo: De muitos para um
  • Esquema de referência: pessoa B2B
  • Namespace: pessoa B2B
  • Propriedade de destino: b2b.personKey.sourceKey
  • Nome do relacionamento do esquema atual: Pessoa
  • Nome do relacionamento do esquema de referência: Oportunidades
Segundo relacionamento
  • opportunityKey.sourceKey na classe base
  • Tipo: De muitos para um
  • Esquema de referência: Oportunidade B2B
  • Namespace: oportunidade B2B
  • Propriedade de destino: opportunityKey.sourceKey
  • Nome do relacionamento do esquema atual: Oportunidade
  • Nome do relacionamento do esquema de referência: Pessoas
Campanha B2B Campanha de negócios XDM Detalhes da campanha de negócios XDM Ativado campaignKey.sourceKey na classe base Campanha B2B extSourceSystemAudit.externalKey.sourceKey na classe base Campanha B2B
Membro da campanha B2B Membros da campanha de negócios XDM Detalhes do membro da campanha de negócios XDM Ativado ccampaignMemberKey.sourceKey na classe base Membro da campanha B2B extSourceSystemAudit.externalKey.sourceKey na classe base Membro da campanha B2B Primeiro relacionamento
  • personKey.sourceKey na classe base
  • Tipo: De muitos para um
  • Esquema de referência: pessoa B2B
  • Namespace: pessoa B2B
  • Propriedade de destino: b2b.personKey.sourceKey
  • Nome do relacionamento do esquema atual: Pessoa
  • Nome do relacionamento do esquema de referência: Campanhas
Segundo relacionamento
  • campaignKey.sourceKey na classe base
  • Tipo: De muitos para um
  • Esquema de referência: campanha B2B
  • Namespace: campanha B2B
  • Propriedade de destino: campaignKey.sourceKey
  • Nome do relacionamento do esquema atual: Campanha
  • Nome do relacionamento do esquema de referência: Pessoas
Lista de marketing B2B Lista de marketing de negócios XDM None Ativado marketingListKey.sourceKey na classe base Lista de marketing B2B None None None 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 de negócios XDM None Ativado marketingListMemberKey.sourceKey na classe base Membro da lista de marketing B2B None None Primeiro relacionamento
  • PersonKey.sourceKey na classe base
  • Tipo: De muitos para um
  • Esquema de referência: pessoa B2B
  • Namespace: pessoa B2B
  • Propriedade de destino: b2b.personKey.sourceKey
  • Nome do relacionamento do esquema atual: Pessoa
  • Nome do relacionamento do esquema de referência: Listas de marketing
Segundo relacionamento
  • marketingListKey.sourceKey na classe base
  • Tipo: De 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 esquema atual: Lista de marketing
  • Nome do relacionamento do esquema de referência: Pessoas
 O membro da lista estática não é sincronizado a partir de Salesforce e, portanto, não tem uma identidade secundária.
Atividade B2B XDM ExperienceEvent
  • Visitar página da Web
  • Novo lead
  • Converter lead
  • Adicionar à lista
  • Remover da lista
  • Adicionar à oportunidade
  • Remover da oportunidade
  • Formulário preenchido
  • Cliques de link
  • Email entregue
  • Email aberto
  • Email clicado
  • Email rejeitado
  • Email rejeitado temporariamente
  • Email cancelado
  • Pontuação alterada
  • Oportunidade atualizada
  • Status na progressão da campanha alterado
  • Identificador de pessoa
  • URL da Web do Marketo
  • Momento interessante
  • Chamar Webhook
  • Alterar cadência da campanha
  • Estágio da receita alterado
  • Mesclar leads
  • Email enviado
  • Alterar fluxo da campanha
  • Adicionar à campanha
 Ativado personKey.sourceKey do grupo de campos Identificador de pessoa Pessoa B2B None None Primeiro relacionamento
  • listOperations.listKey.sourceKey campo
  • Tipo: um para um
  • Esquema de referência: Lista de marketing B2B
  • Namespace: lista de marketing B2B
Segundo relacionamento
  • 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 de entidades. A identidade do evento de experiência é a pessoa que realizou a atividade.
Relação pessoal da conta B2B Relação pessoal da conta de negócios XDM Mapa de identidade Ativado accountPersonKey.sourceKey na classe base Relação pessoal da conta B2B None None Primeiro relacionamento
  • personKey.sourceKey na classe base
  • Tipo: De muitos para um
  • Esquema de referência: pessoa B2B
  • Namespace: pessoa B2B
  • Propriedade de destino: b2b.personKey.SourceKey
  • Nome do relacionamento do esquema atual: People
  • Nome do relacionamento do esquema de referência: Conta
Segundo relacionamento
  • accountKey.sourceKey na classe base
  • Tipo: De muitos para um
  • Esquema de referência: conta B2B
  • Namespace: conta B2B
  • Propriedade de destino: accountKey.sourceKey
  • Nome do relacionamento do esquema atual: Conta
  • Nome do relacionamento do esquema de referência: Pessoas

Próximas etapas

Para saber como conectar seu Marketo para a Platform, consulte o tutorial em criação de um conector de origem do Marketo na interface.

Nesta página