(Beta) Marketo Engage áreas de nombres y esquemas

IMPORTANTE

El origen Marketo Engage está actualmente en versión beta. La función y la documentación están sujetas a cambios.

Este documento proporciona información sobre la configuración subyacente para los espacios de nombres B2B y esquemas utilizados con Marketo Engage (en adelante denominados "Marketo"). Este documento también proporciona detalles sobre la configuración de la utilidad de automatización de Postman necesaria para generar esquemas y áreas de nombres Marketo B2B.

Configure el espacio de nombres Marketo y la utilidad de generación automática de esquemas

El primer paso para utilizar el espacio de nombres Marketo y la utilidad de generación automática de esquemas es configurar la consola del desarrollador de Platform y el entorno Postman.

Con una consola de desarrollador de Platform y Postman configurada, ahora puede empezar a aplicar los valores de entorno adecuados a su entorno Postman.

La siguiente tabla contiene valores de ejemplo, así como información adicional sobre cómo rellenar el entorno Postman:

Variable Descripción Ejemplo
CLIENT_SECRET Identificador único utilizado para generar su {ACCESS_TOKEN}. Consulte el tutorial sobre autenticación y acceso a las API del Experience Platform para obtener información sobre cómo recuperar su {CLIENT_SECRET}. {CLIENT_SECRET}
JWT_TOKEN El token web JSON (JWT) es una credencial de autenticación que se utiliza para generar su {ACCESS_TOKEN}. Consulte el tutorial sobre autenticación y acceso a las API del Experience Platform para obtener información sobre cómo generar su {JWT_TOKEN}. {JWT_TOKEN}
API_KEY Identificador único utilizado para autenticar llamadas a las API de Experience Platform. Consulte el tutorial sobre autenticación y acceso a las API del Experience Platform para obtener información sobre cómo recuperar su {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN Token de autorización necesario para completar llamadas a las API de Experience Platform. Consulte el tutorial sobre autenticación y acceso a las API del Experience Platform para obtener información sobre cómo recuperar su {ACCESS_TOKEN}. Bearer {ACCESS_TOKEN}
META_SCOPE Con respecto a Marketo, este valor es fijo y siempre se establece en: ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID El contenedor global contiene todas las clases, grupos de campos de esquema, tipos de datos y esquemas proporcionados por el socio de Experience Platform y Adobe estándar. Con respecto a Marketo, este valor es fijo y siempre se establece en global. global
PRIVATE_KEY Una credencial utilizada para autenticar la instancia Postman en las API de Experience Platform. Consulte el tutorial sobre la configuración de la consola de desarrollador y la configuración de la consola de desarrollador y Postman para obtener instrucciones sobre cómo recuperar su {PRIVATE_KEY}. {PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID Una credencial utilizada para integrarse en el Adobe I/O. D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS El sistema Identity Management (IMS) proporciona el marco para la autenticación en los servicios de Adobe. Con respecto a Marketo, este valor es fijo y siempre se configura como: ims-na1.adobelogin.com. ims-na1.adobelogin.com
IMS_ORG Una entidad corporativa que puede ser propietaria o titular de licencias de productos y servicios y permitir el acceso a sus miembros. Consulte el tutorial sobre la configuración de la consola del desarrollador y Postman para obtener instrucciones sobre cómo recuperar la información de {IMS_ORG}. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME Nombre de la partición de entorno limitado virtual que está utilizando. prod
TENANT_ID Un ID utilizado para garantizar que los recursos que crea tengan un espacio de nombres adecuado y estén contenidos en su organización de IMS. b2bcdpproductiontest
PLATFORM_URL Punto final de URL al que está realizando llamadas de API. Este valor es fijo y siempre se establece en: http://platform.adobe.io/. http://platform.adobe.io/
munchkinId El ID exclusivo de su cuenta Marketo. Consulte el tutorial sobre la autenticación de su Marketo instancia para obtener información sobre cómo recuperar su munchkinId. 123-ABC-456
sfdc_org_id El ID de organización de su cuenta Salesforce. Consulte la siguiente Salesforce guía para obtener más información sobre cómo adquirir su ID de organización Salesforce. 00D4W000000FgYJUA0
msd_org_id El ID de organización de su cuenta Dynamics. Consulte la siguiente Microsoft Dynamics guía para obtener más información sobre cómo adquirir su ID de organización Dynamics. f6438fab-67e8-4814-a6b5-8c8dcdf7a98f
has_abm Un valor booleano que indica si está suscrito a Marketo Account-Based Marketing. false
has_msi Un valor booleano que indica si está suscrito a Marketo Sales Insight. false

Ejecución de las secuencias de comandos

Con la colección Postman y el entorno configurados, ahora puede ejecutar el script a través de la interfaz Postman.

En la interfaz Postman, seleccione la carpeta raíz de la utilidad del generador automático y, a continuación, seleccione Run en el encabezado superior.

carpeta raíz

Aparece la interfaz Runner. Desde aquí, asegúrese de que todas las casillas de verificación estén seleccionadas y, a continuación, seleccione Run Adobe I/O Access Token Generation + Automate Namespace creation.

run-generator

Una solicitud correcta crea los espacios de nombres B2B y esquemas según las especificaciones beta.

Marketo áreas de nombres

Las áreas de nombres de identidad son un componente de Identity Service que sirve como indicadores del contexto al que se relaciona una identidad.

Una identidad completa incluye un valor de ID y un área de nombres. Se requiere un nuevo espacio de nombres personalizado para cada nueva combinación de Marketo instancia y conjunto de datos. Por ejemplo, un conector de origen Marketo que incorpora el conjunto de datos programs requiere su propio espacio de nombres personalizado, y otro conector de origen de Marketo que incorpora el mismo conjunto de datos también requiere su propio nuevo espacio de nombres personalizado. Consulte la descripción general de los espacios de nombres para obtener más información.

El espacio de nombres Marketo se utiliza en la identidad principal de la entidad.

La siguiente tabla contiene información sobre la configuración subyacente para los espacios de nombres Marketo.

NOTA

Desplácese a la izquierda/derecha para ver todo el contenido de la tabla.

Nombre para mostrar Símbolo de identidad Tipo de identidad Tipo de emisor Tipo de entidad emisora Ejemplo de ID de Munchkin
marketo_person_{MUNCHKIN_ID} generado automáticamente CROSS_DEVICE Marketo person 123-ABC-789
marketo_company_{MUNCHKIN_ID} generado automáticamente B2B_ACCOUNT Marketo company 123-ABC-789
marketo_opportunity_{MUNCHKIN_ID} generado automáticamente B2B_OPPORTUNITY Marketo opportunity 123-ABC-789
marketo_opportunity_contact_role_{MUNCHKIN_ID} generado automáticamente B2B_OPPORTUNITY_PERSON Marketo opportunity contact role 123-ABC-789
marketo_program_{MUNCHKIN_ID} generado automáticamente B2B_CAMPAIGN Marketo program 123-ABC-789
marketo_program_member_{MUNCHKIN_ID} generado automáticamente B2B_CAMPAIGN_MEMBER Marketo program member 123-ABC-789
marketo_static_list_{MUNCHKIN_ID} generado automáticamente B2B_MARKETING_LIST Marketo static list 123-ABC-789
marketo_static_list_member_{MUNCHKIN_ID} generado automáticamente B2B_MARKETING_LIST_MEMBER Marketo static list member 123-ABC-789
marketo_named_account_{MUNCHKIN_ID} generado automáticamente B2B_ACCOUNT Marketo named account 123-ABC-789

Salesforce áreas de nombres

Si está suscrito a la integración Salesforce , el espacio de nombres Salesforce se utiliza en la identidad secundaria de la entidad.

La siguiente tabla contiene información sobre la configuración subyacente para los espacios de nombres Salesforce.

NOTA

Desplácese a la izquierda/derecha para ver todo el contenido de la tabla.

Nombre para mostrar Símbolo de identidad Tipo de identidad Tipo de emisor Tipo de entidad emisora Salesforce ejemplo de ID de organización de suscripción
salesforce_lead_{SALESFORCE_ORGANIZATION_ID} generado automáticamente CROSS_DEVICE Salesforce lead 00DA0000000Hz79
salesforce_account_{SALESFORCE_ORGANIZATION_ID} generado automáticamente B2B_ACCOUNT Salesforce account 00DA0000000Hz79
salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID} generado automáticamente B2B_OPPORTUNITY Salesforce opportunity 00DA0000000Hz79
salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} generado automáticamente B2B_OPPORTUNITY_PERSON Salesforce opportunity contact role 00DA0000000Hz79
salesforce_campaign_{SALESFORCE_ORGANIZATION_ID} generado automáticamente B2B_CAMPAIGN Salesforce campaign 00DA0000000Hz79
salesforce_campaign_member_{SALESFORCE_ORGANIZATION_ID} generado automáticamente B2B_CAMPAIGN_MEMBER Salesforce campaign member 00DA0000000Hz79

