在UI中建立自訂活動資料的Marketo Engage來源連線和資料流

最後更新： 2025年4月4日
  • 主題：

建立對象：

  • 開發人員
注意
本教學課程提供如何設定並將​ 自訂活動 ​資料從Marketo帶到Experience Platform的特定步驟。 如需如何匯入​ 標準活動 ​資料的步驟，請閱讀Marketo UI指南。

除了標準活動之外，您也可以使用Marketo來源將自訂活動資料帶入Adobe Experience Platform。 本檔案提供如何在UI中使用Marketo來源建立自訂活動資料的來源連線和資料流的步驟。

快速入門

本教學課程需要您實際瞭解下列Adobe Experience Platform元件：

  • B2B名稱空間與結構描述自動產生公用程式： B2B名稱空間與結構描述自動產生公用程式可讓您使用Postman自動產生B2B名稱空間與結構描述的值。 您必須先完成B2B名稱空間和結構描述，才能建立Marketo來源連線和資料流。
  • 來源： Experience Platform允許從各種來源擷取資料，同時讓您能夠使用Experience Platform服務來建構、加標籤以及增強傳入的資料。
  • 體驗資料模型(XDM)： Experience Platform用來組織客戶體驗資料的標準化架構。
  • 身分識別名稱空間：身分識別名稱空間是Identity Service的元件，用來做為身分識別相關內容的指標。 完整身分包含ID值和名稱空間。
  • Real-Time Customer Profile：根據來自多個來源的彙總資料，提供統一的即時消費者設定檔。
  • 沙箱： Experience Platform提供的虛擬沙箱可將單一Experience Platform執行個體分割成個別的虛擬環境，以利開發及改進數位體驗應用程式。

擷取您的自訂活動詳細資料

將自訂活動資料從Marketo引進Experience Platform的第一步是擷取API名稱和自訂活動的顯示名稱。

使用Marketo介面登入您的帳戶。 在左側導覽列中的Database Management下方，選取​ Marketo自訂活動。

介面會更新為自訂活動的顯示，包括有關其各自顯示名稱和API名稱的資訊。 您也可以使用滑鼠右邊欄來選取並檢視您帳戶中的其他自訂活動。

Adobe Marketo Engage UI中的自訂活動介面。

從頂端標題選取​ 欄位 ​以檢視與自訂活動相關聯的欄位。 在此頁面中，您可以檢視自訂活動中欄位的名稱、API名稱、說明和資料型別。 有關個別欄位的詳細資訊將在建立結構描述時的後續步驟中使用。

Marketo Engage UI中的Marketo自訂活動欄位詳細資訊頁面。

在B2B活動結構中設定自訂活動的欄位群組

在Experience Platform UI的​ 結構描述 ​儀表板中，選取​ 瀏覽，然後從結構描述清單中選取​ B2B活動。

秘訣
使用搜尋列可加快您在方案清單中的導覽。

已選取B2B活動結構描述的Experience Platform UI中的結構描述工作區。

為自訂活動建立新的欄位群組

接下來，將新的欄位群組新增至B2B Activity結構描述。 此欄位群組應該對應至您要擷取的自訂活動，且應該使用您先前擷取的自訂活動的顯示名稱。

若要新增欄位群組，請選取​ 構成 ​下的​ 欄位群組 ​面板旁的​ +新增。

結構描述結構。

出現​ 新增欄位群組 ​視窗。 選取「建立新欄位群組」，然後為您在先前步驟中擷取的自訂活動提供相同的顯示名稱，並為您的新欄位群組提供選擇性說明。 完成後，選取​ 新增欄位群組。

標籤與建立新欄位群組的視窗。

建立後，您自訂活動的新欄位群組會出現在欄位群組目錄中。

結構描述結構包含新增至欄位群組面板下的新欄位群組。

將新欄位新增至您的結構描述結構

接下來，將新欄位新增至您的結構描述。 此新欄位必須設為type: object，並將包含自訂活動的個別欄位。

若要新增欄位，請選取結構描述名稱旁的加號(+)。 未命名欄位的專案 | 型別 ​出現。 接下來，使用​ 欄位屬性 ​面板來設定欄位屬性。 將欄位名稱設為自訂活動的API名稱，並將顯示名稱設為自訂活動的顯示名稱。 然後，將型別設定為object並將欄位群組指派給您在上一步建立的自訂活動欄位群組。 完成後，選取​ 套用。

選取加號()的結構描述結構，以便可以新增欄位。

新欄位會顯示在您的結構描述中。

新欄位已新增至結構描述。

將子欄位新增至物件欄位

準備結構描述的最後一步是在您在上一步建立的欄位中新增個別欄位。

新增到結構描述內欄位的一組子欄位。

建立資料流

結構描述設定完成後，您現在可以繼續為自訂活動資料建立資料流。

在Experience Platform UI中，從左側導覽列選取​ 來源 ​以存取來源工作區。 目錄畫面會顯示您可以建立帳戶的各種來源。

您可以從熒幕左側的目錄中選取適當的類別。 或者，您可以使用搜尋列來尋找您要使用的特定來源。

在Adobe應用程式類別下，選取​ Marketo Engage。 然後，選取​ 新增資料 ​以建立新的Marketo資料流。

已選取Marketo Engage來源的Experience Platform UI上的來源目錄。

選取資料

從Marketo資料集清單中選取​ 活動，然後選取​ 下一步。

已選取活動資料集的來源工作流程中的選取資料步驟。

資料流詳細資料

接下來，提供您的資料流的資訊，包括資料集和資料流的名稱和說明、您將使用的結構描述，以及Profile擷取、錯誤診斷和部分擷取的設定。

資料流詳細資料步驟。

對應

系統會自動填入標準活動欄位的對應，但自訂活動欄位必須手動對應至其對應的目標欄位。

若要開始對應您的自訂活動欄位，請選取​ 新增欄位型別，然後選取​ 新增欄位。

包含下拉式功能表的對應步驟可新增欄位。

瀏覽來源資料結構，並尋找您要內嵌的自訂活動欄位。 完成後，選取​ 選取。

秘訣
為避免混淆並處理重複的欄位名稱，自訂活動欄位將以API名稱為前置詞。

來源資料結構。

若要新增目標欄位，請選取結構描述圖示 結構描述圖示 ，然後從目標結構描述中選取自訂活動欄位。

目標結構描述結構。

重複步驟以新增其餘的自訂活動對應欄位。 完成後，選取​ 下一步。

來源與目標資料的所有對應。

審核

檢閱 ​步驟隨即顯示，可讓您在建立新資料流之前先檢閱該資料流。 詳細資料會分組到以下類別中：

  • 連線：顯示來源型別、所選來源實體的相關路徑，以及該來源實體中的資料行數量。
  • 指派資料集與對應欄位：顯示要將來源資料擷取到哪個資料集，包括資料集所堅持的結構描述。

檢閱您的資料流後，請選取「儲存並擷取」，並等待一些時間來建立資料流。

總結連線、資料集和對映欄位資訊的最終稽核步驟。