B2B命名空間和架構

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

重要

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

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

使用B2B命名空間和模式自動生成實用程式的第一步是設定平台開發人員控制台和 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人員
  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業務活動成員 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
  • 有趣的時刻
啟用 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源連接器

本頁內容