Microsoft Dynamics áreas de nombres

Si está suscrito a la integración Dynamics , el espacio de nombres Dynamics se utiliza como identidad secundaria de la entidad.

La siguiente tabla contiene información sobre la configuración subyacente para los espacios de nombres Dynamics.

NOTA

Desplácese a la izquierda/derecha para ver todo el contenido de la tabla.

Nombre para mostrar Símbolo de identidad Tipo de identidad Tipo de emisor Tipo de entidad emisora Dynamics ejemplo de ID de organización de suscripción
microsoft_person_{DYNAMICS_ID} generado automáticamente CROSS_DEVICE Microsoft person 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_account_{DYNAMICS_ID} generado automáticamente B2B_ACCOUNT Microsoft account 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_{DYNAMICS_ID} generado automáticamente B2B_OPPORTUNITY Microsoft opportunity 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_contact_connection_{DYNAMICS_ID} generado automáticamente B2B_OPPORTUNITY_PERSON Microsoft opportunity relationship 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_{DYNAMICS_ID} generado automáticamente B2B_CAMPAIGN Microsoft campaign 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_member_{DYNAMICS_ID} generado automáticamente B2B_CAMPAIGN_MEMBER Microsoft campaign member 94cahe38-e51h-3d57-a9c6-2edklb7184mh

