B2B名稱空間和結構描述
請閱讀本檔案,瞭解與B2B來源搭配使用的名稱空間和結構描述的基礎設定。 本檔案也提供設定Postman自動化公用程式(產生B2B名稱空間和結構描述所需)的相關詳細資訊。
設定B2B名稱空間和結構描述自動產生公用程式
請參閱下列檔案,瞭解如何設定您的Postman環境以支援B2B名稱空間和結構描述自動產生公用程式的先決條件資訊。
- 您可以從此GitHub存放庫下載名稱空間和結構描述自動產生公用程式集合和環境。
- 如需有關使用Experience Platform API的資訊,包括如何收集必要標題的值以及讀取範例API呼叫的詳細資訊,請參閱Experience Platform API快速入門指南。
- 如需如何產生Experience Platform API認證的詳細資訊,請參閱驗證及存取Experience Platform API教學課程。
- 如需如何為Experience Platform API設定Postman的詳細資訊,請參閱設定開發人員主控台和 Postman上的教學課程。
透過Experience Platform開發人員主控台和Postman設定,您現在可以開始將適當的環境值套用至您的Postman環境。
下表包含範例值,以及有關填入Postman環境的其他資訊:
CLIENT_SECRET{CLIENT_SECRET}API_KEY{API_KEY}的教學課程。c8d9a2f5c1e03789bd22e8efdd1bdc1bACCESS_TOKEN{ACCESS_TOKEN}的教學課程。Bearer {ACCESS_TOKEN}META_SCOPEent_dataservices_sdk。ent_dataservices_sdkCONTAINER_IDglobal容器保有所有標準Adobe和Experience Platform合作夥伴提供的類別、結構描述欄位群組、資料型別和結構描述。 關於Marketo,此值是固定的,且一律設為global。globalTECHNICAL_ACCOUNT_IDD42AEVJZTTJC6LZADUBVPA15@techacct.adobe.comIMSims-na1.adobelogin.com。ims-na1.adobelogin.comIMS_ORG{ORG_ID}的教學課程。ABCEH0D9KX6A7WA7ATQE0TE@adobeOrgSANDBOX_NAMEprodTENANT_IDb2bcdpproductiontestPLATFORM_URLhttp://platform.adobe.io/。http://platform.adobe.io/執行指令碼
設定好Postman集合和環境後,您現在可以透過Postman介面執行指令碼。
在Postman介面中,選取自動產生器公用程式的根資料夾,然後從頂端標題選取Run。
Runner介面出現。 從這裡,確定已選取所有核取方塊,然後選取Run Namespaces and Schemas Autogeneration Utility。
成功的請求會建立B2B所需的名稱空間和結構描述。
B2B名稱空間
身分識別名稱空間是Identity Service的元件,用來區分身分識別的內容。 完整身分包含身分值和名稱空間。 如需詳細資訊,請閱讀名稱空間概觀。
B2B名稱空間會用於實體的主要身分識別中。
下表包含有關B2B名稱空間的基礎設定的資訊。
b2b_personCROSS_DEVICEb2b_accountB2B_ACCOUNTb2b_opportunityB2B_OPPORTUNITYb2b_opportunity_person_relationB2B_OPPORTUNITY_PERSONb2b_campaignB2B_CAMPAIGNb2b_campaign_memberB2B_CAMPAIGN_MEMBERb2b_marketing_listB2B_MARKETING_LISTb2b_marketing_list_memberB2B_MARKETING_LIST_MEMBERb2b_account_person_relationB2B_ACCOUNT_PERSONB2B結構描述
Experience Platform使用結構描述,以一致且可重複使用的方式說明資料結構。 藉由定義跨系統的一致資料,將更容易保留意義,進而從資料中獲得價值。
在將資料擷取到Experience Platform之前,必須組成結構描述資料的結構並對可包含在每個欄位中的資料型別提供限制。 結構描述包含一個基底類別和零個或多個結構描述欄位群組。
如需結構描述組合模型的詳細資訊,包括設計原則和最佳實務,請參閱結構描述組合的基本概念。
下表包含有關B2B結構描述的基礎設定的資訊。
accountKey.sourceKeyextSourceSystemAudit.externalKey.sourceKey- XDM商業帳戶詳細資料欄位群組中的
accountParentKey.sourceKey - 目的地屬性:
/accountKey/sourceKey - 型別:一對一
- 參考結構描述:B2B帳戶
- 名稱空間: B2B帳戶
- XDM商業人士細節
- XDM商業人士要素
- 身分對應
- 同意和偏好設定詳細資料
b2b.personKey.sourceKeyextSourceSystemAudit.externalKey.sourceKey個XDM商業人士詳細資料欄位群組workEmail.address個XDM商業人士詳細資料欄位群組
- B2B人員
- 電子郵件
personComponents.sourceAccountKey.sourceKey個XDM商業人士元件欄位群組- 型別:多對一
- 參考結構描述:B2B帳戶
- 名稱空間: B2B帳戶
- 目的地屬性: accountKey.sourceKey
- 來自目前結構描述的關係名稱:帳戶
- 來自參照結構描述的關係名稱:人員
opportunityKey.sourceKeyextSourceSystemAudit.externalKey.sourceKey- 基底類別中的
accountKey.sourceKey - 型別:多對一
- 參考結構描述:B2B帳戶
- 名稱空間: B2B帳戶
- 目的地屬性:
accountKey.sourceKey - 來自目前結構描述的關係名稱:帳戶
- 參考結構描述中的關係名稱:機會
opportunityPersonKey.sourceKey第一關聯性
- 基底類別中的
personKey.sourceKey - 型別:多對一
- 參考結構描述:B2B人員
- 名稱空間: B2B人員
- 目的地屬性: b2b.personKey.sourceKey
- 來自目前結構描述的關係名稱: Person
- 參考結構描述中的關係名稱:機會
第二個關聯性
- 基底類別中的
opportunityKey.sourceKey - 型別:多對一
- 參考結構描述:B2B機會
- 名稱空間: B2B機會
- 目的地屬性:
opportunityKey.sourceKey - 來自目前結構描述的關係名稱:機會
- 來自參照結構描述的關係名稱:人員
ccampaignMemberKey.sourceKey第一關聯性
- 基底類別中的
personKey.sourceKey - 型別:多對一
- 參考結構描述:B2B人員
- 名稱空間: B2B人員
- 目的地屬性:
b2b.personKey.sourceKey - 來自目前結構描述的關係名稱: Person
- 來自參考結構描述的關係名稱:行銷活動
第二個關聯性
- 基底類別中的
campaignKey.sourceKey - 型別:多對一
- 參考結構描述:B2B行銷活動
- 名稱空間: B2B行銷活動
- 目的地屬性:
campaignKey.sourceKey - 來自目前結構的關係名稱:行銷活動
- 來自參照結構描述的關係名稱:人員
marketingListKey.sourceKeymarketingListMemberKey.sourceKey第一關聯性
- 基底類別中的
PersonKey.sourceKey - 型別:多對一
- 參考結構描述:B2B人員
- 名稱空間: B2B人員
- 目的地屬性:
b2b.personKey.sourceKey - 來自目前結構描述的關係名稱: Person
- 來自參考結構描述的關係名稱:行銷清單
第二個關聯性
- 基底類別中的
marketingListKey.sourceKey - 型別:多對一
- 參考結構描述:B2B行銷清單
- 名稱空間: B2B行銷清單
- 目的地屬性:
marketingListKey.sourceKey - 來自目前結構的關係名稱:行銷清單
- 來自參照結構描述的關係名稱:人員
accountPersonKey.sourceKey第一關聯性
- 基底類別中的
personKey.sourceKey - 型別:多對一
- 參考結構描述:B2B人員
- 名稱空間: B2B人員
- 目的地屬性:
b2b.personKey.SourceKey - 來自目前結構描述的關係名稱:人員
- 來自參照結構描述的關係名稱:帳戶
第二個關聯性
- 基底類別中的
accountKey.sourceKey - 型別:多對一
- 參考結構描述:B2B帳戶
- 名稱空間: B2B帳戶
- 目的地屬性:
accountKey.sourceKey - 來自目前結構描述的關係名稱:帳戶
- 來自參照結構描述的關係名稱:人員
後續步驟
若要瞭解如何將您的Marketo資料連線到Experience Platform,請參閱有關在UI中建立Marketo來源聯結器的教學課程🔗。