在UI中建立自訂活動資料的Marketo Engage來源連線和資料流
除了標準活動之外，您也可以使用Marketo來源將自訂活動資料帶入Adobe Experience Platform。 本檔案提供如何在UI中使用Marketo來源建立自訂活動資料的來源連線和資料流的步驟。
快速入門
本教學課程需要您實際瞭解下列Adobe Experience Platform元件：
- B2B名稱空間與結構描述自動產生公用程式： B2B名稱空間與結構描述自動產生公用程式可讓您使用Postman自動產生B2B名稱空間與結構描述的值。 您必須先完成B2B名稱空間和結構描述，才能建立Marketo來源連線和資料流。
- 來源： Experience Platform允許從各種來源擷取資料，同時讓您能夠使用Experience Platform服務來建構、加標籤以及增強傳入的資料。
- 體驗資料模型(XDM)： Experience Platform用來組織客戶體驗資料的標準化架構。
- 在UI中建立和編輯結構描述：瞭解如何在UI中建立和編輯結構描述。
- 身分識別名稱空間：身分識別名稱空間是Identity Service的元件，用來做為身分識別相關內容的指標。 完整身分包含ID值和名稱空間。
- Real-Time Customer Profile：根據來自多個來源的彙總資料，提供統一的即時消費者設定檔。
- 沙箱： Experience Platform提供的虛擬沙箱可將單一Experience Platform執行個體分割成個別的虛擬環境，以利開發及改進數位體驗應用程式。
擷取您的自訂活動詳細資料
將自訂活動資料從Marketo引進Experience Platform的第一步是擷取API名稱和自訂活動的顯示名稱。
使用Marketo介面登入您的帳戶。 在左側導覽列中的Database Management下方，選取 Marketo自訂活動。
介面會更新為自訂活動的顯示，包括有關其各自顯示名稱和API名稱的資訊。 您也可以使用滑鼠右邊欄來選取並檢視您帳戶中的其他自訂活動。
從頂端標題選取 欄位 以檢視與自訂活動相關聯的欄位。 在此頁面中，您可以檢視自訂活動中欄位的名稱、API名稱、說明和資料型別。 有關個別欄位的詳細資訊將在建立結構描述時的後續步驟中使用。
在B2B活動結構中設定自訂活動的欄位群組
在Experience Platform UI的 結構描述 儀表板中，選取 瀏覽，然後從結構描述清單中選取 B2B活動。
為自訂活動建立新的欄位群組
接下來，將新的欄位群組新增至B2B Activity結構描述。 此欄位群組應該對應至您要擷取的自訂活動，且應該使用您先前擷取的自訂活動的顯示名稱。
若要新增欄位群組，請選取 構成 下的 欄位群組 面板旁的 +新增。
出現 新增欄位群組 視窗。 選取「建立新欄位群組」，然後為您在先前步驟中擷取的自訂活動提供相同的顯示名稱，並為您的新欄位群組提供選擇性說明。 完成後，選取 新增欄位群組。
建立後，您自訂活動的新欄位群組會出現在欄位群組目錄中。
將新欄位新增至您的結構描述結構
接下來，將新欄位新增至您的結構描述。 此新欄位必須設為type: object，並將包含自訂活動的個別欄位。
若要新增欄位，請選取結構描述名稱旁的加號(+)。 未命名欄位的專案 | 型別 出現。 接下來，使用 欄位屬性 面板來設定欄位屬性。 將欄位名稱設為自訂活動的API名稱，並將顯示名稱設為自訂活動的顯示名稱。 然後，將型別設定為object並將欄位群組指派給您在上一步建立的自訂活動欄位群組。 完成後，選取 套用。
新欄位會顯示在您的結構描述中。
將子欄位新增至物件欄位 add-sub-fields-to-the-object-field
準備結構描述的最後一步是在您在上一步建立的欄位中新增個別欄位。
建立資料流
結構描述設定完成後，您現在可以繼續為自訂活動資料建立資料流。
在Experience Platform UI中，從左側導覽列選取 來源 以存取來源工作區。 目錄畫面會顯示您可以建立帳戶的各種來源。
您可以從熒幕左側的目錄中選取適當的類別。 或者，您可以使用搜尋列來尋找您要使用的特定來源。
在Adobe應用程式類別下，選取 Marketo Engage。 然後，選取 新增資料 以建立新的Marketo資料流。
選取資料
從Marketo資料集清單中選取 活動，然後選取 下一步。
資料流詳細資料
接下來，提供您的資料流的資訊，包括資料集和資料流的名稱和說明、您將使用的結構描述，以及Profile擷取、錯誤診斷和部分擷取的設定。
對應
系統會自動填入標準活動欄位的對應，但自訂活動欄位必須手動對應至其對應的目標欄位。
若要開始對應您的自訂活動欄位，請選取 新增欄位型別，然後選取 新增欄位。
瀏覽來源資料結構，並尋找您要內嵌的自訂活動欄位。 完成後，選取 選取。
若要新增目標欄位，請選取結構描述圖示
重複步驟以新增其餘的自訂活動對應欄位。 完成後，選取 下一步。
審核
檢閱 步驟隨即顯示，可讓您在建立新資料流之前先檢閱該資料流。 詳細資料會分組到以下類別中：
- 連線：顯示來源型別、所選來源實體的相關路徑，以及該來源實體中的資料行數量。
- 指派資料集與對應欄位：顯示要將來源資料擷取到哪個資料集，包括資料集所堅持的結構描述。
檢閱您的資料流後，請選取「儲存並擷取」，並等待一些時間來建立資料流。
將自訂活動新增至現有活動資料流 add-to-existing-dataflows
若要將自訂活動資料新增至現有資料流，請修改現有活動資料流的對應，並使用您要擷取的自訂活動資料。 這可讓您將自訂活動擷取至相同的現有活動資料集中。 如需有關如何更新現有資料流對應的詳細資訊，請參閱在UI中更新資料流的指南。
使用Query Service篩選自訂活動的活動 query-service-filter
資料流完成後，您可以使用查詢服務來篩選自訂活動資料的活動。
將自訂活動內嵌至Experience Platform時，自訂活動的API名稱會自動變成其eventType。 使用eventType={API_NAME}篩選自訂活動資料。
SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'
使用IN子句篩選多個自訂活動：
SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')
下圖顯示查詢編輯器中篩選自訂活動資料的範例SQL陳述式。
後續步驟
依照本教學課程中的指示，您已為Marketo個自訂活動資料設定Experience Platform結構描述，並建立資料流以便將該資料引進Experience Platform。 如需Marketo來源的一般資訊，請閱讀Marketo 來源概觀。