(測試版)Marketo Engage名稱空間和結構描述

重要

Marketo Engage來源目前處於測試階段。 功能和說明檔案會有所變更。

本文檔提供有關Marketo Engage(下稱"Marketo")使用的B2B名稱空間和架構的基礎設定的資訊。 本文檔還提供有關設定生成Marketo B2B名稱空間和架構所需的郵遞員自動化實用程式的詳細資訊。

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

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

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

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

變數 說明 範例
CLIENT_SECRET 用於生成{ACCESS_TOKEN}的唯一標識符。 有關如何檢索{CLIENT_SECRET}的資訊,請參閱驗證和訪問Experience PlatformAPI的教程。 {CLIENT_SECRET}
JWT_TOKEN JSON Web Token(JWT)是用來產生{ACCESS_TOKEN}的驗證憑證。 有關如何生成{JWT_TOKEN}的資訊,請參閱驗證和訪問Experience PlatformAPI的教程。 {JWT_TOKEN}
API_KEY 用於驗證對Experience PlatformAPI的呼叫的唯一識別碼。 有關如何檢索{API_KEY}的資訊,請參閱驗證和訪問Experience PlatformAPI的教程。 c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN 完成對Experience PlatformAPI的呼叫所需的授權Token。 有關如何檢索{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的憑據。 如需如何擷取{PRIVATE_KEY}的指示,請參閱有關設定開發人員主控台和設定開發人員主控台和 Postman的教學課程。 {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 可擁有或授權產品與服務並允許存取其成員的公司實體。 有關如何檢索{IMS_ORG}資訊的說明,請參閱設定開發人員控制台和 Postman上的教程。 ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME 您使用的虛擬沙盒分區的名稱。 prod
TENANT_ID 用於確保您建立的資源正確命名並包含在IMS組織中的ID。 b2bcdpproductiontest
PLATFORM_URL 您對其進行API呼叫的URL端點。 此值是固定的,且始終設定為:http://platform.adobe.io/ http://platform.adobe.io/
munchkinId Marketo帳戶的唯一ID。 有關如何檢索munchkinId的資訊,請參閱驗證 Marketo 實例的教程。 123-ABC-456
sfdc_org_id Salesforce帳戶的組織ID。 有關獲取Salesforce組織ID的詳細資訊,請參閱以下Salesforce 指南 00D4W000000FgYJUA0
msd_org_id Dynamics帳戶的組織ID。 有關獲取Dynamics組織ID的詳細資訊,請參閱以下Microsoft Dynamics 指南 f6438fab-67e8-4814-a6b5-8c8dcdf7a98f
has_abm 一個布爾值,指示您是否預訂Marketo Account-Based Marketing。 false
has_msi 一個布爾值,指示您是否被切換到Marketo Sales Insight。 false

運行指令碼

在設定Postman系列和環境後,您現在可以透過Postman介面執行指令碼。

在Postman介面中,選擇自動生成器實用程式的根資料夾,然後從頂部標題中選擇​Run

根資料夾

出現Runner介面。 在此處,確保選中所有複選框,然後選擇​Run Adobe I/O Access Token Generation + Automate Namespace creation

運行生成器

成功的請求會根據測試版規格建立B2B命名空間和結構。

Marketo 命名空間

身分名稱空間是Identity Service的一個元件,用作身份相關上下文的指示器。

完全限定身份包括ID值和命名空間。 每個新Marketo例項和資料集組合都需要新的自訂命名空間。 例如,Marketo來源連接器收錄programs資料集需要其自訂命名空間,而另一個Marketo來源連接器收錄相同資料集也需要其新的自訂命名空間。 如需詳細資訊,請參閱名稱空間概述

Marketo命名空間用於實體的主要標識。

下表包含有關Marketo名稱空間的基礎設定的資訊。

注意

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

顯示名稱 身分符號 身分類型 發行者類型 發行者實體類型 Munchkin ID範例
marketo_person_{MUNCHKIN_ID} 自動產生 CROSS_DEVICE Marketo person 123-ABC-789
marketo_company_{MUNCHKIN_ID} 自動產生 B2B_ACCOUNT Marketo company 123-ABC-789
marketo_opportunity_{MUNCHKIN_ID} 自動產生 B2B_OPPORTUNITY Marketo opportunity 123-ABC-789
marketo_opportunity_contact_role_{MUNCHKIN_ID} 自動產生 B2B_OPPORTUNITY_PERSON Marketo opportunity contact role 123-ABC-789
marketo_program_{MUNCHKIN_ID} 自動產生 B2B_CAMPAIGN Marketo program 123-ABC-789
marketo_program_member_{MUNCHKIN_ID} 自動產生 B2B_CAMPAIGN_MEMBER Marketo program member 123-ABC-789
marketo_static_list_{MUNCHKIN_ID} 自動產生 B2B_MARKETING_LIST Marketo static list 123-ABC-789
marketo_static_list_member_{MUNCHKIN_ID} 自動產生 B2B_MARKETING_LIST_MEMBER Marketo static list member 123-ABC-789
marketo_named_account_{MUNCHKIN_ID} 自動產生 B2B_ACCOUNT Marketo named account 123-ABC-789

Salesforce 命名空間

如果您訂閱Salesforce整合,則會在實體的次要識別中使用Salesforce命名空間。

下表包含有關Salesforce名稱空間的基礎設定的資訊。

注意

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

顯示名稱 身分符號 身分類型 發行者類型 發行者實體類型 Salesforce 訂閱組織ID範例
salesforce_lead_{SALESFORCE_ORGANIZATION_ID} 自動產生 CROSS_DEVICE Salesforce lead 00DA0000000Hz79
salesforce_account_{SALESFORCE_ORGANIZATION_ID} 自動產生 B2B_ACCOUNT Salesforce account 00DA0000000Hz79
salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID} 自動產生 B2B_OPPORTUNITY Salesforce opportunity 00DA0000000Hz79
salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} 自動產生 B2B_OPPORTUNITY_PERSON Salesforce opportunity contact role 00DA0000000Hz79
salesforce_campaign_{SALESFORCE_ORGANIZATION_ID} 自動產生 B2B_CAMPAIGN Salesforce campaign 00DA0000000Hz79
salesforce_campaign_member_{SALESFORCE_ORGANIZATION_ID} 自動產生 B2B_CAMPAIGN_MEMBER Salesforce campaign member 00DA0000000Hz79

