(Beta) Marketo Engage namespaces e schemas

IMPORTANTE

A fonte Marketo Engage está atualmente em beta. O recurso e a documentação estão sujeitos a alterações.

Este documento fornece informações sobre a configuração subjacente para os namespaces e esquemas B2B usados com Marketo Engage (a seguir denominado "Marketo"). Este documento também fornece detalhes sobre a configuração do utilitário de automação do Postman necessário para gerar Marketo namespaces e esquemas B2B.

Configure o namespace Marketo e o utilitário de geração automática de esquema

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

Com um console do desenvolvedor da Platform e Postman configuradas, 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 e informações adicionais sobre como preencher o ambiente Postman:

Variable Descrição Exemplo
CLIENT_SECRET Um identificador exclusivo usado para gerar {ACCESS_TOKEN}. Consulte o tutorial em autenticar e acessar 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}. Consulte o tutorial em autenticar e acessar 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. Consulte o tutorial em autenticar e acessar 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. Consulte o tutorial em autenticar e acessar APIs do Experience Platform para obter informações sobre como recuperar seu {ACCESS_TOKEN}. Bearer {ACCESS_TOKEN}
META_SCOPE No que diz respeito a Marketo, esse valor é fixo e sempre está 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 pelo Adobe e parceiro de Experience Platform. Em relação a Marketo, esse valor é fixo e sempre está definido como global. global
PRIVATE_KEY Uma credencial usada para autenticar sua instância 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 seu {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 de Adobe. No que diz respeito a 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. Consulte o tutorial em configurar o console do desenvolvedor e Postman para obter instruções sobre como recuperar suas informações {IMS_ORG}. 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/
munchkinId A ID exclusiva para sua conta Marketo. Consulte o tutorial em autenticar sua Marketo instância para obter informações sobre como recuperar seu munchkinId. 123-ABC-456
sfdc_org_id A ID da organização da sua conta Salesforce. Consulte o Salesforce guia a seguir para obter mais informações sobre como adquirir a ID da organização Salesforce. 00D4W000000FgYJUA0
msd_org_id A ID da organização da sua conta Dynamics. Consulte o Microsoft Dynamics guia a seguir para obter mais informações sobre como adquirir a ID da organização Dynamics. f6438fab-67e8-4814-a6b5-8c8dcdf7a98f
has_abm Um valor booleano que indica se você está inscrito em Marketo Account-Based Marketing. false
has_msi Um valor booleano que indica se você está inscrito em Marketo Sales Insight. false

Marketo namespaces

Os namespaces de identidade são um componente de Identity Service que serve como indicadores do contexto ao qual uma identidade está relacionada.

Uma identidade totalmente qualificada inclui um valor de ID e um namespace. Um novo namespace personalizado é necessário para cada nova instância Marketo e combinação de conjunto de dados. Por exemplo, um conector de origem Marketo que assimila o conjunto de dados programs requer seu próprio namespace personalizado e outro conector de origem do Marketo que assimila o mesmo conjunto de dados também exige seu próprio namespace personalizado. Consulte a visão geral dos namespaces para obter mais informações.

O namespace Marketo é usado na identidade primária da entidade.

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

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 Tipo de emissor Tipo de entidade emissor Exemplo da ID do Munchkin
marketo_person_{MUNCHKIN_ID} gerado automaticamente CROSS_DEVICE Marketo person 123-ABC-789
marketo_company_{MUNCHKIN_ID} gerado automaticamente B2B_ACCOUNT Marketo company 123-ABC-789
marketo_opportunity_{MUNCHKIN_ID} gerado automaticamente B2B_OPPORTUNITY Marketo opportunity 123-ABC-789
marketo_opportunity_contact_role_{MUNCHKIN_ID} gerado automaticamente B2B_OPPORTUNITY_PERSON Marketo opportunity contact role 123-ABC-789
marketo_program_{MUNCHKIN_ID} gerado automaticamente B2B_CAMPAIGN Marketo program 123-ABC-789
marketo_program_member_{MUNCHKIN_ID} gerado automaticamente B2B_CAMPAIGN_MEMBER Marketo program member 123-ABC-789
marketo_static_list_{MUNCHKIN_ID} gerado automaticamente B2B_MARKETING_LIST Marketo static list 123-ABC-789
marketo_static_list_member_{MUNCHKIN_ID} gerado automaticamente B2B_MARKETING_LIST_MEMBER Marketo static list member 123-ABC-789
marketo_named_account_{MUNCHKIN_ID} gerado automaticamente B2B_ACCOUNT Marketo named account 123-ABC-789

Salesforce namespaces

Se você estiver inscrito na integração Salesforce, o namespace Salesforce será usado na identidade secundária da entidade.

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

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 Tipo de emissor Tipo de entidade emissor Salesforce exemplo de ID da organização da assinatura
salesforce_lead_{SALESFORCE_ORGANIZATION_ID} gerado automaticamente CROSS_DEVICE Salesforce lead 00DA0000000Hz79
salesforce_account_{SALESFORCE_ORGANIZATION_ID} gerado automaticamente B2B_ACCOUNT Salesforce account 00DA0000000Hz79
salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID} gerado automaticamente B2B_OPPORTUNITY Salesforce opportunity 00DA0000000Hz79
salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} gerado automaticamente B2B_OPPORTUNITY_PERSON Salesforce opportunity contact role 00DA0000000Hz79
salesforce_campaign_{SALESFORCE_ORGANIZATION_ID} gerado automaticamente B2B_CAMPAIGN Salesforce campaign 00DA0000000Hz79
salesforce_campaign_member_{SALESFORCE_ORGANIZATION_ID} gerado automaticamente B2B_CAMPAIGN_MEMBER Salesforce campaign member 00DA0000000Hz79

