建立 HTTP API 使用UI的串流連線
本教學課程提供使用建立串流來源連線的步驟。 來源 工作區。
快速入門
本教學課程需要您實際瞭解下列Adobe Experience Platform元件:
-
Experience Data Model (XDM) 系統:作為依據的標準化架構 Experience Platform 組織客戶體驗資料。
- 結構描述組合基本概念:瞭解XDM結構描述的基本建置區塊,包括結構描述組合中的關鍵原則和最佳實務。
- 結構描述編輯器教學課程:瞭解如何使用結構編輯器UI建立自訂結構描述。
-
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-enabled結構描述,您可以選擇資料集是否也應該是 Profile-enabled.
使用現有的資料集
若要使用現有的資料集,請選取 現有資料集. 在出現的表單上,選取您要使用的資料集。 選取資料集後,您可以選擇資料集是否應 Profile-enabled.
對應標準欄位
您可以根據自己的需求,選擇直接對應欄位,或使用資料準備函式來轉換來源資料,以衍生計算或計算的值。 如需使用對應程式介面和計算欄位的完整步驟,請參閱 資料準備UI指南.
若要新增來源欄位,請選取 新增對應.
會出現新的來源欄位和目標欄位配對。 若要新增來源欄位,請選取 選取來源欄位 輸入列。
此 選取屬性 面板可讓您探索檔案階層並選取特定的來源欄位,以對應至目標XDM欄位。 選取要對應的來源欄位後,請選取 選取 以繼續進行。
選取來源欄位後,您現在可以識別要對應的適當目標XDM欄位。 在目標欄位區段下選取結構描述圖示。
此 將來源欄位對應到目標欄位 視窗會出現,為您提供用於探索目標資料集的結構描述的介面。 選取與來源欄位相符的目標欄位,然後選取 選取 以繼續進行。
將來源欄位全部對應到適當的目標XDM欄位後,請選取 下一個
資料流詳細資訊
此 資料流詳細資料 步驟隨即顯示。 您可以在此頁面上提供名稱和選擇性說明,以提供已建立資料流的詳細資訊。
為資料流提供詳細資訊後,選取 下一個.
請檢閱
此 檢閱 步驟隨即顯示,可讓您在建立資料流之前先檢閱資料流的詳細資訊。 詳細資料分為以下類別:
- 連線:顯示帳戶名稱、來源平台和來源名稱。
- 指派資料集和對應欄位:顯示目標資料集以及資料集所堅持的結構描述。
確認詳細資料正確後,選取「 」 完成.
取得串流端點URL
建立連線後,來源詳細資訊頁面就會顯示。 此頁面顯示您新建立之連線的詳細資料,包括先前執行的資料流、ID和串流端點URL。
後續步驟
依照本教學課程指示,您已建立串流HTTP連線,讓您能夠使用串流端點來存取各種 Data Ingestion API。 如需在API中建立串流連線的指示,請參閱 建立串流連線教學課程.
若要瞭解如何將資料串流到Platform,請閱讀上的任一教學課程 串流時間序列資料 或上的教學課程 串流記錄資料.