使用使用者介面建立HTTP API串流連線
本教學課程提供使用來源工作區建立串流來源連線的步驟。
快速入門
本教學課程需要您實際瞭解下列Adobe Experience Platform元件:
-
Experience Data Model (XDM) 系統: Experience Platform用來組織客戶體驗資料的標準化架構。
- 結構描述組合的基本概念:瞭解XDM結構描述的基本建置區塊,包括結構描述組合中的關鍵原則和最佳實務。
- 結構描述編輯器教學課程:瞭解如何使用結構描述編輯器使用者介面建立自訂結構描述。
-
Real-Time Customer Profile:根據來自多個來源的彙總資料,提供統一的即時消費者設定檔。
建立串流連線
在Platform UI中,從左側導覽選取 來源 以存取來源工作區。 目錄畫面會顯示您可以用來建立帳戶的各種來源。
您可以從熒幕左側的目錄中選取適當的類別。 或者,您可以使用搜尋選項來尋找您要使用的特定來源。
在 串流 類別下,選取 HTTP API,然後選取 新增資料。
連線HTTP API帳戶 頁面隨即顯示。 您可以在此頁面使用新的證明資料或現有的證明資料。
現有帳戶
若要使用現有帳戶,請選取您要用來建立新資料流的HTTP API帳戶,然後選取[下一步] 以繼續。
新帳戶
如果您正在建立新帳戶,請選取 新帳戶。 在出現的輸入表單上,提供帳戶名稱和選用的說明。 您也會選擇提供下列設定屬性:
- 驗證: 此屬性決定串流連線是否需要驗證。 驗證可確保從受信任的來源收集資料。 如果您處理的是個人識別資訊(PII),則應開啟此屬性。 此屬性預設為關閉。
- 與XDM相容: 此屬性表示此串流連線是否會傳送與XDM結構描述相容的事件。 此屬性預設為關閉。
完成時,請選取 連線到來源,然後選取 下一步 以繼續。
選取資料
建立HTTP API連線後,選取資料 步驟隨即顯示,為您提供上傳和預覽資料的介面。
選取 上傳檔案 以上傳您的資料。 或者,您可以將資料拖放至介面的拖放檔案區段。
上傳資料後,您可以使用介面的右側來預覽檔案階層。 選取 下一步 以繼續。
將資料欄位對應至XDM結構描述
對應步驟出現,提供介面以將來源資料對應到Platform資料集。
HTTP API來源支援擷取JSON檔案。 如果JSON檔案標示為XDM申訴,則不需要手動設定。 如果沒有,則必須明確設定對應。
選擇要將傳入資料擷取的資料集。 您可以使用現有的資料集或建立新的資料集。
建立新的資料集
若要建立新資料集,請選取 新資料集。 在出現的表單上,提供資料集的名稱、可選說明以及目標結構描述。 如果您選取已啟用Profile的結構描述,您可以選擇資料集是否也應該已啟用Profile。
使用現有的資料集
若要使用現有的資料集,請選取 現有的資料集。 在出現的表單上,選取您要使用的資料集。 選取資料集後,您可以選擇資料集是否應該啟用Profile。
對應標準欄位
您可以根據自己的需求,選擇直接對應欄位,或使用資料準備函式來轉換來源資料,以衍生計算或計算的值。 如需使用對應程式介面和計算欄位的完整步驟,請參閱資料準備UI指南。
若要新增來源欄位,請選取 新增對應。
會出現新的來源欄位和目標欄位配對。 若要新增來源欄位,請選取選取來源欄位輸入列旁的箭頭圖示。
選取屬性面板可讓您探索您的檔案階層,並選取要對應至目標XDM欄位的特定來源欄位。 選取要對應的來源欄位後,選取 選取 以繼續。
選取來源欄位後,您現在可以識別要對應的適當目標XDM欄位。 在目標欄位區段下選取結構描述圖示。
將來源欄位對應到目標欄位視窗會出現,提供您一個介面來探索目標資料集的結構描述。 選取與來源欄位相符的目標欄位,然後選取 選取 以繼續。
一旦您的來源欄位全部對應到適當的目標XDM欄位後,請選取 下一步
資料流詳細資料
資料流詳細資料 步驟隨即顯示。 您可以在此頁面上提供名稱和選擇性說明,以提供已建立資料流的詳細資訊。
提供資料流的詳細資訊後,選取 下一步。
檢閱
檢閱 步驟隨即顯示,可讓您在建立資料流之前先檢閱資料流的詳細資訊。 詳細資料分為以下類別:
- 連線:顯示帳戶名稱、來源平台和來源名稱。
- 指派資料集和對應欄位:顯示目標資料集和資料集所遵守的結構描述。
確認詳細資料正確之後,請選取 完成。
取得串流端點URL
建立連線後,來源詳細資訊頁面就會顯示。 此頁面顯示您新建立之連線的詳細資料,包括先前執行的資料流、ID和串流端點URL。
後續步驟
依照此教學課程中的指示,您已建立串流HTTP連線,讓您能夠使用串流端點來存取各種Data Ingestion API。 如需在API中建立串流連線的指示,請參閱建立串流連線教學課程。
若要瞭解如何將資料串流到Platform,請閱讀串流時間序列資料的教學課程或串流記錄資料的教學課程。