建立 HTTP API 使用UI的串流連線

本教學課程提供使用建立串流來源連線的步驟 來源 工作區。

快速入門

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

建立串流連線

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

您可以從畫面左側的目錄中選取適當的類別。 或者,您也可以使用搜尋選項來尋找您要使用的特定來源。

串流 類別,選取 HTTP API 然後選取 新增資料.

目錄

連線HTTP API帳戶 頁面便會顯示。 您可以在此頁面使用新的證明資料或現有的證明資料。

現有帳戶

若要使用現有帳戶,請選取您要用來建立新資料流的HTTP API帳戶,然後選取「 」 下一個 以繼續進行。

existing-account

新帳戶

如果您要建立新帳戶,請選取 新帳戶. 在出現的輸入表單上,提供帳戶名稱和選擇性說明。 您也可以選擇提供下列設定屬性:

  • 驗證: 此屬性決定串流連線是否需要驗證。 驗證可確保從信任的來源收集資料。 如果您處理的是個人識別資訊(PII),則應開啟此屬性。 此屬性預設為關閉。
  • XDM相容: 此屬性代表此串流連線是否將傳送與XDM結構描述相容的事件。 此屬性預設為關閉。

完成後,選取 連線到來源 然後選取 下一個 以繼續進行。

new-account

選擇資料

建立HTTP API連線後, 選取資料 步驟隨即顯示,為您提供上傳和預覽資料的介面。

選取 上傳檔案 以上傳您的資料。 或者,您也可以將資料拖放至 拖放檔案 區段。

add-data

上傳資料後,您可以使用介面的右側來預覽檔案階層。 選取 下一個 以繼續進行。

preview-sample-data

將資料欄位對應至XDM結構描述

此 對應 步驟隨即顯示,提供將來源資料對應至Platform資料集的介面。

此 HTTP API 來源支援JSON檔案的擷取。 如果標示為XDM投訴,則JSON檔案不需要手動設定。 如果沒有,則必須明確設定對應。

選擇要將傳入資料擷取的資料集。 您可以使用現有的資料集或建立新的資料集。

建立新的資料集

若要建立新資料集,請選取 新資料集. 在出現的表單上,提供資料集的名稱、選擇性說明以及目標結構描述。 如果您選取 Profile-enabled結構描述,您可以選擇資料集是否也應該是 Profile-enabled.

新資料集

使用現有的資料集

若要使用現有的資料集,請選取 現有資料集. 在出現的表單上,選取您要使用的資料集。 選取資料集後,您可以選擇資料集是否應 Profile-enabled.

existing-data

對應標準欄位

您可以視需要選擇直接對應欄位,或使用資料準備函式來轉換來源資料,以衍生計算值或計算值。 如需使用對應程式介面和計算欄位的完整步驟,請參閱 資料準備UI指南.

若要新增來源欄位,請選取 新增對應.

add-new-mapping

會出現新的來源欄位和目標欄位配對。 若要新增來源欄位,請選取 選取來源欄位 輸入列。

select-source-field

此 選取屬性 面板可讓您探索檔案階層並選取特定的來源欄位,以對應至目標XDM欄位。 選取要對應的來源欄位後,請選取 選取 以繼續進行。

select-attributes

選取來源欄位後,您現在可以識別要對應的適當目標XDM欄位。 選取目標欄位區段下的結構描述圖示。

select-target-field

此 將來源欄位對應到目標欄位 視窗隨即顯示,為您提供可探索目標資料集架構的介面。 選取與來源欄位相符的目標欄位,然後選取 選取 以繼續進行。

對應至目標欄位

將來源欄位全部對應到適當的目標XDM欄位後,請選取 下一個

data-prep-complete

資料流詳細資訊

資料流詳細資料 步驟隨即顯示。 您可以在此頁面提供名稱和說明(選擇性),以提供已建立資料流的詳細資訊。

為資料流提供詳細資訊後,選取 下一個.

資料流 — 詳細資料

請檢閱

檢閱 步驟隨即顯示,可讓您在建立資料流之前先檢閱其詳細資訊。 詳細資料分為下列類別:

  • 連線:顯示帳戶名稱、來源平台和來源名稱。
  • 指派資料集和對應欄位:顯示目標資料集和資料集所遵守的結構描述。

確認詳細資料正確後,選取「 」 完成.

檢閱

取得串流端點URL

建立連線後,就會顯示來源詳細資訊頁面。 此頁面顯示您新建立之連線的詳細資料,包括先前執行的資料流、ID和串流端點URL。

端點

後續步驟

依照本教學課程所述,您已建立串流HTTP連線,讓您能夠使用串流端點來存取各種 Data Ingestion API。 如需在API中建立串流連線的指示,請參閱 建立串流連線教學課程.

若要瞭解如何將資料串流到Platform,請閱讀以下任一教學課程: 串流時間序列資料 或上的教學課程 串流記錄資料.

本頁內容