建立來源連線和資料流,以使用UI串流LAVA資料

請依照此逐步指南操作,協助您在Experience Platform使用者介面中設定自己的LAVA來源聯結器。

IMPORTANT
此檔案頁面是由LAVA團隊建立。 若有任何查詢或更新要求,請直接透過info@lava.ai聯絡他們。

快速入門

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

TIP
開始進行此教學課程之前,請先檢閱LAVA 來源聯結器總覽,確定您符合所有必要條件。

連線您的LAVA帳戶

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

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

在​ 串流 ​類別下,選取LAVA,然後選取​新增資料

Experience Platform來源目錄

選取資料

選取資料​步驟隨即顯示,提供介面供您選取要帶到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。

建立新匯出

recommendation-more-help
experience-platform-help-sources