Esquemas y áreas de nombres B2B

Este documento proporciona información sobre la configuración subyacente para los espacios de nombres y esquemas que se van a utilizar con orígenes B2B. 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 B2B.

IMPORTANTE

Debe tener acceso a Real-time Customer Data Platform B2B Edition para que los esquemas B2B participen en Perfil del cliente en tiempo real.

Configuración de espacios de nombres B2B y utilidad de generación automática de esquemas

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

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

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

Variable Descripción Ejemplo
CLIENT_SECRET Un identificador único que se usa para generar el informe {ACCESS_TOKEN}. Consulte el tutorial en autenticación y acceso a las API de 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 en autenticación y acceso a las API de 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 en autenticación y acceso a las API de 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 en autenticación y acceso a las API de Experience Platform para obtener información sobre cómo recuperar su {ACCESS_TOKEN}. Bearer {ACCESS_TOKEN}
META_SCOPE Por lo que se refiere a Marketo, este valor es fijo y siempre se establece en: ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID La variable global contenedor contiene todas las clases proporcionadas por el socio de Experience Platform y Adobe estándar, los grupos de campos de esquema, los tipos de datos y los esquemas. Por lo que se refiere a Marketo, este valor es fijo y siempre está establecido en global. global
PRIVATE_KEY Una credencial utilizada para autenticar su Postman a las API de Experience Platform. Consulte el tutorial sobre la configuración de la consola de desarrollador y 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. Por lo que se refiere a Marketo, este valor es fijo y siempre se establece en: 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 en configuración de la consola de desarrollador y Postman para obtener instrucciones sobre cómo recuperar su {IMS_ORG} información. 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/

Ejecución de las secuencias de comandos

Con Postman configuración de entorno y recopilación, ahora puede ejecutar el script a través del Postman interfaz.

En el 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

La variable Runner se abre. Desde aquí, asegúrese de que todas las casillas de verificación estén seleccionadas y, a continuación, seleccione Run Namespaces and Schemas Autogeneration Utility.

run-generator

Una solicitud correcta crea los espacios de nombres y esquemas necesarios para B2B.

Espacios de nombres B2B

Las áreas de nombres de identidad son un componente de Identity Service que sirven para distinguir el contexto o el tipo de una identidad. Una identidad completa incluye un valor de ID y un área de nombres. Consulte la información general sobre áreas de nombres para obtener más información.

Las áreas de nombres B2B se utilizan en la identidad principal de la entidad.

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

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
Persona B2B b2b_person CROSS_DEVICE
Cuenta B2B b2b_account B2B_ACCOUNT
Oportunidad B2B b2b_opportunity B2B_OPPORTUNITY
Relación de persona de oportunidad B2B b2b_opportunity_person_relation B2B_OPPORTUNITY_PERSON
Campaña B2B b2b_campaign B2B_CAMPAIGN
Miembro de la campaña B2B b2b_campaign_member B2B_CAMPAIGN_MEMBER
Lista de marketing B2B b2b_marketing_list B2B_MARKETING_LIST
Miembro de la Lista de Marketing B2B b2b_marketing_list_member B2B_MARKETING_LIST_MEMBER
Relación de persona de cuenta B2B b2b_account_person_relation B2B_ACCOUNT_PERSON

Esquemas B2B

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 del esquema, incluidos los principios de diseño y las prácticas recomendadas, consulte la conceptos básicos de la composición del esquema.

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

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
Cuenta B2B Cuenta comercial XDM Detalles de la cuenta comercial de XDM Habilitado accountKey.sourceKey en la clase base Cuenta B2B extSourceSystemAudit.externalKey.sourceKey en la clase base Cuenta B2B
  • accountParentKey.sourceKey en el grupo de campos Detalles de cuenta comercial XDM
  • Propiedad de destino: /accountKey/sourceKey
  • Tipo: uno a uno
  • Esquema de referencia: Cuenta B2B
  • Área de nombres: Cuenta B2B
Persona B2B Perfil individual XDM
  • Detalles de persona comercial XDM
  • Componentes de persona empresarial XDM
  • Mapa de identidades
  • Detalles de consentimiento y preferencia
Habilitado b2b.personKey.sourceKey en el grupo de campos Detalles de persona empresarial XDM Persona B2B
  1. extSourceSystemAudit.externalKey.sourceKey del grupo de campos Detalles de persona comercial XDM
  2. workEmail.address del grupo de campos Detalles de persona comercial XDM
  1. Persona B2B
  2. Correo electrónico
  • personComponents.sourceAccountKey.sourceKey del grupo de campos Componentes de persona empresarial XDM
  • Tipo: Varios a uno
  • Esquema de referencia: Cuenta B2B
  • Área de nombres: Cuenta B2B
  • Propiedad de destino: accountKey.sourceKey
  • Nombre de relación del esquema actual: Cuenta
  • Nombre de relación del esquema de referencia: People
