Espacios de nombres y esquemas B2B

Última actualización: 2023-05-24
  • Temas:
  • Sources
    Ver más sobre este tema
  • Creado para:
  • Developer
    User
    Admin
    Leader
NOTA

Puede utilizar plantillas en la interfaz de usuario de Adobe Experience Platform para acelerar la creación de recursos para los datos B2B y B2C. Para obtener más información, lea la guía de uso de plantillas en la IU de Platform.

Este documento proporciona información sobre la configuración subyacente de 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 espacios de nombres y esquemas B2B.

IMPORTANTE

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

Configurar áreas de nombres B2B y la 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 de desarrollador de Platform y Postman entorno.

Con una consola para desarrolladores de Platform y Postman configurado, 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 utilizado para generar su {ACCESS_TOKEN}. Consulte el tutorial sobre 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 utilizada para generar su {ACCESS_TOKEN}. Consulte el tutorial sobre 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 sobre autenticación y acceso a las API de Experience Platform para obtener información sobre cómo recuperar su {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN El token de autorización necesario para completar las llamadas a las API de Experience Platform. Consulte el tutorial sobre 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 Con respecto a Marketo, este valor es fijo y siempre se establece en: ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID El global contiene todas las clases, grupos de campos de esquema, tipos de datos y esquemas proporcionados por el Adobe estándar y el socio de Experience Platform. Con respecto a Marketo, este valor es fijo y siempre se establece 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 para desarrolladores y Postman para obtener instrucciones sobre cómo recuperar su {PRIVATE_KEY}. {PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID Credencial utilizada para integrarse en el Adobe I/O. D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS El sistema de 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 establece en: ims-na1.adobelogin.com. ims-na1.adobelogin.com
IMS_ORG Una entidad corporativa que puede poseer o licenciar productos y servicios y permitir el acceso a sus miembros. Consulte el tutorial sobre configuración de la consola para desarrolladores y Postman para obtener instrucciones sobre cómo recuperar su {ORG_ID} información. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME Nombre de la partición de zona protegida virtual que está utilizando. prod
TENANT_ID ID que se utiliza para garantizar que los recursos que crea tengan un espacio de nombres correcto y estén contenidos en su organización. b2bcdpproductiontest
PLATFORM_URL El extremo URL al que realiza llamadas de API. Este valor es fijo y siempre se establece en: http://platform.adobe.io/. http://platform.adobe.io/

Ejecución de scripts

Con su Postman configuración de la colección y el entorno, ahora puede ejecutar la secuencia de comandos a través del Postman interfaz.

En el Postman , seleccione la carpeta raíz de la utilidad auto-generator y, a continuación, seleccione Run desde el encabezado superior.

carpeta-raíz

El Runner aparece la interfaz de. 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.

Áreas 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 de las áreas de nombres B2B.

NOTA

Desplácese hacia 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 campaña B2B b2b_campaign_member B2B_CAMPAIGN_MEMBER
Lista de marketing B2B b2b_marketing_list B2B_MARKETING_LIST
Miembro de lista de marketing B2B b2b_marketing_list_member B2B_MARKETING_LIST_MEMBER
Relación de persona de la 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 datos en Platform, se debe crear un esquema para describir la estructura de los datos y proporcionar restricciones al tipo de datos que se pueden contener en cada campo. Los esquemas constan de una clase base y cero o más grupos de campos de esquema.

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

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

NOTA

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

Nombre del esquema Clase base Grupos de campo Profile en el esquema Identidad principal Área de nombres de identidad principal Identidad secundaria Área de nombres de identidad secundaria Relación Notas
Cuenta B2B Cuenta empresarial de XDM Detalles de la cuenta empresarial 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 empresarial de XDM
  • Propiedad de destino: /accountKey/sourceKey
  • Tipo: uno a uno
  • Esquema de referencia: cuenta B2B
  • Área de nombres: Cuenta B2B
Persona B2B Perfil individual de XDM
  • Detalles de persona de negocios de XDM
  • Componentes de persona empresarial de XDM
  • IdentityMap
  • Detalles de consentimiento y preferencia
Habilitado b2b.personKey.sourceKey en el grupo de campos Detalles de persona de negocio de XDM Persona B2B
  1. extSourceSystemAudit.externalKey.sourceKey del grupo de campos Detalles de persona de negocio de XDM
  2. workEmail.address del grupo de campos Detalles de persona de negocio de XDM
  1. Persona B2B
  2. Correo electrónico
  • personComponents.sourceAccountKey.sourceKey del grupo de campos Componentes de persona de negocio 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: Personas
Oportunidad B2B Oportunidad empresarial de XDM Detalles de oportunidad empresarial 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 empresarial de 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: B2B Person
  • Propiedad de destino: b2b.personKey.sourceKey
  • Nombre de relación del esquema actual: Person
  • 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: Personas
Campaña B2B Campaña empresarial de XDM Detalles de la campaña empresarial de XDM Habilitado campaignKey.sourceKey en la clase base Campaña B2B extSourceSystemAudit.externalKey.sourceKey en la clase base Campaña B2B
Miembro de campaña B2B Miembros de campaña empresarial de XDM Detalles del miembro de la campaña empresarial de XDM Habilitado ccampaignMemberKey.sourceKey en la clase base Miembro de campaña B2B extSourceSystemAudit.externalKey.sourceKey en la clase base Miembro de campaña B2B Primera relación
  • personKey.sourceKey en la clase base
  • Tipo: varios a uno
  • Esquema de referencia: Persona B2B
  • Área de nombres: B2B Person
  • Propiedad de destino: b2b.personKey.sourceKey
  • Nombre de relación del esquema actual: Person
  • Nombre de relación del esquema de referencia: Campaigns
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: Personas
Lista de marketing B2B Lista de marketing empresarial de XDM Ninguna Habilitado marketingListKey.sourceKey en la clase base Lista de marketing B2B Ninguna Ninguna Ninguna La lista estática no se sincroniza desde Salesforce y, por lo tanto, no tiene una identidad secundaria.
Miembro de lista de marketing B2B Miembros de lista de marketing empresarial de XDM Ninguna Habilitado marketingListMemberKey.sourceKey en la clase base Miembro de 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: B2B Person
  • Propiedad de destino: b2b.personKey.sourceKey
  • Nombre de relación del esquema actual: Person
  • 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: Personas
El miembro de la lista estática no está sincronizado desde Salesforce y, por lo tanto, no tiene una identidad secundaria.
Actividad B2B ExperienceEvent de XDM
  • Visitar página web
  • Nuevo posible cliente
  • Convertir posible cliente
  • Añadir a lista
  • Quitar de la lista
  • Añadir a oportunidad
  • Quitar de oportunidad
  • Formulario rellenado
  • Clics en vínculos
  • Correo electrónico enviado
  • Correo electrónico abierto
  • Correo electrónico clicado
  • Correo electrónico rechazado
  • Correo electrónico rechazado
  • Correo electrónico cancelado
  • Puntuación cambiada
  • Oportunidad actualizada
  • Estado en progresión de campaña cambiado
  • Identificador de persona
  • URL web de Marketo
  • Momento interesante
  • Llamar a webhook
  • Cambiar cadencia de campaña
  • Etapa de ingresos cambiada
  • Combinar posibles clientes
  • Correo electrónico enviado
  • Cambiar flujo de campaña
  • Añadir a Campaign
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 la cuenta B2B Relación de persona de la cuenta XDM Mapa de identidad Habilitado accountPersonKey.sourceKey en la clase base Relación de persona de la 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: B2B Person
  • Propiedad de destino: b2b.personKey.SourceKey
  • Nombre de relación del esquema actual: Personas
  • 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: Personas

Pasos siguientes

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

En esta página