Microsoft Dynamics 命名空間

如果您訂閱Dynamics整合,則Dynamics命名空間會用作實體的次要身分識別。

下表包含有關Dynamics名稱空間的基礎設定的資訊。

注意

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

顯示名稱 身分符號 身分類型 發行者類型 發行者實體類型 Dynamics 訂閱組織ID範例
microsoft_person_{DYNAMICS_ID} 自動產生 CROSS_DEVICE Microsoft person 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_account_{DYNAMICS_ID} 自動產生 B2B_ACCOUNT Microsoft account 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_{DYNAMICS_ID} 自動產生 B2B_OPPORTUNITY Microsoft opportunity 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_contact_connection_{DYNAMICS_ID} 自動產生 B2B_OPPORTUNITY_PERSON Microsoft opportunity relationship 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_{DYNAMICS_ID} 自動產生 B2B_CAMPAIGN Microsoft campaign 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_member_{DYNAMICS_ID} 自動產生 B2B_CAMPAIGN_MEMBER Microsoft campaign member 94cahe38-e51h-3d57-a9c6-2edklb7184mh

Marketo 模式

Experience Platform 會使用結構,以一致且可重複使用的方式說明資料結構。藉由定義跨系統的一致資料,將可輕易保留意義,而發揮資料應有的價值。

在將資料引入平台之前,必須構建一個模式來描述資料的結構,並為每個欄位中可包含的資料類型提供約束。 方案由基本類和零個或多個方案欄位組組成。