Oportunidad B2B Oportunidad comercial XDM Detalles de oportunidades comerciales de XDM Habilitado opportunityKey.sourceKey en la clase base Oportunidad B2B extSourceSystemAudit.externalKey.sourceKey en la clase base Oportunidad B2B
  • accountKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Cuenta B2B
  • Área de nombres: Cuenta B2B
  • Propiedad de destino: accountKey.sourceKey
  • Nombre de relación del esquema actual: Cuenta
  • Nombre de relación del esquema de referencia: Oportunidades
Relación de persona de oportunidad B2B Relación de persona de oportunidad comercial XDM Ninguna Habilitado opportunityPersonKey.sourceKey en la clase base Relación de persona de oportunidad B2B extSourceSystemAudit.externalKey.sourceKey en la clase base Relación de persona de oportunidad B2B Primera relación
  • personKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Persona B2B
  • Área de nombres: Persona B2B
  • Propiedad de destino: b2b.personKey.sourceKey
  • Nombre de relación del esquema actual: Persona
  • Nombre de relación del esquema de referencia: Oportunidades
Segunda relación
  • opportunityKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Oportunidad B2B
  • Área de nombres: Oportunidad B2B
  • Propiedad de destino: opportunityKey.sourceKey
  • Nombre de relación del esquema actual: Oportunidad
  • Nombre de relación del esquema de referencia: People
Campaña B2B Campaña empresarial XDM Detalles de la campaña empresarial XDM Habilitado campaignKey.sourceKey en la clase base Campaña B2B extSourceSystemAudit.externalKey.sourceKey en la clase base Campaña B2B
Miembro de la campaña B2B Miembros de XDM Business Campaign Detalles del miembro de la campaña empresarial XDM Habilitado ccampaignMemberKey.sourceKey en la clase base Miembro de la campaña B2B extSourceSystemAudit.externalKey.sourceKey en la clase base Miembro de la campaña B2B Primera relación
  • personKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Persona B2B
  • Área de nombres: Persona B2B
  • Propiedad de destino: b2b.personKey.sourceKey
  • Nombre de relación del esquema actual: Persona
  • Nombre de relación del esquema de referencia: Campañas
Segunda relación
  • campaignKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Campaña B2B
  • Área de nombres: Campaña B2B
  • Propiedad de destino: campaignKey.sourceKey
  • Nombre de relación del esquema actual: Campaign
  • Nombre de relación del esquema de referencia: People
Lista de marketing B2B Lista de marketing empresarial XDM Ninguna Habilitado marketingListKey.sourceKey en la clase base Lista de marketing B2B Ninguna Ninguna Ninguna La lista estática no está sincronizada desde Salesforce y, por lo tanto, no tiene una identidad secundaria.
Miembro de la Lista de Marketing B2B Miembros de la lista de marketing empresarial XDM Ninguna Habilitado marketingListMemberKey.sourceKey en la clase base Miembro de la Lista de Marketing B2B Ninguna Ninguna Primera relación
  • PersonKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Persona B2B
  • Área de nombres: Persona B2B
  • Propiedad de destino: b2b.personKey.sourceKey
  • Nombre de relación del esquema actual: Persona
  • Nombre de relación del esquema de referencia: Listas de marketing
Segunda relación
  • marketingListKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Lista de marketing B2B
  • Área de nombres: Lista de marketing B2B
  • Propiedad de destino: marketingListKey.sourceKey
  • Nombre de relación del esquema actual: Lista de marketing
  • Nombre de relación del esquema de referencia: People
El miembro de lista estática no está sincronizado desde Salesforce y, por lo tanto, no tiene una identidad secundaria.
Actividad B2B 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
  • Momento interesante
Habilitado personKey.sourceKey del grupo de campos Identificador de persona Persona B2B Ninguna Ninguna Primera relación
  • listOperations.listKey.sourceKey field
  • Tipo: uno a uno
  • Esquema de referencia: Lista de marketing B2B
  • Área de nombres: Lista de marketing B2B
Segunda relación
  • opportunityEvent.opportunityKey.sourceKey field
  • Tipo: uno a uno
  • Esquema de referencia: Oportunidad B2B
  • Área de nombres: Oportunidad B2B
Tercera relación
  • leadOperation.campaignProgression.campaignKey.sourceKey field
  • Tipo: uno a uno
  • Esquema de referencia: Campaña B2B
  • Área de nombres: Campaña B2B
ExperienceEvent es diferente a las entidades. La identidad del evento de experiencia es la persona que realizó la actividad.
Relación de persona de cuenta B2B Relación de persona de cuenta comercial XDM Mapa de identidad Habilitado accountPersonKey.sourceKey en la clase base Relación de persona de cuenta B2B Ninguna Ninguna Primera relación
  • personKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Persona B2B
  • Área de nombres: Persona B2B
  • Propiedad de destino: b2b.personKey.SourceKey
  • Nombre de relación del esquema actual: People
  • Nombre de relación del esquema de referencia: Cuenta
Segunda relación
  • accountKey.sourceKey en la clase base
  • Tipo: Varios a uno
  • Esquema de referencia: Cuenta B2B
  • Área de nombres: Cuenta B2B
  • Propiedad de destino: accountKey.sourceKey
  • Nombre de relación del esquema actual: Cuenta
  • Nombre de relación del esquema de referencia: People

Pasos siguientes

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

En esta página