Documentación Marketo Engage Guía de Marketo

Sales Insight para integraciones no nativas de MS Dynamics sales-insight-for-non-native-ms-dynamics-integrations

Last update: Tue Sep 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Si su cuenta de Adobe Marketo Engage está conectada a MS Dynamics mediante una integración personalizada o no nativa, use este artículo para configurar Sales Insight.

PREREQUISITES

La función “MSI no nativo” habilitada para su instancia de Marketo antes de comenzar a configurar MSI. Si no es así y ya compraste la función, comunícate con el Soporte técnico de Marketo. Si todavía no ha adquirido esta función, póngase en contacto con el equipo de cuenta de Adobe (su administrador de cuentas).
Descargar paquete MSI para sincronización personalizada.
Una suscripción de MS Dynamics con la configuración de MSI (en este momento solo se admite Dynamics Online).
La API de REST de Marketo se configuró correctamente. Las API de CRUD expuestas constituirán la base para realizar la sincronización no nativa.
Lea esta publicación de blog para comprender el objeto y las relaciones.

La sincronización no nativa correcta para MSI requiere lo siguiente successful-non-native-sync-for-msi-requires-the-following

Sincronizar el usuario de ventas de MS Dynamics con Marketo.

El usuario de ventas de MS Dynamics es un usuario externo propietario de los contactos o posibles clientes de MS Dynamics. Se debe actualizar un vendedor de Marketo para el usuario de ventas de MS Dynamics. El campo externalSalesPersonId es obligatorio para el mantenimiento del vendedor.

table 0-row-3 1-row-3 html-authored no-header
Campo de vendedor de Marketo	Campo de usuario de MS Dynamics	Descripción
externalSalesPersonId	Identificador único global de MS Dynamics que no distingue entre mayúsculas y minúsculas	Identifica el registro del vendedor de Marketo en un objeto de usuario externo de MS Dynamics. Se exige que el vendedor se sincronice primero antes de sincronizar los otros objetos, de modo que se creen las relaciones adecuadas.

table 0-row-3 1-row-3 html-authored no-header

Campo de vendedor de Marketo

Campo de usuario de MS Dynamics

Descripción

externalSalesPersonId

Identificador único global de MS Dynamics que no distingue entre mayúsculas y minúsculas

Identifica el registro del vendedor de Marketo en un objeto de usuario externo de MS Dynamics.

Se exige que el vendedor se sincronice primero antes de sincronizar los otros objetos, de modo que se creen las relaciones adecuadas.

Sincronizar las cuentas de MS Dynamics con Marketo.

Será necesario actualizar una compañía de Marketo para la cuenta de MS Dynamics. Los campos externalCompanyId y externalSalesPersonId son obligatorios para la actualización de la compañía.

table 0-row-3 1-row-3 2-row-3 html-authored no-header
Campo de compañía de Marketo	Campo de cuenta de MS Dynamics	Descripción
externalCompanyId	Identificador único global sin distinción de mayúsculas y minúsculas en la cuenta de MS Dynamics	Identifica un registro de compañía de Marketo en un objeto de cuenta externo de MS Dynamics.
externalSalesPersonId	MS Dynamics Sales User no distingue entre mayúsculas y minúsculas como identificador único global	Identifica un registro de Marketo Company en un objeto de usuario de ventas externo de MS Dynamics que es el propietario de la cuenta. También se usa en Marketo para asociar la compañía al vendedor que posee el registro de compañía. Es obligatorio sincronizar primero el vendedor antes de establecer este campo.

Documentación de API para compañías: https://experienceleague.adobe.com/es/docs/marketo-developer/marketo/rest/lead-database/companies
Documentación de API para sincronizar compañías: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Sales-Persons/operation/syncSalesPersonsUsingPOST

Sincronizar contactos/posibles clientes de MS Dynamics con Marketo.