有關架構構成模型(包括設計原則和最佳實踐)的詳細資訊,請參閱架構構成基礎

下表包含有關Marketo方案的基礎設定的資訊。

注意

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

架構名稱 基本類 欄位群組 Profile 在架構中 主要身分 主要身分名稱空間 次要身份 次要身分名稱空間 關係 附註
Marketo Company {MUNCHKIN_ID} XDM業務帳戶 XDM業務帳戶詳細資訊 啟用 accountID 在基本類中 marketo_company_{MUNCHKIN_ID} extSourceSystemAudit.externalID 在基本類中 salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID 在「XDM業務帳戶詳細資訊」欄位組中
  • 類型:一對一
  • 參考結構:Marketo Company {MUNCHKIN_ID}
  • 命名空間: marketo_company_{MUNCHKIN_ID}
Marketo Person {MUNCHKIN_ID} XDM個人資料
  • XDM業務人員詳細資訊
  • XDM業務人員元件
  • IdentityMap
啟用 personID 在基本類中 marketo_person_{MUNCHKIN_ID}
  1. extSourceSystemAudit.externalID XDM業務人員詳細資訊欄位組
  2. workEmail.address XDM業務人員詳細資訊欄位組
  3. identityMap Identity Map欄位群組
  1. salesforce_lead_{SALESFORCE_ORGANIZATION_ID}
  2. 電子郵件
  3. ECID
  • personComponents.sourceAccountID XDM業務人員元件欄位組
  • 類型:多對一
  • 參考結構:Marketo Company {MUNCHKIN_ID}
  • 命名空間: marketo_company_{MUNCHKIN_ID}
  • 目標屬性:accountID
  • 當前方案的關係名稱:帳戶
  • 參考方案中的關係名稱:人物
Marketo Opportunity {MUNCHKIN_ID} XDM業務機會 XDM業務機會詳細資訊 啟用 opportunityID 在基本類中 marketo_opportunity_{MUNCHKIN_ID} extSourceSystemAudit.externalID 在基本類中 salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID}
  • accountID 在基本類中
  • 類型:多對一
  • 參考結構:Marketo Company {MUNCHKIN_ID}
  • 命名空間: marketo_company_{MUNCHKIN_ID}
  • 目標屬性:accountID
  • 當前方案的關係名稱:帳戶
  • 參考方案中的關係名稱:機會
Marketo Opportunity Contact Role {MUNCHKIN_ID} XDM業務機會人關係 None 啟用 opportunityPersonID 在基本類中 marketo_opportunity_contact_role_{MUNCHKIN_ID} extSourceSystemAudit.externalID 在基本類中 salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} 第一關係
  • personID 在基本類中
  • 類型:多對一
  • 參考結構:Marketo Person {MUNCHKIN_ID}
  • 命名空間: marketo_person_{MUNCHKIN_ID}
  • 目標屬性:personID
  • 當前方案的關係名稱:人物
  • 參考方案中的關係名稱:機會
第二種關係
  • opportunityID 在基本類中
  • 類型:多對一
  • 參考結構:Marketo Opportunity {MUNCHKIN_ID}
  • 命名空間: marketo_opportunity_{MUNCHKIN_ID}
  • 目標屬性:opportunityID
  • 當前方案的關係名稱:機會
  • 參考方案中的關係名稱:人物
Marketo Program {MUNCHKIN_ID} XDM Business Campaign XDM Business Campaign詳細資訊 啟用 campaignID 在基本類中 marketo_program_{MUNCHKIN_ID} extSourceSystemAudit.externalID 在基本類中 salesforce_campaign_{SALESFORCE_ORGANIZATION_ID}
Marketo Program Member {MUNCHKIN_ID} XDM Business Campaign會員 XDM Business Campaign成員詳細資訊 啟用 campaignMemberID 在基本類中 marketo_program_member_{MUNCHKIN_ID} 第一關係
  • personID 在基本類中
  • 類型:多對一
  • 參考結構:Marketo人{MUNCHKIN_ID}
  • 命名空間: marketo_person_{MUNCHKIN_ID}
  • 目標屬性:personID
  • 當前方案的關係名稱:人物
  • 參考方案中的關係名稱:計畫