Marketo esquemas

Experience Platform utiliza esquemas para describir la estructura de los datos de una manera uniforme y reutilizable. Al definir los datos de manera uniforme en todos los sistemas, resulta más fácil conservar el significado y, por lo tanto, obtener valor de los datos.

Antes de poder introducir los datos en Platform, se debe componer un esquema para describir la estructura de los datos y proporcionar restricciones al tipo de datos que se puede contener dentro de cada campo. Los esquemas constan de una clase base y de cero o más grupos de campos de esquema.

Para obtener más información sobre el modelo de composición de esquema, incluidos los principios de diseño y las prácticas recomendadas, consulte los conceptos básicos de la composición de esquema.

La siguiente tabla contiene información sobre la configuración subyacente de los esquemas Marketo.

NOTA

Desplácese a la izquierda/derecha para ver todo el contenido de la tabla.

Nombre del esquema Clase base Grupos de campo Profile en Esquema Identidad primaria Área de nombres de identidad principal Identidad secundaria Área de nombres de identidad secundaria Relación Notas
Marketo Company {MUNCHKIN_ID} Cuenta comercial XDM Detalles de la cuenta comercial de XDM Habilitado accountID en la clase base marketo_company_{MUNCHKIN_ID} extSourceSystemAudit.externalID en la clase base salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID en el grupo de campos Detalles de cuenta comercial XDM
  • Tipo: uno a uno
  • Esquema de referencia: Marketo Company {MUNCHKIN_ID}
  • Área de nombres: marketo_company_{MUNCHKIN_ID}
