B2B命名空间和架构

AVAILABILITY
您必须有权访问Adobe Real-time Customer Data Platform B2B edition,您的B2B架构才能在实时客户档案中获得资格。
NOTE
您可以使用Adobe Experience Platform UI中的模板来加速B2B和B2C数据的资源创建。 有关详细信息,请阅读有关在Platform UI中使用模板的指南。

请阅读本文档,了解有关为要与B2B源一起使用的命名空间和模式设置的底层信息。 本文档还提供了有关设置生成B2B命名空间和架构所需的Postman自动化实用程序的详细信息。

设置B2B命名空间和模式自动生成实用程序

IMPORTANT
已弃用服务帐户(JWT)凭据。 您必须确保在2025年1月27日之前将您的应用程序或集成迁移到新的OAuth服务器到服务器凭据。 请阅读以下文档,了解有关如何将JWT凭据迁移到OAuth服务器到服务器凭据的详细步骤。

请参阅以下文档,了解有关如何设置Postman环境以支持B2B命名空间和架构自动生成实用程序的先决条件信息。

通过平台开发人员控制台和Postman设置,您现在可以开始将相应的环境值应用到您的Postman环境。

下表包含示例值以及有关填充Postman环境的其他信息:

Variable
描述
示例
CLIENT_SECRET
用于生成{ACCESS_TOKEN}的唯一标识符。 有关如何检索{CLIENT_SECRET}的信息,请参阅有关身份验证和访问Experience PlatformAPI的教程。
{CLIENT_SECRET}
API_KEY
用于对调用Experience PlatformAPI进行身份验证的唯一标识符。 有关如何检索{API_KEY}的信息,请参阅有关身份验证和访问Experience PlatformAPI的教程。
c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
完成对Experience PlatformAPI的调用所需的授权令牌。 有关如何检索{ACCESS_TOKEN}的信息,请参阅有关身份验证和访问Experience PlatformAPI的教程。
Bearer {ACCESS_TOKEN}
META_SCOPE
对于Marketo,此值是固定的,并且始终设置为: ent_dataservices_sdk
ent_dataservices_sdk
CONTAINER_ID
global容器包含所有标准Adobe和Experience Platform合作伙伴提供的类、架构字段组、数据类型和架构。 对于Marketo,此值是固定的,并且始终设置为global
global
TECHNICAL_ACCOUNT_ID
用于集成到Adobe I/O的凭据。
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
Identity Management System (IMS)提供了对Adobe服务进行身份验证的框架。 对于Marketo,此值是固定的,并且始终设置为: ims-na1.adobelogin.com
ims-na1.adobelogin.com
IMS_ORG
公司实体,可以拥有产品或服务,也可以为其授予产品和服务许可证,并允许其成员访问。 有关如何检索{ORG_ID}信息的说明,请参阅有关设置开发人员控制台和 Postman的教程。
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
您正在使用的虚拟沙盒分区的名称。
prod
TENANT_ID
一个ID,用于确保您创建的资源被正确命名并包含在您的组织内。
b2bcdpproductiontest
PLATFORM_URL
您对其进行API调用的URL端点。 此值是固定的,并且始终设置为: http://platform.adobe.io/
http://platform.adobe.io/

运行脚本

设置了Postman收藏集和环境后,您现在可以通过Postman界面运行脚本。

在Postman界面中,选择自动生成器实用工具的根文件夹,然后从顶部标题中选择​ Run

Postman UI中命名空间和架构生成器的根文件夹。 顶部菜单栏中高亮显示“运行”。

出现Runner接口。 在此处,确保选中所有复选框,然后选择​ Run Namespaces and Schemas Autogeneration Utility

已选中Postman UI的Runner界面,该界面的“命名空间和架构”集合中有多个请求,且右侧突出显示了“运行命名空间和架构”按钮。

成功的请求将创建B2B所需的命名空间和架构。

B2B命名空间

身份命名空间是Identity Service的组件,用于区分身份的上下文。 完全限定的身份包括身份值和命名空间。 有关详细信息,请阅读命名空间概述

B2B命名空间在实体的主标识中使用。

