B2B命名空間和架構

本文檔提供有關要與B2B源一起使用的命名空間和架構的基礎設定的資訊。本文檔還提供了有關設定生成B2B命名空間和架構所需的Postman自動化實用程式的詳細資訊。

重要

您必須有權訪問 Real-time Customer Data PlatformB2B版以便B2B模式參與即時客戶概要資訊。

設定B2B命名空間和模式自動生成實用程式

使用B2B命名空間和模式自動生成實用程式的第一步是設定平台開發人員控制台和 Postman 環境。

可以從此下載命名空間和架構自動生成實用程式集合及環境 GitHub儲存庫。
有關使用平台API的資訊，包括有關如何收集所需標頭值和讀取示例API調用的詳細資訊，請參閱上的指南平台API入門。
有關如何為平台API生成憑據的資訊，請參見上的教程驗證和訪問Experience PlatformAPI。
有關如何設定的資訊 Postman 有關平台API，請參見上的教程設定開發人員控制台和 Postman。

使用平台開發人員控制台和 Postman 設定後，您現在可以開始將適當的環境值應用到 Postman 環境。

下表包含示例值以及有關填充 Postman 環境：

變數	說明	範例
`CLIENT_SECRET`	用於生成您的 `{ACCESS_TOKEN}`。請參閱上的教程驗證和訪問Experience PlatformAPI 有關如何檢索 `{CLIENT_SECRET}`。	`{CLIENT_SECRET}`
`JWT_TOKEN`	JSON Web令牌(JWT)是用於生成{ACCESS_TOKEN}的身份驗證憑據。請參閱上的教程驗證和訪問Experience PlatformAPI 有關如何生成 `{JWT_TOKEN}`。	`{JWT_TOKEN}`
`API_KEY`	用於驗證對Experience PlatformAPI的調用的唯一標識符。請參閱上的教程驗證和訪問Experience PlatformAPI 有關如何檢索 `{API_KEY}`。	`c8d9a2f5c1e03789bd22e8efdd1bdc1b`
`ACCESS_TOKEN`	完成對Experience PlatformAPI的調用所需的授權令牌。請參閱上的教程驗證和訪問Experience PlatformAPI 有關如何檢索 `{ACCESS_TOKEN}`。	`Bearer {ACCESS_TOKEN}`
`META_SCOPE`	關於 Marketo，此值是固定的，並且始終設定為： `ent_dataservices_sdk`。	`ent_dataservices_sdk`
`CONTAINER_ID`	的 `global` 容器包含所有標準Adobe和Experience Platform夥伴提供的類、架構欄位組、資料類型和架構。關於 Marketo，此值是固定的，始終設定為 `global`。	`global`
`PRIVATE_KEY`	用於驗證您的 Postman 實例到Experience PlatformAPI。請參閱有關設定開發人員控制台和設定開發人員控制台和 Postman 有關如何檢索{PRIVATE_KEY}的說明。	`{PRIVATE_KEY}`
`TECHNICAL_ACCOUNT_ID`	用於整合到Adobe I/O的憑據。	`D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com`
`IMS`	Identity Management系統(IMS)為Adobe服務提供了驗證框架。關於 Marketo，此值是固定的，並且始終設定為： `ims-na1.adobelogin.com`。	`ims-na1.adobelogin.com`
`IMS_ORG`	擁有或許可產品和服務並允許訪問其成員的公司實體。請參閱上的教程設定開發人員控制台和 Postman 有關如何檢索 `{ORG_ID}` 的下界。	`ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg`
`SANDBOX_NAME`	您正在使用的虛擬沙盒分區的名稱。	`prod`
`TENANT_ID`	一個ID，用於確保您建立的資源與IMS組織中的資源同名並包含在您的IMS組織中。	`b2bcdpproductiontest`
`PLATFORM_URL`	要對其進行API調用的URL終結點。此值是固定的，始終設定為： `http://platform.adobe.io/`。	`http://platform.adobe.io/`

運行指令碼

與 Postman 設定集合和環境，您現在可以通過 Postman 。

在 Postman 介面，選擇自動生成器實用程式的根資料夾，然後選擇 Run 的下界。

根資料夾

的 Runner 對話框。在此處，確保選中所有複選框，然後選擇 Run Namespaces and Schemas Autogeneration Utility。

運行發電機

成功的請求會建立B2B所需的命名空間和架構。

B2B命名空間

標識命名空間是 Identity Service 用來區分身份的上下文或類型。完全限定的標識包括ID值和命名空間。查看命名空間概述的子菜單。

B2B命名空間用於實體的主標識。

下表包含有關為B2B命名空間設定的基礎設定的資訊。

注意

請向左/向右滾動以查看表的完整內容。

顯示名稱	標識符號	身分類型
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 會使用結構，以一致且可重複使用的方式說明資料結構。藉由定義跨系統的一致資料，將可輕易保留意義，而發揮資料應有的價值。