Marketo Person {MUNCHKIN_ID} Perfil individual XDM
  • Detalles de persona comercial XDM
  • Componentes de persona empresarial XDM
  • Mapa de identidades
Habilitado personID en la clase base marketo_person_{MUNCHKIN_ID}
  1. extSourceSystemAudit.externalID del grupo de campos Detalles de persona comercial XDM
  2. workEmail.address del grupo de campos Detalles de persona comercial XDM
  3. identityMap del grupo de campos de mapa de identidad
  1. salesforce_lead_{SALESFORCE_ORGANIZATION_ID}
  2. Correo electrónico
  3. ECID
  • personComponents.sourceAccountID del grupo de campos Componentes de persona empresarial XDM
  • Tipo: Varios a uno
  • Esquema de referencia: Marketo Company {MUNCHKIN_ID}
  • Área de nombres: marketo_company_{MUNCHKIN_ID}
  • Propiedad de destino: accountID
  • Nombre de relación del esquema actual: Cuenta
  • Nombre de relación del esquema de referencia: People
Marketo Opportunity {MUNCHKIN_ID} Oportunidad comercial XDM Detalles de oportunidades comerciales de XDM Habilitado opportunityID en la clase base marketo_opportunity_{MUNCHKIN_ID} extSourceSystemAudit.externalID en la clase base salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID}
  • accountID en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Marketo Company {MUNCHKIN_ID}
  • Área de nombres: marketo_company_{MUNCHKIN_ID}
  • Propiedad de destino: accountID
  • Nombre de relación del esquema actual: Cuenta
  • Nombre de relación del esquema de referencia: Oportunidades
Marketo Opportunity Contact Role {MUNCHKIN_ID} Relación de persona de oportunidad comercial XDM Ninguna Habilitado opportunityPersonID en la clase base marketo_opportunity_contact_role_{MUNCHKIN_ID} extSourceSystemAudit.externalID en la clase base salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} Primera relación
  • personID en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Marketo Person {MUNCHKIN_ID}
  • Área de nombres: marketo_person_{MUNCHKIN_ID}
  • Propiedad de destino: personID
  • Nombre de relación del esquema actual: Persona
  • Nombre de relación del esquema de referencia: Oportunidades
Segunda relación
  • opportunityID en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Marketo Opportunity {MUNCHKIN_ID}
  • Área de nombres: marketo_opportunity_{MUNCHKIN_ID}
  • Propiedad de destino: opportunityID
  • Nombre de relación del esquema actual: Oportunidad
  • Nombre de relación del esquema de referencia: People
Marketo Program {MUNCHKIN_ID} Campaña empresarial XDM Detalles de la campaña empresarial XDM Habilitado campaignID en la clase base marketo_program_{MUNCHKIN_ID} extSourceSystemAudit.externalID en la clase base salesforce_campaign_{SALESFORCE_ORGANIZATION_ID}
Marketo Program Member {MUNCHKIN_ID} Miembro de XDM Business Campaign Detalles del miembro de la campaña empresarial XDM Habilitado campaignMemberID en la clase base marketo_program_member_{MUNCHKIN_ID} Ninguna Ninguna Primera relación
  • personID en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Persona de Marketo {MUNCHKIN_ID}
  • Área de nombres: marketo_person_{MUNCHKIN_ID}
  • Propiedad de destino: personID
  • Nombre de relación del esquema actual: Persona
  • Nombre de relación del esquema de referencia: Programas
Segunda relación
  • campaignID en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Marketo Program {MUNCHKIN_ID}
  • Área de nombres: marketo_program_{MUNCHKIN_ID}
  • Propiedad de destino: campaignID
  • Nombre de relación del esquema actual: Programa
  • Nombre de relación del esquema de referencia: People
