B2B名稱空間和結構描述

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

本檔案提供將用於與B2B來源搭配的名稱空間和結構描述的基礎設定資訊。 本檔案也提供設定Postman自動化公用程式(產生B2B名稱空間和結構描述所需)的相關詳細資訊。

IMPORTANT
您必須有Adobe Real-time Customer Data Platform B2B Edition的存取權,B2B結構描述才能參與即時客戶設定檔

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

使用B2B名稱空間和結構描述自動產生公用程式的第一個步驟是設定您的平台開發人員主控台和Postman環境。

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

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

變數
說明
範例
CLIENT_SECRET
用來產生{ACCESS_TOKEN}的唯一識別碼。 如需如何擷取{CLIENT_SECRET}的詳細資訊,請參閱驗證及存取Experience PlatformAPI的教學課程。
{CLIENT_SECRET}
JWT_TOKEN
JSON Web權杖(JWT)是用於產生{ACCESS_TOKEN}的驗證認證。 如需如何產生{JWT_TOKEN}的相關資訊,請參閱驗證及存取Experience PlatformAPI的教學課程。
{JWT_TOKEN}
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
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
企業實體,可以擁有或授權產品及服務並允許存取其成員。 如需如何擷取{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

根資料夾

Runner介面出現。 從這裡,確定已選取所有核取方塊,然後選取​ Run Namespaces and Schemas Autogeneration Utility

run-generator

成功的請求會建立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. 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
  • 來自目前結構描述的關係名稱: 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
None
None
靜態清單未從Salesforce同步,因此沒有次要識別碼。
B2B 行銷清單成員
XDM業務行銷清單成員
None
啟用
基底類別中的marketingListMemberKey.sourceKey
B2B 行銷清單成員
None
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
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