DocumentaçãoExperience PlatformGuia dos conectores de origem

Namespaces e esquemas B2B

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor
AVAILABILITY
Você deve ter acesso ao Adobe Real-time Customer Data Platform B2B edition para que seus esquemas B2B sejam qualificados no Perfil do Cliente em Tempo Real.
NOTE
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 usando modelos na interface do usuário da plataforma.

Leia este documento para obter informações sobre a configuração subjacente dos namespaces e esquemas a serem usados com fontes 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.

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

IMPORTANT
As credenciais da conta de serviço (JWT) foram substituídas. Você deve garantir a migração do aplicativo ou da integração para a nova credencial OAuth de servidor para servidor antes de 27 de janeiro de 2025. Leia a documentação a seguir para obter as etapas detalhadas sobre como migrar a credencial JWT para a credencial OAuth Server-to-Server.

Consulte a documentação a seguir para obter as informações de pré-requisito sobre como configurar o ambiente Postman para oferecer suporte ao namespace B2B e ao utilitário de geração automática de esquema.

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

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

Variable
Descrição
Exemplo
CLIENT_SECRET
Um identificador exclusivo usado para gerar o {ACCESS_TOKEN}. Consulte o tutorial sobre autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar o {CLIENT_SECRET}.
{CLIENT_SECRET}
API_KEY
Um identificador exclusivo usado para autenticar chamadas para APIs Experience Platform. Consulte 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. Consulte 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
Com relação a Marketo, esse valor é fixo e sempre é definido como: ent_dataservices_sdk.
ent_dataservices_sdk
CONTAINER_ID
O contêiner global contém todas as classes, grupos de campos de esquema, tipos de dados e esquemas fornecidos por parceiros de Adobe e Experience Platform padrão. Com relação a Marketo, esse valor é fixo e sempre é definido como global.
global
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. Com relação 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. Consulte o tutorial em configuração do console do desenvolvedor e Postman para obter instruções sobre como recuperar as informações de {ORG_ID}.
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. Este valor é fixo e está sempre definido como: http://platform.adobe.io/.
http://platform.adobe.io/

Execução dos scripts

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

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

A pasta raiz do gerador de Namespaces e Esquemas na interface do Postman. Execuções está realçado na barra de menu superior.

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

A interface Runner da interface do Postman com várias solicitações na coleção Namespaces e Esquemas foi marcada e o botão Executar Namespaces e Esquemas foi realçado no lado direito.

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 serve para distinguir o contexto de uma identidade. Uma identidade totalmente qualificada inclui um valor de identidade e um namespace. Leia 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.

NOTE
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

O Experience Platform usa 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 de esquema, incluindo princípios de design e práticas recomendadas, consulte as noções básicas da composição de esquema.

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

NOTE
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 principal
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 de detalhes de pessoa de negócios XDM
Pessoa B2B
  1. extSourceSystemAudit.externalKey.sourceKey do grupo de campos Detalhes de pessoa de negócios XDM
  2. workEmail.address do grupo de campos Detalhes de 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 está 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
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
  • Identificação pessoal
  • 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

  • Campo listOperations.listKey.sourceKey
  • Tipo: um para um
  • Esquema de referência: Lista de marketing B2B
  • Namespace: lista de marketing B2B

Segundo relacionamento

  • Campo opportunityEvent.opportunityKey.sourceKey
  • Tipo: um para um
  • Esquema de referência: Oportunidade B2B
  • Namespace: oportunidade B2B

Terceira relação

  • Campo leadOperation.campaignProgression.campaignKey.sourceKey
  • 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 comercial 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 seus dados do Marketo à Platform, consulte o tutorial sobre criação de um conector de origem do Marketo na interface.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089