Microsoft Dynamics namespaces

Se você estiver inscrito na integração Dynamics, o namespace Dynamics será usado como identidade secundária da entidade.

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

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 Tipo de emissor Tipo de entidade emissor Dynamics exemplo de ID da organização da assinatura
microsoft_person_{DYNAMICS_ID} gerado automaticamente CROSS_DEVICE Microsoft person 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_account_{DYNAMICS_ID} gerado automaticamente B2B_ACCOUNT Microsoft account 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_{DYNAMICS_ID} gerado automaticamente B2B_OPPORTUNITY Microsoft opportunity 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_contact_connection_{DYNAMICS_ID} gerado automaticamente B2B_OPPORTUNITY_PERSON Microsoft opportunity relationship 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_{DYNAMICS_ID} gerado automaticamente B2B_CAMPAIGN Microsoft campaign 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_member_{DYNAMICS_ID} gerado automaticamente B2B_CAMPAIGN_MEMBER Microsoft campaign member 94cahe38-e51h-3d57-a9c6-2edklb7184mh

Marketo esquemas

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

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

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
Marketo Company {MUNCHKIN_ID} Conta Comercial XDM Detalhes da conta comercial XDM Ativado accountID na classe base marketo_company_{MUNCHKIN_ID} extSourceSystemAudit.externalID na classe base salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID no grupo de campos Detalhes da conta comercial XDM
  • Tipo: um para um
  • Esquema de referência: Marketo Company {MUNCHKIN_ID}
  • Namespace: marketo_company_{MUNCHKIN_ID}
Marketo Person {MUNCHKIN_ID} Perfil individual XDM
  • Detalhes da Pessoa Comercial XDM
  • Componentes de Pessoa Comercial XDM
  • IdentityMap
Ativado personID na classe base marketo_person_{MUNCHKIN_ID}
  1. extSourceSystemAudit.externalID do grupo de campos Detalhes da Pessoa Comercial XDM
  2. workEmail.address do grupo de campos Detalhes da Pessoa Comercial XDM
  3. identityMap do grupo de campos do Mapa de identidade
  1. salesforce_lead_{SALESFORCE_ORGANIZATION_ID}
  2. Email
  3. ECID
  • personComponents.sourceAccountID do grupo de campos Componentes da Pessoa Comercial XDM
  • Tipo: Muitos para um
  • Esquema de referência: Marketo Company {MUNCHKIN_ID}
  • Namespace: marketo_company_{MUNCHKIN_ID}
  • Propriedade de destino: accountID
  • Nome do relacionamento do schema atual: Conta
  • Nome do relacionamento do schema de referência: Pessoas
Marketo Opportunity {MUNCHKIN_ID} Oportunidade de negócios XDM Detalhes da oportunidade de negócios XDM Ativado opportunityID na classe base marketo_opportunity_{MUNCHKIN_ID} extSourceSystemAudit.externalID na classe base salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID}
  • accountID na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Marketo Company {MUNCHKIN_ID}
  • Namespace: marketo_company_{MUNCHKIN_ID}
  • Propriedade de destino: accountID
  • Nome do relacionamento do schema atual: Conta
  • Nome do relacionamento do schema de referência: Oportunidades
Marketo Opportunity Contact Role {MUNCHKIN_ID} Relação de Pessoa da Oportunidade de Negócios XDM None Ativado opportunityPersonID na classe base marketo_opportunity_contact_role_{MUNCHKIN_ID} extSourceSystemAudit.externalID na classe base salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} Primeira relação
  • personID na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Marketo Person {MUNCHKIN_ID}
  • Namespace: marketo_person_{MUNCHKIN_ID}
  • Propriedade de destino: personID
  • Nome do relacionamento do schema atual: Pessoa
  • Nome do relacionamento do schema de referência: Oportunidades
