B2B命名空間和結構

本檔案提供與B2B來源搭配使用之命名空間和結構之基礎設定的相關資訊。 本檔案也提供有關設定產生B2B命名空間和結構所需的Postman自動化公用程式的詳細資訊。

重要

設定B2B命名空間和架構自動產生公用程式

使用B2B命名空間和架構自動產生公用程式的第一步，是設定您的平台開發人員主控台，以及 Postman 環境。

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

下表包含範例值，以及填入 Postman 環境：

變數 說明 範例
CLIENT_SECRET 用來產生您 {ACCESS_TOKEN}. 請參閱 驗證和存取Experience PlatformAPI 以了解如何擷取 {CLIENT_SECRET}. {CLIENT_SECRET}
JWT_TOKEN JSON Web Token(JWT)是用於生成{ACCESS_TOKEN}的驗證憑據。 請參閱 驗證和存取Experience PlatformAPI 以了解如何產生 {JWT_TOKEN}. {JWT_TOKEN}
API_KEY 用來驗證對Experience PlatformAPI呼叫的唯一識別碼。 請參閱 驗證和存取Experience PlatformAPI 以了解如何擷取 {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN 完成對Experience PlatformAPI的呼叫所需的授權Token。 請參閱 驗證和存取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 用來確保所建立資源與IMS組織中的ID命名方式正確，且內容也包含在您的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 會使用結構，以一致且可重複使用的方式說明資料結構。藉由定義跨系統的一致資料，將可輕易保留意義，而發揮資料應有的價值。

在將資料擷取至Platform之前，必須先建立結構以說明資料的結構，並對每個欄位中可包含的資料類型提供限制。 結構由基類和零個或多個結構欄位組組成。

如需結構構成模型的詳細資訊，包括設計原則和最佳實務，請參閱 綱要構成基本知識.

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

注意

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

架構名稱 基類 欄位群組 Profile 結構 主要身分 主要身分命名空間 次要身分 次要身分命名空間 關係 附註
B2B帳戶 XDM商業帳戶 XDM業務帳戶詳細資訊 啟用 accountKey.sourceKey 在基類中 B2B帳戶 extSourceSystemAudit.externalKey.sourceKey 在基類中 B2B帳戶
  • accountParentKey.sourceKey 在「 XDM業務帳戶詳細資訊」欄位組中
  • 目標屬性： /accountKey/sourceKey
  • 類型：一對一
  • 參考結構：B2B帳戶
  • 命名空間：B2B帳戶
B2B人員 XDM個別設定檔
  • XDM業務人員詳細資訊
  • XDM企業人員元件
  • IdentityMap
  • 同意和偏好設定詳細資訊
 啟用 b2b.personKey.sourceKey 「 XDM業務人員詳細資訊」欄位組 B2B人員
  1. extSourceSystemAudit.externalKey.sourceKey XDM業務人員詳細資訊欄位組
  2. workEmail.address XDM業務人員詳細資訊欄位組
  1. B2B人員
  2. 電子郵件
  • 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 Business Campaign成員 XDM Business Campaign成員詳細資訊 啟用 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
  • 變更促銷活動順序
  • 收入階段已變更
  • 合併銷售機會
  • 已傳送電子郵件
  • 變更促銷活動資料流
  • 新增至Campaign
 啟用 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來源連接器.

本頁內容