在將資料引入平台之前，必須構建一個架構來描述資料的結構，並對每個欄位中可以包含的資料類型提供約束。架構由基類和零個或多個架構欄位組組成。

有關架構組成模型（包括設計原則和最佳做法）的詳細資訊，請參見架構組合基礎。

下表包含有關B2B架構的基礎設定的資訊。

注意

請向左/向右滾動以查看表的完整內容。

架構名稱	基類	欄位群組	Profile 在架構中	主標識	主標識命名空間	次標識	輔助標識命名空間	關係	附註
B2B帳戶	XDM業務客戶	XDM業務帳戶詳細資訊	啟用	`accountKey.sourceKey` 在基類中	B2B帳戶	`extSourceSystemAudit.externalKey.sourceKey` 在基類中	B2B帳戶	`accountParentKey.sourceKey` 在「XDM業務帳戶詳細資訊」欄位組中目標屬性： `/accountKey/sourceKey` 類型：一對一引用架構：B2B帳戶命名空間：B2B帳戶
B2B人員	XDM個人配置檔案	XDM業務人員詳細資訊 XDM業務人員元件標識映射同意和首選項詳細資訊	啟用	`b2b.personKey.sourceKey` 在「XDM業務人員詳細資訊」欄位組中	B2B人員	`extSourceSystemAudit.externalKey.sourceKey` XDM業務人員詳細資訊欄位組 `workEmail.address` XDM業務人員詳細資訊欄位組	B2B人員電子郵件	`personComponents.sourceAccountKey.sourceKey` XDM業務人員元件欄位組類型：多對一引用架構：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業務營銷清單	無	啟用	`marketingListKey.sourceKey` 在基類中	B2B市場營銷清單	無	無	無	靜態清單未從同步 Salesforce 因此沒有第二身份。
B2B市場營銷清單成員	XDM業務營銷清單成員	無	啟用	`marketingListMemberKey.sourceKey` 在基類中	B2B市場營銷清單成員	無	無	第一段關係 `PersonKey.sourceKey` 在基類中類型：多對一引用架構：B2B人員命名空間：B2B人員目標屬性： `b2b.personKey.sourceKey` 當前架構的關係名稱：人員來自引用架構的關係名稱：市場營銷清單第二關係 `marketingListKey.sourceKey` 在基類中類型：多對一引用架構：B2B市場營銷清單命名空間：B2B市場營銷清單目標屬性： `marketingListKey.sourceKey` 當前架構的關係名稱：市場營銷清單來自引用架構的關係名稱：人物	靜態清單成員未從同步 Salesforce 因此沒有第二身份。
B2B活動	XDM體驗事件	訪問Web頁新潛在客戶轉換潛在顧客添加到清單從清單中刪除添加到機會從機會中刪除已填寫窗體連結按一下電子郵件已發送已開啟電子郵件已按一下電子郵件電子郵件已退回電子郵件已跳過軟取消訂閱電子郵件分數已更改業務機會已更新市場活動進展狀態已更改人員標識符 Marketo網站URL 有趣的時刻呼叫Webhook 更改市場活動指南收入階段已更改合併銷售線索已傳送電子郵件更改市場活動流添加到市場活動	啟用	`personKey.sourceKey` 人員標識符欄位組	B2B人員	無	無	第一段關係 `listOperations.listKey.sourceKey` 場類型：一對一引用架構：B2B市場營銷清單命名空間：B2B市場營銷清單第二關係 `opportunityEvent.opportunityKey.sourceKey` 場類型：一對一引用架構：B2B機會命名空間：B2B機會第三種關係 `leadOperation.campaignProgression.campaignKey.sourceKey` 場類型：一對一引用架構：B2B活動命名空間：B2B活動	`ExperienceEvent` 與實體不同。體驗事件的身份是執行該活動的人。
B2B帳戶人員關係	XDM業務帳戶人員關係	身分對應	啟用	`accountPersonKey.sourceKey` 在基類中	B2B帳戶人員關係	無	無	第一段關係 `personKey.sourceKey` 在基類中類型：多對一引用架構：B2B人員命名空間：B2B人員目標屬性： `b2b.personKey.SourceKey` 當前架構的關係名稱：人物來自引用架構的關係名稱：帳戶第二關係 `accountKey.sourceKey` 在基類中類型：多對一引用架構：B2B帳戶命名空間：B2B帳戶目標屬性： `accountKey.sourceKey` 當前架構的關係名稱：帳戶來自引用架構的關係名稱：人物

後續步驟

瞭解如何連接 Marketo 資料到平台，請參閱上的教程在UI中建立Marketo源連接器。

全新的改善搜尋

B2B命名空間和架構

設定B2B命名空間和模式自動生成實用程式

運行指令碼

B2B命名空間

B2B模式

後續步驟

Business.Adobe.com 資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe