DocumentaçãoExperience PlatformGuia dos conectores de origem

Namespaces e esquemas B2B

Last update: Wed Feb 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor
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 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.

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

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.

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 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.

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