B2B名稱空間和結構描述

上次更新: 2023-05-25
  • 主題:
  • Sources
    檢視有關此主題的更多資訊
  • 建立對象:
  • Developer
    User
    Admin
    Leader
注意

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

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

重要

您必須擁有下列專案的存取權: Adobe Real-time Customer Data Platform B2B版本 以便B2B結構描述參與 即時客戶個人檔案.

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

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

使用Platform開發人員控制檯和 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 Platform API呼叫的唯一識別碼。 請參閱教學課程,位置如下: 驗證和存取Experience PlatformAPI 以取得如何擷取 {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN 完成對Experience Platform API的呼叫所需的授權權杖。 請參閱教學課程,位置如下: 驗證和存取Experience PlatformAPI 以取得如何擷取 {ACCESS_TOKEN}. Bearer {ACCESS_TOKEN}
META_SCOPE 關於 Marketo,此值為固定值,且一律設為: ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID global container保有所有標準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,用來確保您建立的資源已正確命名並包含在您的組織內。 b2bcdpproductiontest
PLATFORM_URL 您對其進行API呼叫的URL端點。 此值是固定的,一律設為: http://platform.adobe.io/. http://platform.adobe.io/

執行指令碼

搭配您的 Postman 收集和環境設定,您現在可以透過以下指令碼執行: Postman 介面。

在 Postman 介面,選取自動產生器公用程式的根資料夾,然後選取 Run 從頂端標題。

root-folder

此 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商業人士要素
  • 身分對應
  • 同意和偏好設定詳細資料
啟用 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 Person
  • 名稱空間: B2B Person
  • 目的地屬性: 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 Person
  • 名稱空間: B2B Person
  • 目的地屬性: 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 Person
  • 名稱空間: B2B Person
  • 目的地屬性: 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 Person
  • 名稱空間: B2B Person
  • 目的地屬性: b2b.personKey.SourceKey
  • 來自目前結構描述的關係名稱: People
  • 引用結構描述中的關係名稱:帳戶
第二個關係
  • accountKey.sourceKey 在基底類別中
  • 型別:多對一
  • 參考結構描述: B2B帳戶
  • 名稱空間: B2B帳戶
  • 目的地屬性: accountKey.sourceKey
  • 來自目前結構描述的關係名稱:帳戶
  • 引用結構描述中的關係名稱:人員

後續步驟

若要瞭解如何連結 Marketo 資料轉換至Platform,請參閱以下主題上的教學課程: 在UI中建立Marketo來源聯結器.

此頁面上的