Deberá actualizar un posible cliente de Marketo para el posible cliente/contacto de MS Dynamics. Los campos externalPersonId, externalSalesPersonId y externalCompanyId son obligatorios para la actualización del posible cliente.

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored no-header
Campo de posible cliente de Marketo	Campo de contacto/posible cliente de MS Dynamics	Descripción
externalPersonId	Identificador único global sin distinción de mayúsculas y minúsculas de MS Dynamics	Identifica el registro de posible cliente de Marketo en un objeto de contacto o posible cliente de MS Dynamics externo. Este es un nuevo campo que se introduce para MSI no nativo.
externalSalesPersonId	MS Dynamics Sales User no distingue entre mayúsculas y minúsculas como identificador único global	Identifica el objeto de usuario de ventas externo de MS Dynamics que posee este cliente potencial/contacto. También relaciona al posible cliente con el vendedor en Marketo. Se requiere que el Vendedor se sincronice correctamente primero.
externalCompanyId	Identificador único global sin distinción de mayúsculas y minúsculas en la cuenta de MS Dynamics	Identifica el objeto de cuenta externo de MS Dynamics al que pertenece el posible cliente/contacto. También relaciona el registro de posibles clientes con una compañía en Marketo. Es obligatorio que la cuenta de MS Dynamics se sincronice correctamente primero.

Documentación de API para posibles clientes: https://experienceleague.adobe.com/es/docs/marketo-developer/marketo/rest/lead-database/lead-database
Documentación de API para sincronizar posibles clientes: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Leads/operation/syncLeadUsingPOST

Sincronizar oportunidades de MS Dynamics con Marketo.

Deberá actualizar una oportunidad de Marketo para la oportunidad MS Dynamics. Los campos externalOpportunityId, externalCompanyId y externalSalesPersonId son obligatorios para la actualización de la oportunidad.

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored no-header
Campo de objeto de oportunidad de Marketo	Campo de objeto de oportunidad MS Dynamics	Descripción
externalOpportunityId	Identificador único global sin distinción de mayúsculas y minúsculas de MS Dynamics	Identifica el registro de oportunidad de Marketo en un objeto de oportunidad de MS Dynamics externo.
externalCompanyId	Identificador único global sin distinción de mayúsculas y minúsculas en la cuenta de MS Dynamics	Identifica el objeto de cuenta externo de MS Dynamics al que pertenece esta oportunidad. Es obligatorio que la cuenta de MS Dynamics se sincronice correctamente primero.
externalSalesPersonId	MS Dynamics Sales User no distingue entre mayúsculas y minúsculas como identificador único global	Identifica el objeto de usuario de ventas externo de MS Dynamics propietario de esta oportunidad.

Documentación de la API para la oportunidad: https://experienceleague.adobe.com/es/docs/marketo-developer/marketo/rest/lead-database/opportunities
Documentación de API para sincronizar oportunidades: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Opportunities/operation/syncOpportunitiesUsingPOST

Sincronizar los roles de contacto de MS Dynamics con Marketo.

Los roles de contacto de MS Dynamics para una oportunidad de MS Dynamics se pueden sincronizar a través del rol de oportunidad de Marketo. El registro de función de oportunidad exige los campos externalOpportunityId, role y leadId.

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored no-header
Campo de rol de oportunidad de Marketo	Campo de rol de contacto de MS Dynamics	Descripción
externalOpportunityId	MS Dynamics Identificador único global sin distinción de mayúsculas y minúsculas de oportunidad	Identifica el rol de oportunidad de Marketo en un objeto de oportunidad de MS Dynamics externo. Es obligatorio que la oportunidad MS Dynamics se sincronice correctamente primero.
leadId	N/D, sería un ID de posible cliente de Marketo	Este sería el ID de posible cliente de Marketo del contacto sincronizado de MS Dynamics. Una vez que el contacto está sincronizado en Marketo, puede usar el identificador único global que distingue entre mayúsculas y minúsculas de MS Dynamics Contact como externalPersonId y la consulta del posible cliente de Marketo mediante la API REST de Marketo.
función	El campo Rol para el contacto de MS Dynamics	Describe la función del contacto en esta oportunidad.

