Espacios de nombres y esquemas B2B
Lea este documento para obtener 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.
Configurar áreas de nombres B2B y la utilidad de generación automática de esquemas
Consulte la siguiente documentación para obtener información sobre los requisitos previos de cómo configurar su entorno Postman para que sea compatible con el espacio de nombres B2B y la utilidad de generación automática de esquemas.
- Puede descargar la colección de utilidades de generación automática de esquemas y áreas de nombres desde este repositorio de GitHub.
- Para obtener información sobre el uso de las API de Platform, incluidos detalles sobre cómo recopilar valores para los encabezados necesarios y leer llamadas de API de ejemplo, consulte la guía sobre introducción a las API de Platform.
- Para obtener información sobre cómo generar las credenciales de las API de Platform, consulte el tutorial sobre autenticación y acceso a las API de Experience Platform.
- Para obtener información sobre cómo configurar Postman para las API de Platform, consulte el tutorial sobre configuración de la consola para desarrolladores y Postman.
Con una consola de desarrollador de Platform y Postman configuradas, ahora puede empezar a aplicar los valores de entorno apropiados a su entorno Postman.
La siguiente tabla contiene valores de ejemplo, así como información adicional sobre cómo rellenar el entorno Postman:
CLIENT_SECRET
{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}
API_KEY
{API_KEY}
.c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
{ACCESS_TOKEN}
.Bearer {ACCESS_TOKEN}
META_SCOPE
ent_dataservices_sdk
.ent_dataservices_sdk
CONTAINER_ID
global
contiene todas las clases, los grupos de campos de esquema, los tipos de datos y los 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
TECHNICAL_ACCOUNT_ID
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
ims-na1.adobelogin.com
.ims-na1.adobelogin.com
IMS_ORG
{ORG_ID}
.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
prod
TENANT_ID
b2bcdpproductiontest
PLATFORM_URL
http://platform.adobe.io/
.http://platform.adobe.io/
Ejecución de scripts
Con la colección y el entorno Postman 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 autogenerador y, a continuación, seleccione Run en el encabezado superior.
Aparecerá la interfaz Runner. Aquí, asegúrese de que todas las casillas de verificación estén seleccionadas y luego seleccione Run Namespaces and Schemas Autogeneration Utility.
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 sirve para distinguir el contexto de una identidad. Una identidad completa incluye un valor de identidad y un área de nombres. Lea la descripción general de á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.
b2b_person
CROSS_DEVICE
b2b_account
B2B_ACCOUNT
b2b_opportunity
B2B_OPPORTUNITY
b2b_opportunity_person_relation
B2B_OPPORTUNITY_PERSON
b2b_campaign
B2B_CAMPAIGN
b2b_campaign_member
B2B_CAMPAIGN_MEMBER
b2b_marketing_list
B2B_MARKETING_LIST
b2b_marketing_list_member
B2B_MARKETING_LIST_MEMBER
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 forma coherente 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 esquema, incluidos los principios de diseño y las prácticas recomendadas, vea los conceptos básicos de la composición de esquema.
La siguiente tabla contiene información sobre la configuración subyacente de los esquemas B2B.
accountKey.sourceKey
en la clase baseextSourceSystemAudit.externalKey.sourceKey
en la clase baseaccountParentKey.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
- Detalles de la persona empresarial de XDM
- Componentes de la persona empresarial de XDM
- IdentityMap
- Detalles de consentimiento y preferencia
b2b.personKey.sourceKey
en el grupo de campos Detalles de persona de negocios de XDMextSourceSystemAudit.externalKey.sourceKey
del grupo de campos Detalles de persona de negocio de XDMworkEmail.address
del grupo de campos Detalles de persona de negocio de XDM
- Persona B2B
- Correo electrónico
personComponents.sourceAccountKey.sourceKey
del grupo de campos Componentes de persona de negocio de 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
opportunityKey.sourceKey
en la clase baseextSourceSystemAudit.externalKey.sourceKey
en la clase baseaccountKey.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
opportunityPersonKey.sourceKey
en la clase baseextSourceSystemAudit.externalKey.sourceKey
en la clase basePrimera 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
campaignKey.sourceKey
en la clase baseextSourceSystemAudit.externalKey.sourceKey
en la clase baseccampaignMemberKey.sourceKey
en la clase baseextSourceSystemAudit.externalKey.sourceKey
en la clase basePrimera 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
marketingListKey.sourceKey
en la clase basemarketingListMemberKey.sourceKey
en la clase basePrimera 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
- 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 de vínculos
- Correo electrónico enviado
- Correo electrónico abierto
- Correo electrónico en el que se ha hecho clic
- Correo electrónico rechazado
- Correo electrónico rechazado
- Cancelación de la suscripción por correo electrónico
- 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
personKey.sourceKey
del grupo de campos Identificador de personaPrimera relación
listOperations.listKey.sourceKey
campo- Tipo: uno a uno
- Esquema de referencia: Lista de marketing B2B
- Área de nombres: Lista de marketing B2B
Segunda relación
opportunityEvent.opportunityKey.sourceKey
campo- Tipo: uno a uno
- Esquema de referencia: oportunidad B2B
- Área de nombres: oportunidad B2B
Tercera relación
leadOperation.campaignProgression.campaignKey.sourceKey
campo- Tipo: uno a uno
- Esquema de referencia: Campaña B2B
- Área de nombres: Campaña B2B
ExperienceEvent
no coincide con las entidades. La identidad del evento de experiencia es la persona que realizó la actividad.accountPersonKey.sourceKey
en la clase basePrimera 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 obtener información sobre cómo conectar los datos de Marketo a Platform, consulte el tutorial sobre creación de un conector de origen de Marketo en la interfaz de usuario.