Marketo Static List {MUNCHKIN_ID} Lista de marketing empresarial XDM Ninguna Habilitado marketingListID en la clase base marketo_static_list_{MUNCHKIN_ID} Ninguna Ninguna Ninguna La lista estática no está sincronizada desde Salesforce y, por lo tanto, no tiene una identidad secundaria.
Marketo Static List Member {MUNCHKIN_ID} Miembros de la lista de marketing empresarial XDM Ninguna Habilitado marketingListMemberID en la clase base marketo_static_list_member_{MUNCHKIN_ID} Ninguna Ninguna Primera relación
  • personID en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Marketo Person {MUNCHKIN_ID}
  • Área de nombres: marketo_person_{MUNCHKIN_ID}
  • Propiedad de destino: personID
  • Nombre de relación del esquema actual: Persona
  • Nombre de relación del esquema de referencia: Listas
Segunda relación
  • marketingListID en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Marketo Static List {MUNCHKIN_ID}
  • Área de nombres: marketo_static_list_{MUNCHKIN_ID}
  • Propiedad de destino: marketingListID
  • Nombre de relación del esquema actual: Lista
  • Nombre de relación del esquema de referencia: People
El miembro de la lista estática no está sincronizado desde Salesforce y, por lo tanto, no tiene una identidad secundaria.
Marketo Named Account {MUNCHKIN_ID} Cuenta comercial XDM Detalles de la cuenta comercial de XDM Habilitado accountID en la clase base marketo_named_account_{MUNCHKIN_ID} extSourceSystemAudit.externalID en la clase base salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID en el grupo de campos Detalles de cuenta comercial XDM
  • Tipo: uno a uno
  • Esquema de referencia: Marketo Named Account {MUNCHKIN_ID}
  • Área de nombres: marketo_named_account_{MUNCHKIN_ID}
Marketo Actividad {MUNCHKIN ID} XDM ExperienceEvent
  • Visite WebPage
  • Nuevo posible cliente
  • Convertir posible cliente
  • Agregar a lista
  • Quitar de la lista
  • Agregar a oportunidad
  • Eliminar de oportunidad
  • Formulario rellenado
  • Clics en vínculos
  • Correo electrónico enviado
  • Correo electrónico abierto
  • Correo electrónico en el que se hizo clic
  • Correo electrónico rechazado
  • Correo electrónico rechazado leve
  • Cancelación de suscripción de correo electrónico
  • Puntuación cambiada
  • Oportunidad actualizada
  • Cambio del estado en la progresión de la campaña
  • Identificador de persona
  • URL web de Marketo
Habilitado personID del grupo de campos Identificador de persona marketo_person_{MUNCHKIN_ID} Ninguna Ninguna Primera relación
  • listOperations.listID field
  • Tipo: uno a uno
  • Esquema de referencia: Marketo Static List {MUNCHKIN_ID}
  • Área de nombres: marketo_static_list_{MUNCHKIN_ID}
Segunda relación
  • opportunityEvent.opportunityID field
  • Tipo: uno a uno
  • Esquema de referencia: Marketo Opportunity {MUNCHKIN_ID}
  • Área de nombres: marketo_opportunity_{MUNCHKIN_ID}
Tercera relación
  • leadOperation.campaignProgression.campaignID field
  • Tipo: uno a uno
  • Esquema de referencia: Marketo Program {MUNCHKIN_ID}
  • Área de nombres: marketo_program_{MUNCHKIN_ID}
La identidad principal del esquema Marketo Activity {MUNCHKIN_ID} es personID, que es la misma que la identidad principal del esquema [!DNL Marketo] Person {MUNCHKIN_ID}.

Pasos siguientes

Para aprender a conectar los datos Marketo a Platform, consulte el tutorial sobre la creación de un conector de origen de Marketo en la interfaz de usuario.

En esta página