Sales Insight para integrações Salesforce não nativas sales-insight-for-non-native-salesforce-integrations
Se sua conta do Adobe Marketo Engage estiver conectada ao Salesforce por meio de uma integração personalizada ou não nativa, use este artigo para configurar o Sales Insight.
- O recurso “MSI não nativo” é ativado para a instância do Marketo antes de você iniciar a configuração do MSI. Se não estiver e você já tiver comprado o recurso, contate o Suporte da Marketo. Se você ainda não adquiriu esse recurso, entre em contato com a equipe de conta da Adobe (seu gerente de conta).
- Uma conta do Salesforce com Pacote MSI configurado.
- API REST do Marketo configurada com êxito. As APIs CRUD expostas serão a base para executar a sincronização não nativa.
- Leia esta postagem do blog para entender o objeto e as relações.
- Configure objetos Salesforce para exibir o identificador global exclusivo que não diferencia maiúsculas de minúsculas de 18 caracteres, em vez do identificador global exclusivo que diferencia maiúsculas de minúsculas de 15 caracteres.
A sincronização não nativa bem-sucedida para o MSI requer o seguinte successful-non-native-sync-for-msi-requires-the-following
-
Sincronizar o Usuário de Vendas Salesforce com o Marketo.
O Usuário de Vendas Salesforce é um usuário externo que possui os Clientes Potenciais/Contatos em Salesforce. Um Vendedor do Marketo precisa ser substituído pelo Usuário de Vendas Salesforce. O campo externalSalesPersonId é obrigatório para a substituição do Vendedor.
table 0-row-3 1-row-3 html-authored no-header Campo do Vendedor do Marketo Campo de usuário de vendas Salesforce Descrição externalSalesPersonId Salesforce Identificador exclusivo global que não diferencia maiúsculas de minúsculas do Usuário de Vendas Identifica o registro de Vendedor do Marketo para um objeto de Usuário de Vendas Salesforce externo.
É obrigatório que o Vendedor seja sincronizado primeiro antes de sincronizar os outros objetos para que os relacionamentos adequados sejam criados.
- Documentação de API do Vendedor: https://experienceleague.adobe.com/pt-br/docs/marketo-developer/marketo/rest/lead-database/sales-persons
- Documentação da API para sincronizar o Vendedor: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Sales-Persons/operation/syncSalesPersonsUsingPOST
-
Sincronizar as Contas do Salesforce com a Marketo.
Será necessário substituir uma Empresa do Marketo pela Conta Salesforce. Os campos externalCompanyId e externalSalesPersonId são obrigatórios para a substituição da Empresa.
table 0-row-3 1-row-3 2-row-3 html-authored no-header Campo de empresa do Marketo Campo de Conta do Salesforce Descrição externalCompanyId Identificador exclusivo global, sem distinção entre maiúsculas e minúsculas, da conta do Salesforce Identifica um registro de Empresa da Marketo para um objeto de Conta externa Salesforce. externalSalesPersonId Salesforce Identificador exclusivo global que não diferencia maiúsculas de minúsculas do Usuário de Vendas Identifica um registro da Marketo Company para um objeto de usuário de vendas Salesforce externo que é o proprietário da conta.
Também usado no Marketo para associar a Empresa ao Vendedor que possui o registro da Empresa. É obrigatório sincronizar o Vendedor primeiro antes de definir esse campo.- Documentação de API para Empresas: https://experienceleague.adobe.com/pt-br/docs/marketo-developer/marketo/rest/lead-database/companies
- Documentação da API para sincronização de Empresas: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Companies/operation/syncCompaniesUsingPOST
-
Sincronizar os Clientes Potenciais/Contatos do Salesforce com a Marketo.
Você precisará substituir um cliente em potencial da Marketo pelo Salesforce cliente em potencial/contato. Os campos externalPersonId, externalSalesPersonId e externalCompanyId são obrigatórios para a substituição do lead.
table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored no-header Campo de clientes em potencial do Marketo Campo de clientes em potencial/contatos do Salesforce Descrição externalPersonId Salesforce Identificador exclusivo global de cliente potencial/contato , que não diferencia maiúsculas de minúsculas Identifica o registro de cliente potencial da Marketo para um objeto de contato/cliente potencial Salesforce externo.
Este é um novo campo introduzido para Não Nativo MSI.externalSalesPersonId Salesforce Identificador exclusivo global que não diferencia maiúsculas de minúsculas do Usuário de Vendas Identifica o objeto de Usuário de Vendas Salesforce externo que é proprietário deste Cliente Potencial/Contato.
Também relaciona o cliente potencial com o Vendedor na Marketo. É obrigatório sincronizar corretamente o Vendedor primeiro.externalCompanyId Identificador exclusivo global, sem distinção entre maiúsculas e minúsculas, da conta do Salesforce Identifica o objeto de Conta externa Salesforce ao qual o Cliente Potencial/Contato pertence.
Também relaciona o registro de cliente potencial a uma Empresa no Marketo. É obrigatório que a conta do Salesforce seja sincronizada corretamente primeiro.- Documentação de API para clientes em potencial: https://experienceleague.adobe.com/pt-br/docs/marketo-developer/marketo/rest/lead-database/leads
- Documentação da API para clientes em potencial de sincronização: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Leads/operation/syncLeadUsingPOST
-
Sincronizar Salesforce Oportunidades para o Marketo.
Será necessário substituir uma Oportunidade do Marketo pela Oportunidade Salesforce. Os campos externalOpportunityId, externalCompanyId e externalSalesPersonId são obrigatórios para a substituição da Oportunidade.
table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored no-header Campo de objeto de oportunidade do Marketo Campo de objeto de oportunidade Salesforce Descrição externalOpportunityId Identificador global exclusivo que não diferencia maiúsculas de minúsculas do Cliente Potencial/Contato da Salesforce Identifica o registro de Oportunidade da Marketo para um objeto de Oportunidade da Salesforce externo. externalCompanyId Identificador exclusivo global, sem distinção entre maiúsculas e minúsculas, da conta do Salesforce Identifica o objeto de Conta externa Salesforce ao qual esta Oportunidade pertence.
É obrigatório que a Conta Salesforce seja sincronizada corretamente primeiro.externalSalesPersonId Salesforce Identificador exclusivo global que não diferencia maiúsculas de minúsculas do Usuário de Vendas Identifica o objeto de Usuário de Vendas Salesforce externo que é proprietário desta Oportunidade. - Documentação de API da oportunidade: https://experienceleague.adobe.com/pt-br/docs/marketo-developer/marketo/rest/lead-database/opportunities
- Documentação da API para oportunidades de sincronização: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Opportunities/operation/syncOpportunitiesUsingPOST
-
Sincronizar Funções de Contato do Salesforce com a Marketo.
As Funções de Contato do Salesforce para uma Oportunidade do Salesforce podem ser sincronizadas por meio da Função da Oportunidade do Marketo. O registro da Função de Oportunidade exige os campos externalOpportunityId, role e leadId.
table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored no-header Campo de função da oportunidade Marketo Campo de função do contato do Salesforce Descrição externalOpportunityId Salesforce Identificador exclusivo global, que não diferencia maiúsculas de minúsculas, da oportunidade Identifica a Função de Oportunidade da Marketo para um objeto de oportunidade Salesforce externo.
É obrigatório que a Oportunidade Salesforce seja sincronizada corretamente primeiro.leadId N/D, essa seria uma ID de cliente potencial da Marketo Esta seria a ID de cliente em potencial da Marketo do contato sincronizado do Salesforce.
Depois que o contato for sincronizado no Marketo, você poderá usar o identificador exclusivo global, que não diferencia maiúsculas de minúsculas, do Contato do Salesforce como externalPersonId e consultar o Marketo Lead usando a API REST do Marketo.função O campo Função do Contato Salesforce Descreve a função do contato para esta oportunidade. - Documentação de API da oportunidade: https://experienceleague.adobe.com/pt-br/docs/marketo-developer/marketo/rest/lead-database/opportunities
- Documentação da API para oportunidades de sincronização: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Opportunities/operation/syncOpportunitiesUsingPOST
-
Sincronizar campos de Última Pontuação de Momento Interessante/MSI com o SFDC.
Depois que os objetos do Salesforce forem sincronizados corretamente com o Marketo, você poderá aproveitar os recursos MSI. Os campos Último momento interessante/Pontuação do MSI serão expostos na API REST para leads. Esses campos são calculados pelo MSI e são somente leitura.
Os campos Último momento interessante/Pontuação de um cliente potencial da Marketo precisarão ser sincronizados regularmente com Salesforce usando o ponto de extremidade REST API Lead. Consulte este ponto de extremidade para um cliente potencial da Marketo usando a externalPersonId como o filterType e transmitindo a GUID do cliente potencial Salesforce como o filterValue.
table 0-row-1 GET /rest/v1/leads.json?filterType=externalPersonId&filterValues=salesforceLeadId1,salesforceLeadId2 Você pode usar os valores desses campos para sincronizar com seu objeto de Cliente Potencial/Contato do Salesforce.
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 html-authored no-header Campo de clientes em potencial do Marketo Campo de clientes em potencial/contatos do Salesforce Descrição msiLastInterestedMomentType Rótulo: Tipo do Último Momento Interessante
Nome: Last_Interested_Moment_Type__cTipo do último momento interessante para o lead msiLastInterestedMomentDate Rótulo: Última data de momento interessante
Nome: Last_Interested_Moment_Date__c
Data do último momento interessante do cliente potencial msiLastInterestedMomentDesc Rótulo: Descrição do último momento interessante
Nome: Last_Interested_Moment_Desc__c
Descrição do último momento interessante do lead msiLastInterestedMomentSource Rótulo: Source do último momento interessante
Nome: Last_Interested_Moment_Source__c
Source do último momento interessante para o lead prioridade Rótulo: Engajamento
Nome: Priority_c
Prioridade do cliente em potencial relativeUrgency Rótulo: valor relativo de urgência
Nome: Urgency_Value__c
Urgência relativa do lead relativeScoring Rótulo: valor de pontuação relativo
Nome: Relative_Score_Value__c
Pontuação relativa do lead Documentação da API REST de cliente potencial: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Leads/operation/getLeadByIdUsingGET.
O uso adequado dos campos externos é a chave para uma sincronização bem-sucedida não nativa. Se não conseguir ver os dados em algumas exibições, é provável que um determinado campo não tenha sido sincronizado corretamente. Por exemplo, se as atividades e os momentos interessantes de um lead não forem exibidos ao pesquisar o widget MSI em sua Conta, é provável que a empresa do lead ou a Conta não tenha sido sincronizada corretamente. Executar uma solicitação GET para este cliente potencial ao especificar os campos externos ajudará a verificar se o cliente potencial foi sincronizado corretamente. Além disso, o email do vendedor externo no Marketo deve corresponder ao email desse usuário no Salesforce. Os dados podem não ser exibidos na guia Marketo no Salesforce se os emails não corresponderem.