DocumentaciónExperience PlatformGuía de conectores de origen

Espacios de nombres y esquemas B2B

Last update: Wed Feb 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador
NOTE
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.

IMPORTANT
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 de una identidad. Una identidad completa incluye un valor de identidad y un área de nombres. Lea el 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.

NOTE
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 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 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.

NOTE
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 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 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.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089