B2B名稱空間和結構描述

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

AVAILABILITY

您必須擁有Adobe Real-time Customer Data Platform B2B edition的存取權，您的B2B結構描述才能在即時客戶設定檔中符合資格。

NOTE

您可以在Adobe Experience Platform UI中使用範本，快速建立B2B和B2C資料的資產。如需詳細資訊，請閱讀在Platform UI中使用範本的指南。

請閱讀本檔案，瞭解與B2B來源搭配使用的名稱空間和結構描述的基礎設定。本檔案也提供設定Postman自動化公用程式（產生B2B名稱空間和結構描述所需）的相關詳細資訊。

設定B2B名稱空間和結構描述自動產生公用程式

IMPORTANT

已棄用服務帳戶(JWT)憑證。您必須確保在2025年1月27日之前將應用程式或整合移轉至新的OAuth伺服器對伺服器認證。請閱讀下列檔案，瞭解有關如何將JWT認證移轉至OAuth伺服器對伺服器認證的詳細步驟。

請參閱下列檔案，瞭解如何設定您的Postman環境以支援B2B名稱空間和結構描述自動產生公用程式的先決條件資訊。

您可以從此GitHub存放庫下載名稱空間和結構描述自動產生公用程式集合和環境。
如需有關使用Platform API的詳細資訊，包括如何收集必要標題的值以及讀取範例API呼叫，請參閱Platform API快速入門的指南。
如需如何產生Platform API認證的詳細資訊，請參閱有關驗證和存取Experience PlatformAPI的教學課程。
如需如何設定Platform API Postman的相關資訊，請參閱設定開發人員主控台和 Postman上的教學課程。

透過平台開發人員主控台和Postman設定，您現在可以開始將適當的環境值套用至您的Postman環境。

下表包含範例值，以及有關填入Postman環境的其他資訊：

變數

說明

範例

CLIENT_SECRET

用來產生{ACCESS_TOKEN}的唯一識別碼。如需如何擷取{CLIENT_SECRET}的詳細資訊，請參閱驗證及存取Experience PlatformAPI的教學課程。

{CLIENT_SECRET}

API_KEY

用於驗證對Experience Platform API的呼叫的唯一識別碼。如需如何擷取{API_KEY}的詳細資訊，請參閱驗證及存取Experience PlatformAPI的教學課程。

c8d9a2f5c1e03789bd22e8efdd1bdc1b

ACCESS_TOKEN

完成對Experience Platform API的呼叫所需的授權權杖。如需如何擷取{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系統(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人員

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
來自目前結構描述的關係名稱： Person
參考結構描述中的關係名稱：機會

第二個關聯性

基底類別中的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
來自目前結構描述的關係名稱： Person
來自參考結構描述的關係名稱：行銷活動

第二個關聯性

基底類別中的campaignKey.sourceKey
型別：多對一
參考結構描述：B2B行銷活動
名稱空間： B2B行銷活動
目的地屬性： campaignKey.sourceKey
來自目前結構的關係名稱：行銷活動
來自參照結構描述的關係名稱：人員

B2B 行銷清單

XDM業務行銷清單

None

啟用

基底類別中的marketingListKey.sourceKey

B2B 行銷清單

None

靜態清單未從Salesforce同步，因此沒有次要識別碼。

B2B 行銷清單成員

XDM業務行銷清單成員

None

啟用

基底類別中的marketingListMemberKey.sourceKey

B2B 行銷清單成員

None

第一關聯性

基底類別中的PersonKey.sourceKey
型別：多對一
參考結構描述：B2B人員
名稱空間： B2B人員
目的地屬性： b2b.personKey.sourceKey
來自目前結構描述的關係名稱： Person
來自參考結構描述的關係名稱：行銷清單

第二個關聯性

基底類別中的marketingListKey.sourceKey
型別：多對一
參考結構描述：B2B行銷清單
名稱空間： B2B行銷清單
目的地屬性： marketingListKey.sourceKey
來自目前結構的關係名稱：行銷清單
來自參照結構描述的關係名稱：人員

靜態清單成員未從Salesforce同步，因此沒有次要身分。

B2B活動

XDM ExperienceEvent

造訪網頁
新的潛在客戶
轉換潛在客戶
新增至清單
從清單移除
新增至機會
從機會移除
表格已填寫
連結點擊次數
電子郵件已發送
電子郵件已開啟
電子郵件已點選
電子郵件已退回
電子郵件已退回 (軟彈)
電子郵件已取消
評分已改變
機會已更新
促銷活動進度變更中的狀態
個人識別碼
Marketo網頁URL
有趣的時刻
調用 Webhook
變更促銷活動步調
收入階段已變更
合併潛在客戶
電子郵件已傳送
變更促銷活動串流
新增至行銷活動

啟用

personKey.sourceKey個人識別碼欄位群組

B2B人員

None

第一關聯性

listOperations.listKey.sourceKey欄位
型別：一對一
參考結構描述：B2B行銷清單
名稱空間： B2B行銷清單

第二個關聯性

opportunityEvent.opportunityKey.sourceKey欄位
型別：一對一
參考結構描述：B2B機會
名稱空間： B2B機會

第三關聯性

leadOperation.campaignProgression.campaignKey.sourceKey欄位
型別：一對一
參考結構描述：B2B行銷活動
名稱空間： B2B行銷活動

ExperienceEvent與實體不同。體驗事件的身分識別是執行活動的人員。

B2B帳戶個人關係

XDM商業帳戶個人關係

身分對應

啟用

基底類別中的accountPersonKey.sourceKey

B2B帳戶個人關係

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