Segunda relação
  • opportunityID na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Marketo Opportunity {MUNCHKIN_ID}
  • Namespace: marketo_opportunity_{MUNCHKIN_ID}
  • Propriedade de destino: opportunityID
  • Nome do relacionamento do schema atual: Oportunidade
  • Nome do relacionamento do schema de referência: Pessoas
Marketo Program {MUNCHKIN_ID} Campanha comercial XDM Detalhes da campanha comercial XDM Ativado campaignID na classe base marketo_program_{MUNCHKIN_ID} extSourceSystemAudit.externalID na classe base salesforce_campaign_{SALESFORCE_ORGANIZATION_ID}
Marketo Program Member {MUNCHKIN_ID} Membro da Campanha Comercial XDM Detalhes do Membro da Campanha Empresarial XDM Ativado campaignMemberID na classe base marketo_program_member_{MUNCHKIN_ID} Nenhum Nenhum Primeira relação
  • personID na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Pessoa do Marketo {MUNCHKIN_ID}
  • Namespace: marketo_person_{MUNCHKIN_ID}
  • Propriedade de destino: personID
  • Nome do relacionamento do schema atual: Pessoa
  • Nome do relacionamento do schema de referência: Programas
Segunda relação
  • campaignID na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Marketo Program {MUNCHKIN_ID}
  • Namespace: marketo_program_{MUNCHKIN_ID}
  • Propriedade de destino: campaignID
  • Nome do relacionamento do schema atual: Programa
  • Nome do relacionamento do schema de referência: Pessoas
Marketo Static List {MUNCHKIN_ID} Lista de marketing comercial XDM Nenhum Ativado marketingListID na classe base marketo_static_list_{MUNCHKIN_ID} Nenhum Nenhum Nenhum A Lista estática não é sincronizada de Salesforce e, portanto, não tem uma identidade secundária.
Marketo Static List Member {MUNCHKIN_ID} Membros da Lista de Marketing Comercial XDM Nenhum Ativado marketingListMemberID na classe base marketo_static_list_member_{MUNCHKIN_ID} Nenhum Nenhum Primeira relação
  • personID na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Marketo Person {MUNCHKIN_ID}
  • Namespace: marketo_person_{MUNCHKIN_ID}
  • Propriedade de destino: personID
  • Nome do relacionamento do schema atual: Pessoa
  • Nome do relacionamento do schema de referência: Listas
Segunda relação
  • marketingListID na classe base
  • Tipo: Muitos para um
  • Esquema de referência: Marketo Static List {MUNCHKIN_ID}
  • Namespace: marketo_static_list_{MUNCHKIN_ID}
  • Propriedade de destino: marketingListID
  • Nome do relacionamento do schema atual: Lista
  • Nome do relacionamento do schema de referência: Pessoas
O membro da lista estática não é sincronizado de Salesforce e, portanto, não tem uma identidade secundária.
Marketo Named Account {MUNCHKIN_ID} Conta Comercial XDM Detalhes da conta comercial XDM Ativado accountID na classe base marketo_named_account_{MUNCHKIN_ID} extSourceSystemAudit.externalID na classe base salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID no grupo de campos Detalhes da conta comercial XDM
  • Tipo: um para um
  • Esquema de referência: Marketo Named Account {MUNCHKIN_ID}
  • Namespace: marketo_named_account_{MUNCHKIN_ID}
Marketo Atividade {MUNCHKIN ID} 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
Ativado personID do grupo de campos Identificador de Pessoa marketo_person_{MUNCHKIN_ID} Nenhum Nenhum Primeira relação
  • listOperations.listID campo
  • Tipo: um para um
  • Esquema de referência: Marketo Static List {MUNCHKIN_ID}
  • Namespace: marketo_static_list_{MUNCHKIN_ID}
Segunda relação
  • opportunityEvent.opportunityID campo
  • Tipo: um para um
  • Esquema de referência: Marketo Opportunity {MUNCHKIN_ID}
  • Namespace: marketo_opportunity_{MUNCHKIN_ID}
Terceiro relacionamento
  • leadOperation.campaignProgression.campaignID campo
  • Tipo: um para um
  • Esquema de referência: Marketo Program {MUNCHKIN_ID}
  • Namespace: marketo_program_{MUNCHKIN_ID}
A identidade primária do schema Marketo Activity {MUNCHKIN_ID} é personID, que é a mesma identidade primária do schema [!DNL Marketo] Person {MUNCHKIN_ID}.

Próximas etapas

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

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now