第二種關係
  • campaignID 在基本類中
  • 類型:多對一
  • 參考結構:Marketo Program {MUNCHKIN_ID}
  • 命名空間: marketo_program_{MUNCHKIN_ID}
  • 目標屬性:campaignID
  • 當前方案的關係名稱:計畫
  • 參考方案中的關係名稱:人物
Marketo Static List {MUNCHKIN_ID} XDM業務營銷清單 啟用 marketingListID 在基本類中 marketo_static_list_{MUNCHKIN_ID} 靜態清單與Salesforce不同步,因此沒有次標識。
Marketo Static List Member {MUNCHKIN_ID} XDM Business Marketing List成員 啟用 marketingListMemberID 在基本類中 marketo_static_list_member_{MUNCHKIN_ID} 第一關係
  • personID 在基本類中
  • 類型:多對一
  • 參考結構:Marketo Person {MUNCHKIN_ID}
  • 命名空間: marketo_person_{MUNCHKIN_ID}
  • 目標屬性:personID
  • 當前方案的關係名稱:人物
  • 參考方案中的關係名稱:清單
第二種關係
  • marketingListID 在基本類中
  • 類型:多對一
  • 參考結構:Marketo Static List {MUNCHKIN_ID}
  • 命名空間: marketo_static_list_{MUNCHKIN_ID}
  • 目標屬性:marketingListID
  • 當前方案的關係名稱:清單
  • 參考方案中的關係名稱:人物
靜態清單成員與Salesforce不同步,因此沒有次標識。
Marketo Named Account {MUNCHKIN_ID} XDM業務帳戶 XDM業務帳戶詳細資訊 啟用 accountID 在基本類中 marketo_named_account_{MUNCHKIN_ID} extSourceSystemAudit.externalID 在基本類中 salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID 在「XDM業務帳戶詳細資訊」欄位組中
  • 類型:一對一
  • 參考結構:Marketo Named Account {MUNCHKIN_ID}
  • 命名空間: marketo_named_account_{MUNCHKIN_ID}
Marketo 活動 {MUNCHKIN ID} XDM ExperienceEvent
  • 造訪網頁
  • 新銷售線索
  • 轉換銷售線索
  • 新增至清單
  • 從清單中移除
  • 添加到業務機會
  • 從銷售機會中刪除
  • 填寫的表單
  • 連結點按次數
  • 電子郵件傳送
  • 已開啟電子郵件
  • 已點按電子郵件
  • 電子郵件已退回
  • Email Roburced Soft
  • 取消訂閱電子郵件
  • 分數已變更
  • 業務機會更新
  • 促銷活動進展狀態已變更
  • 人員識別碼
  • Marketo網址
啟用 personID 人員識別碼欄位群組 marketo_person_{MUNCHKIN_ID} 第一關係
  • listOperations.listID 欄位
  • 類型:一對一
  • 參考結構:Marketo Static List {MUNCHKIN_ID}
  • 命名空間: marketo_static_list_{MUNCHKIN_ID}
第二種關係
  • opportunityEvent.opportunityID 欄位
  • 類型:一對一
  • 參考結構:Marketo Opportunity {MUNCHKIN_ID}
  • 命名空間: marketo_opportunity_{MUNCHKIN_ID}
第三種關係
  • leadOperation.campaignProgression.campaignID 欄位
  • 類型:一對一
  • 參考結構:Marketo Program {MUNCHKIN_ID}
  • 命名空間: marketo_program_{MUNCHKIN_ID}
Marketo Activity {MUNCHKIN_ID}架構的主要身份是personID,與[!DNL Marketo] Person {MUNCHKIN_ID}架構的主要身份相同。

後續步驟

如要瞭解如何將Marketo資料連接至平台,請參閱UI🔗中有關建立Marketo源連接器的教學課程。

本頁內容