Documentación de la API para la oportunidad: https://experienceleague.adobe.com/es/docs/marketo-developer/marketo/rest/lead-database/opportunities
Documentación de API para sincronizar oportunidades: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Opportunities/operation/syncOpportunitiesUsingPOST

Sincronizar los campos de puntuación de último momento interesante/MSI con MS Dynamics.

Una vez que los objetos de MS Dynamics estén correctamente sincronizados con Marketo, puede aprovechar las funciones de MSI. Los campos Último momento interesante/Puntuación de MSI se expondrán en la API de REST para posibles clientes. Estos campos se calculan mediante MSI y son de solo lectura.

Los campos Último momento interesante/Puntuación de un posible cliente de Marketo deberán sincronizarse regularmente con MS Dynamics mediante el punto final del posible cliente de la API de REST. Consulte este extremo para un posible cliente de Marketo usando externalPersonId como filterType y pasando el GUID de posible cliente de MS Dynamics como filterValue.

table 0-row-1
GET /rest/v1/leads.json?filterType=externalPersonId&filterValues=MS DynamicsLeadId1,MS DynamicsLeadId2

A continuación, puede utilizar los valores de estos campos para sincronizarlos con el objeto de posible cliente/contacto de MS Dynamics.

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 posible cliente de Marketo	Campo de contacto/posible cliente de MS Dynamics	Descripción
msiLastInterestingMomentType	Etiqueta: Tipo de último momento interesante Nombre: Last_Interesting_Moment_Type__c	Tipo del último momento interesante para el posible cliente
msiLastInterestingMomentDate	Etiqueta: Fecha del último momento interesante Nombre: Last_Interesting_Moment_Date__c	Fecha del último momento interesante para el posible cliente
msiLastInterestingMomentDesc	Etiqueta: Descripción del último momento interesante Nombre: Last_Interesting_Moment_Desc__c	Descripción del último momento interesante para el posible cliente
msiLastInterestingMomentSource	Etiqueta: Último momento interesante Source Nombre: Last_Interesting_Moment_Source__c	Source del último momento interesante para el posible cliente
prioridad	Etiqueta: Participación Nombre: Priority__c	Prioridad del posible cliente
relativeUrgency	Etiqueta: Valor de urgencia relativa Nombre: Urgency_Value__c	Relativa urgencia del posible cliente
relativeScoring	Etiqueta: Valor de puntuación relativo Nombre: Relative_Score_Value__c	Puntuación relativa del posible cliente

Documentación de la API de REST de posibles clientes: https://developer.adobe.com/marketo-apis/api/mapi/#tag/Leads/operation/getLeadByIdUsingGET.

note note
NOTE
Para los tipos de objeto Posible cliente/Contactos y Cuentas: Marketo admite el uso de sus propios campos personalizados como campos de ID externos al utilizar Perspectivas de ventas de Marketo. Si necesita ayuda con esta personalización, comuníquese con Soporte técnico de Marketo.

El uso adecuado de los campos externos es clave para que la sincronización no nativa se realice correctamente. Si no ve los datos en algunas vistas, es probable que un campo determinado no se haya sincronizado correctamente. Por ejemplo, si las actividades y los momentos interesantes de un posible cliente no aparecen al buscar en el widget MSI debajo de su cuenta, es probable que la compañía o la cuenta del posible cliente no se hayan sincronizado correctamente. Realizar una solicitud de GET para este posible cliente al especificar los campos externos le ayudará a comprobar si el posible cliente se sincronizó correctamente. Además, el correo electrónico del vendedor externo de Marketo debe coincidir con el del usuario de MS Dynamics correspondiente. Es posible que los datos no se muestren en la pestaña Marketo de MS Dynamics si los correos electrónicos no coinciden.

recommendation-more-help

94ec3174-1d6c-4f51-822d-5424bedeecac