DocumentaciónExperience PlatformGuía de conectores de origen

Espacios de nombres y esquemas B2B

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

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 interfaz de usuario 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 usar el espacio de nombres B2B y la utilidad de generación automática de esquemas es configurar la consola de desarrollador de Platform y el entorno 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:

Variable
Descripción
Ejemplo
CLIENT_SECRET
Un identificador único usado 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 contenedor 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
PRIVATE_KEY
Credencial utilizada para autenticar su instancia de Postman en las API de Experience Platform. Consulte el tutorial sobre la configuración de la consola de desarrolladores y configuración de la consola de 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 la información de {ORG_ID}.
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 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.

carpeta raíz

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.

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

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

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 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 la persona empresarial de XDM
  • Componentes de la persona empresarial de XDM
  • IdentityMap
  • Detalles de consentimiento y preferencia
Habilitado
b2b.personKey.sourceKey en el grupo de campos Detalles de persona de negocios 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 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
Oportunidad B2B
Oportunidad empresarial de XDM
Detalles de la 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 la campaña B2B
Miembros de XDM Business Campaign
Detalles de miembro de la campaña empresarial de 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: 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 la 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 se ha 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 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
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 no coincide con 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 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.

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