下表包含有关B2B命名空间的基础设置的信息。

NOTE
请向左/向右滚动以查看表格的全部内容。
显示名称
身份符号
身份类型
B2B人员
b2b_person
CROSS_DEVICE
B2B 帐户
b2b_account
B2B_ACCOUNT
B2B 机会
b2b_opportunity
B2B_OPPORTUNITY
B2B机会人员关系
b2b_opportunity_person_relation
B2B_OPPORTUNITY_PERSON
B2B 营销活动
b2b_campaign
B2B_CAMPAIGN
B2B 营销活动成员
b2b_campaign_member
B2B_CAMPAIGN_MEMBER
B2B 营销列表
b2b_marketing_list
B2B_MARKETING_LIST
B2B 营销列表成员
b2b_marketing_list_member
B2B_MARKETING_LIST_MEMBER
B2B帐户人员关系
b2b_account_person_relation
B2B_ACCOUNT_PERSON

B2B架构

Experience Platform使用架构以一致且可重用的方式描述数据结构。 通过在系统中以一致的方式定义数据,更容易保留含义并因此从数据中获取价值。

在将数据引入Platform之前,必须组合模式以描述数据的结构并对每个字段中可以包含的数据类型提供约束。 架构由一个基类以及零个或多个架构字段组组成。

有关架构组合模型的更多信息,包括设计原则和最佳实践,请参阅架构组合的基础知识

下表包含有关B2B架构的基础设置的信息。

NOTE
请向左/向右滚动以查看表格的全部内容。
架构名称
基类
字段组
架构中的Profile
主要标识
主要标识命名空间
辅助标识
辅助身份命名空间
关系
注释
B2B 帐户
XDM业务帐户
XDM 业务帐户详细信息
已启用
基类中的accountKey.sourceKey
B2B 帐户
基类中的extSourceSystemAudit.externalKey.sourceKey
B2B 帐户
  • XDM业务帐户详细信息字段组中的accountParentKey.sourceKey
  • 目标属性: /accountKey/sourceKey
  • 类型:一对一
  • 引用架构:B2B帐户
  • 命名空间: B2B帐户
B2B人员
XDM 个人资料
  • XDM 业务人员详细信息
  • XDM 业务人员组件
  • IdentityMap
  • 同意和偏好设置详细信息
已启用
XDM业务人员详细信息字段组中的b2b.personKey.sourceKey
B2B人员
  1. XDM业务人员详细信息字段组的extSourceSystemAudit.externalKey.sourceKey
  2. XDM业务人员详细信息字段组的workEmail.address
  1. B2B人员
  2. 电子邮件
  • XDM业务人员组件字段组的personComponents.sourceAccountKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B帐户
  • 命名空间: B2B帐户
  • 目标属性: accountKey.sourceKey
  • 来自当前架构的关系名称:帐户
  • 引用架构中的关系名称:人员
B2B 机会
XDM业务机会
XDM 商业机会详细信息
已启用
基类中的opportunityKey.sourceKey
B2B 机会
基类中的extSourceSystemAudit.externalKey.sourceKey
B2B 机会
  • 基类中的accountKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B帐户
  • 命名空间: B2B帐户
  • 目标属性: accountKey.sourceKey
  • 来自当前架构的关系名称:帐户
  • 引用架构中的关系名称:机会
B2B机会人员关系
XDM业务机会人员关系
None
已启用
基类中的opportunityPersonKey.sourceKey
B2B机会人员关系
基类中的extSourceSystemAudit.externalKey.sourceKey
B2B机会人员关系

第一个关系

  • 基类中的personKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B人员
  • 命名空间: B2B人员
  • 目标属性: b2b.personKey.sourceKey
  • 来自当前架构的关系名称:人员
  • 引用架构中的关系名称:机会

第二个关系

  • 基类中的opportunityKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B机会
  • 命名空间: B2B机会
  • 目标属性: opportunityKey.sourceKey
  • 来自当前架构的关系名称:机会
  • 引用架构中的关系名称:人员
