建立來源連線和資料流,以使用UI串流LAVA資料
請依照此逐步指南操作,協助您在Experience Platform使用者介面中設定自己的LAVA來源聯結器。
快速入門
本教學課程需要您實際瞭解下列Experience Platform元件:
-
Experience Data Model (XDM) 系統: Experience Platform用來組織客戶體驗資料的標準化架構。
- 結構描述組合的基本概念:瞭解XDM結構描述的基本建置區塊,包括結構描述組合中的關鍵原則和最佳實務。
- 結構描述編輯器教學課程:瞭解如何使用結構描述編輯器使用者介面建立自訂結構描述。
-
Real-Time Customer Profile:根據來自多個來源的彙總資料,提供統一的即時消費者設定檔。
連線您的LAVA帳戶
在Experience Platform UI中,從左側導覽列選取 來源 以存取來源工作區。 目錄畫面會顯示您可以建立帳戶的各種來源。
您可以從熒幕左側的目錄中選取適當的類別。 或者,您可以使用搜尋選項來尋找您要使用的特定來源。
在 串流 類別下,選取LAVA,然後選取新增資料。
選取資料
選取資料步驟隨即顯示,提供介面供您選取要帶到Platform的資料。
- 介面的左側是瀏覽器,可讓您檢視帳戶內的可用資料流;
- 介面的右側部分可讓您預覽JSON檔案中最多100列的資料。
選取「上傳檔案」以從本機系統上傳JSON檔案,或從對應您設定之資料集的「概述」區段上傳範例檔案。 或者,您也可以將要上傳的JSON檔案拖放至拖放檔案面板。
上傳檔案後,預覽介面會更新,以顯示您上傳的結構描述預覽。 預覽介面可讓您檢查檔案的內容和結構。 您也可以使用搜尋欄位公用程式來存取結構描述中的特定專案。
完成後,選取下一步。
資料流詳細資料
資料流詳細資料步驟隨即顯示,為您提供使用現有資料集或建立資料流新資料集的選項,以及提供資料流名稱和說明的機會。 在此步驟中,您還可以配置設定檔擷取、錯誤診斷、部分擷取和警報的設定。
完成後,選取下一步。
對應
對應步驟出現,為您提供介面,用於將來源結構描述中的欄位對應到目標結構描述中適當的目標XDM欄位。
使用LAVA提供的結構描述時,請使用下列建議的對應:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto | |
|---|---|
| LAVA Source聯結器欄位 | LAVA設定檔結構描述欄位 |
lavaId |
_tenant.lavaId |
firstName |
person.name.firstName |
lastName |
person.name.lastName |
email |
personalEmail.address |
phone |
mobilePhone.number |
| table 0-row-2 1-row-2 2-row-2 layout-auto | |
|---|---|
| LAVA Source聯結器欄位 | LAVA設定檔結構描述欄位 |
lavaId |
_tenant.lavaId |
balances[] |
_tenant.balances[] |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 layout-auto | |
|---|---|
| LAVA Source聯結器欄位 | LAVA事件結構描述欄位 |
計算欄位to_map("LavaId",to_array(false,to_object("id",lavaId,"primary",true))) |
identityMap |
type |
eventType |
timestamp |
timestamp |
eventId |
_tenant.ticketScan.eventId |
eventName |
_tenant.ticketScan.eventName |
eventLabel |
_tenant.ticketScan.eventLabel |
venue |
_tenant.ticketScan.venue |
venueLabel |
_tenant.ticketScan.venueLabel |
section |
_tenant.ticketScan.section |
sectionLabel |
_tenant.ticketScan.sectionLabel |
row |
_tenant.ticketScan.row |
seat |
_tenant.ticketScan.seat |
gate |
_tenant.ticketScan.gate |
gateLabel |
_tenant.ticketScan.gateLabel |
transactionId |
_tenant.transaction.transactionId |
referenceId |
_tenant.transaction.referenceId |
subtotal |
_tenant.transaction.subtotal |
total |
_tenant.transaction.total |
location |
_tenant.transaction.location |
items[] |
_tenant.transaction.items[] |
redeemedAmount |
_tenant.transaction.redeemedAmount |
rewardsApplied[] |
_tenant.transaction.rewardsApplied[] |
amount |
_tenant.ledger.amount |
expiresAt |
_tenant.ledger.expiresAt |
rewardId |
_tenant.ledger.rewardId |
rewardName |
_tenant.ledger.rewardName |
rewardSlug |
_tenant.ledger.rewardSlug |
rewardType |
_tenant.ledger.rewardType |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 layout-auto | |
|---|---|
| LAVA Source聯結器欄位 | LAVA事件結構描述欄位 |
計算欄位to_map("LavaId",to_array(false,to_object("id",lavaId,"primary",true))) |
identityMap |
eventId |
_tenant.ticketScan.eventId |
eventName |
_tenant.ticketScan.eventName |
eventLabel |
_tenant.ticketScan.eventLabel |
venue |
_tenant.ticketScan.venue |
venueLabel |
_tenant.ticketScan.venueLabel |
section |
_tenant.ticketScan.section |
sectionLabel |
_tenant.ticketScan.sectionLabel |
row |
_tenant.ticketScan.row |
seat |
_tenant.ticketScan.seat |
gate |
_tenant.ticketScan.gate |
gateLabel |
_tenant.ticketScan.gateLabel |
type |
eventType |
timestamp |
timestamp |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 layout-auto | |
|---|---|
| LAVA Source聯結器欄位 | LAVA事件結構描述欄位 |
計算欄位to_map("LavaId",to_array(false,to_object("id",lavaId,"primary",true))) |
identityMap |
transactionId |
_tenant.transaction.transactionId |
referenceId |
_tenant.transaction.referenceId |
subtotal |
_tenant.transaction.subtotal |
total |
_tenant.transaction.total |
location |
_tenant.transaction.location |
items[] |
_tenant.transaction.items[] |
redeemedAmount |
_tenant.transaction.redeemedAmount |
rewardsApplied[] |
_tenant.transaction.rewardsApplied[] |
type |
eventType |
timestamp |
timestamp |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto | |
|---|---|
| LAVA Source聯結器欄位 | LAVA事件結構描述欄位 |
計算欄位to_map("LavaId",to_array(false,to_object("id",lavaId,"primary",true))) |
identityMap |
amount |
_tenant.ledger.amount |
expiresAt |
_tenant.ledger.expiresAt |
rewardId |
_tenant.ledger.rewardId |
rewardName |
_tenant.ledger.rewardName |
rewardSlug |
_tenant.ledger.rewardSlug |
rewardType |
_tenant.ledger.rewardType |
type |
eventType |
timestamp |
timestamp |
或者,您可以手動調整對應規則以符合您的使用案例。 您可以根據自己的需求,選擇直接對應欄位,或使用資料準備函式來轉換來源資料,以衍生計算或計算的值。 如需使用對應程式介面和計算欄位的完整步驟,請參閱資料準備UI指南。
成功對應來源資料後,請選取下一步。
檢閱
檢閱步驟隨即顯示,可讓您在建立新資料流之前先檢閱該資料流。 詳細資料會分組到以下類別中:
- 連線:顯示來源型別、所選來源檔案的相關路徑,以及該來源檔案中的欄數。
- 指派資料集與對應欄位:顯示要將來源資料擷取到哪個資料集,包括資料集所堅持的結構描述。
檢閱您的資料流後,請選取完成,並等待一些時間來建立資料流。
取得串流端點URL和資料流ID
建立串流資料流後,您現在可以擷取串流端點URL和資料流ID。 這些將用於設定LAVA,讓您的串流來源可與Experience Platform通訊。
若要擷取您的串流端點,請移至您剛建立之資料流的資料流活動頁面,並從屬性面板底部複製端點。
將LAVA與您的webhook整合
在LAVA主控台中,導覽至Resources > Data Export。
選取Create New Export,然後選擇 Adobe Source Connector 作為目的地型別。 接著,選取您要傳送的來源資料,並輸入串流端點URL以及資料流ID。