B2B 营销活动
XDM商业营销活动
XDM 商业营销活动详细信息
已启用
基类中的campaignKey.sourceKey
B2B 营销活动
基类中的extSourceSystemAudit.externalKey.sourceKey
B2B 营销活动
B2B 营销活动成员
XDM商业营销活动成员
XDM 商业营销活动成员详细信息
已启用
基类中的ccampaignMemberKey.sourceKey
B2B 营销活动成员
基类中的extSourceSystemAudit.externalKey.sourceKey
B2B 营销活动成员

第一个关系

  • 基类中的personKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B人员
  • 命名空间: B2B人员
  • 目标属性: b2b.personKey.sourceKey
  • 来自当前架构的关系名称:人员
  • 引用架构中的关系名称:营销活动

第二个关系

  • 基类中的campaignKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B营销活动
  • 命名空间: B2B营销活动
  • 目标属性: campaignKey.sourceKey
  • 来自当前架构的关系名称:营销活动
  • 引用架构中的关系名称:人员
B2B 营销列表
XDM商业营销列表
None
已启用
基类中的marketingListKey.sourceKey
B2B 营销列表
None
None
None
静态列表未从Salesforce同步,因此没有辅助标识。
B2B 营销列表成员
XDM商业营销列表成员
None
已启用
基类中的marketingListMemberKey.sourceKey
B2B 营销列表成员
None
None

第一个关系

  • 基类中的PersonKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B人员
  • 命名空间: B2B人员
  • 目标属性: b2b.personKey.sourceKey
  • 来自当前架构的关系名称:人员
  • 引用架构中的关系名称:营销列表

第二个关系

  • 基类中的marketingListKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B营销列表
  • 命名空间: B2B营销列表
  • 目标属性: marketingListKey.sourceKey
  • 来自当前架构的关系名称:营销列表
  • 引用架构中的关系名称:人员
静态列表成员未从Salesforce同步,因此没有辅助标识。
B2B活动
XDM ExperienceEvent
  • 访问网页
  • 新商机
  • 转化商机
  • 添加到列表
  • 从列表中移除
  • 添加到机会
  • 从机会中移除
  • 表单已填写
  • 链接点击次数
  • 电子邮件已送达
  • 电子邮件已打开
  • 已单击电子邮件
  • 电子邮件退回
  • 电子邮件软退信
  • 已取消订阅电子邮件
  • 分数已更改
  • 已更新机会
  • 营销活动进程中的状态已更改
  • 人员标识符
  • Marketo Web URL
  • 有趣的时刻
  • 调用 Webhook
  • 更改营销活动节奏
  • 收入阶段已更改
  • 合并商机
  • 电子邮件已发送
  • 更改营销活动流
  • 添加到营销活动
已启用
personKey.sourceKey个人标识符字段组
B2B人员
None
None

第一个关系

  • listOperations.listKey.sourceKey字段
  • 类型:一对一
  • 引用架构:B2B营销列表
  • 命名空间: B2B营销列表

第二个关系

  • opportunityEvent.opportunityKey.sourceKey字段
  • 类型:一对一
  • 引用架构:B2B机会
  • 命名空间: B2B机会

第三个关系

  • leadOperation.campaignProgression.campaignKey.sourceKey字段
  • 类型:一对一
  • 引用架构:B2B营销活动
  • 命名空间: B2B营销活动
ExperienceEvent不同于实体。 体验事件的身份是执行活动的人员。
B2B帐户人员关系
XDM业务帐户人员关系
标识映射
已启用
基类中的accountPersonKey.sourceKey
B2B帐户人员关系
None
None

第一个关系

  • 基类中的personKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B人员
  • 命名空间: B2B人员
  • 目标属性: b2b.personKey.SourceKey
  • 来自当前架构的关系名称:人员
  • 引用架构中的关系名称:帐户

第二个关系

  • 基类中的accountKey.sourceKey
  • 类型:多对一
  • 引用架构:B2B帐户
  • 命名空间: B2B帐户
  • 目标属性: accountKey.sourceKey
  • 来自当前架构的关系名称:帐户
  • 引用架构中的关系名称:人员

后续步骤

要了解如何将Marketo数据连接到Platform,请参阅有关在UI中创建Marketo源连接器的教程🔗

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