文件Experience Platform來源連接器指南

LAVA

最後更新： 2026年6月11日

建立對象：

  • Developer

LAVA是客戶參與平台。 LAVA會整合您的票證、銷售點、行動應用程式和其他接觸點，並透過我們的自動化、忠誠度和mobile pass解決方案，建立重要的時刻。

先決條件

使用此來源聯結器之前，請先確定下列事項：

  • 您是現有的LAVA客戶，且已被授與Adobe匯出許可權。
  • 您擁有具有「管理員」或「匯出管理員」存取權的LAVA主控台帳戶。
  • （建議）您擁有Adobe Experience Cloud中的沙箱管理員許可權。

資料串流

LAVA來源聯結器可用於幾組不同的設定檔資料和事件。 您可以決定哪些與您的相關，只將那些記錄串流至Adobe。

成員設定檔

成員設定檔會列出LAVA在成員上儲存的關鍵設定檔屬性。 使用email做為身分欄位，Adobe Real-time Customer Profiles可以將LAVA記錄與其他Adobe設定檔連結。

在此處下載範例成員設定檔資料檔案。

LAVA Source聯結器欄位
範例值
說明
lavaId
c448e091-af0f-4eab-98ff-2c758c149051
使用者的LAVA ID。
firstName
John
使用者的名字。
lastName
完成
使用者的姓氏。
email
jdoe@example.com
使用者的電子郵件地址。
phone
+12223334444
使用者的電話號碼。
type
設定檔
這是何種記錄型別的指示器。
id
c448e091-af0f-4eab-98ff-2c758c149051
記錄的唯一ID。
timestamp
2025-10-22T12:51:04.317084Z
設定設定檔已設定這些屬性時。

成員餘額

成員餘額來源會列出成員擁有的獎勵餘額。 balances是一個陣列。 在對象、內容個人化、條件和其他這類位置中使用這些專案時，您通常必須選取一個特定專案、為所有專案重複某些動作，或彙總多個專案。

在此處下載成員餘額範例資料檔案。

LAVA Source聯結器欄位
範例值
說明
lavaId
c448e091-af0f-4eab-98ff-2c758c149051
使用者的LAVA ID。
balances[]
-
LAVA中的獎勵餘額清單。 餘額是具特定有效期的獎勵例項。 如果成員有一些在日期A到期的獎勵金額，以及某些在日期B到期的相同獎勵金額，則會記錄為個別餘額。 請參閱balanceSummaries以取得彙總。
balances[].amount
500
此餘額中的獎勵專案金額。 對於已儲存的值，這是以最低的單位面額（分）表示。
balances[].expiresAt
2025-10-22T12:51:04.317084Z
此餘額何時到期。
balances[].rewardId
123
LAVA獎勵的識別碼。 對於給定的獎勵，這永遠不會改變。
balances[].rewardName
F&B點數
在LAVA時刻啟用主控台中設定的獎勵名稱。 這可以變更。
balances[].rewardSlug
來源
在LAVA時刻啟用主控台中設定的獎勵主要概要。 這可以變更。
balances[].rewardType
已儲存
獎勵的型別（存取權、優惠方案、點數、已儲存或憑單）。
type
獎勵
這是何種記錄型別的指示器。
id
8fefe232-0375-4d56-a24c-d009e9d351e8
記錄的唯一ID。
timestamp
2025-10-22T12:51:04.317084Z
記錄此資料的時間。

票證掃描事件

每次成員在事件中掃描票證時，票證掃描事件來源都會提供詳細資訊。 此資料可用於瞭解特定地點或活動的出席率、參與度和行為模式。 透過將票證掃描事件串流至Adobe Experience Platform，您可以增加成員設定檔並啟用事件導向的個人化或分析。 每個掃描事件記錄都包含有關事件、地點以及掃描發生位置和時間的中繼資料。

在此處下載範例票證掃描事件資料檔案。

LAVA Source聯結器欄位
範例值
說明
lavaId
aff0ee5f-da62-4054-8cdb-076f5b60bfc3
掃描票證的使用者的LAVA ID。
eventId
1234
票證服務提供之事件的識別碼。
eventName
GRE1234A
票證服務提供的事件名稱。
eventLabel
綠色與藍色
票證提供者所提供的事件說明。
venue
ABC
票證提供者使用的場地代碼。
venueLabel
ABC體育場
由票證提供者提供的場地說明。
section
GA4
掃描票證上的座位區段。
sectionLabel
一般
票證提供者提供的區段標籤。
row
GA3
掃描的票證上的列。
seat
13
坐在掃描的票證上。
gate
小組ST1
掃描票證上的閘道。
gateLabel
一般
票證提供者提供的閘道標籤。
type
事件票證掃描
這是何種記錄型別的指示器。
id
1234567/GRE1234A/GA4/GA3/13/0
票證掃描事件的唯一ID。
timestamp
2025-11-03T01:41:00Z
票證掃描發生的時間。

交易事件

交易事件來源會在每次由LAVA所識別的使用者於銷售點系統購買時提供詳細資訊。 這些資料可用來評估促銷活動的使用率、瞭解客戶喜好設定並評估銷售績效。 透過將票證掃描事件串流至Experience Platform，您可以增加成員設定檔並啟用事件導向的個人化或分析。 每個交易事件記錄都包含有關購買的中繼資料、已使用的LAVA獎勵和已購買的專案。 請注意，有些廠商只會在套用獎勵時提供此資料。

在此處下載範例交易事件資料檔案。

LAVA Source聯結器欄位
範例值
說明
lavaId
52b6a289-f5a0-47f5-b5b5-da3e08aaedb9
已購買使用者的LAVA ID。
transactionId
8d515630-eb0f-43bc-a9f6-221f3813f438
LAVA建立的交易ID。
referenceId
2aed9e2c-77a4-496c-81cc-e9772d128c0e
交易的銷售點建立ID。
subtotal
974
以最小單位表示的交易小計（分）。
total
974
以最小單位表示的交易總計（分）。
location
64312
交易發生的位置。
items[]
-
此交易中所購買的專案清單。 供應商未提供專案層級資料時，此欄位不存在（不是空白清單）。
items[].sku
1083947
料號的SKU。
items[].amount
1949
以最低單位表示的料號單價（分）。
items[].quantity
1
此專案的購買數量。
items[].adjustedTotal
1949
套用任何專案層次獎勵後，此明細專案的總價（以最小單位表示，分母）。
items[].rewardsApplied[]
-
套用至此專案的獎勵清單。
items[].rewardsApplied[].amount
975
此獎勵所套用的折扣金額（以最小單位表示，分母）。
items[].rewardsApplied[].rewardId
5
套用的獎勵LAVA ID。
redeemedAmount
0
此交易中兌換的儲存值金額(以最小單位面值（分）表示)。
rewardsApplied[]
-
套用至此交易的獎勵清單。
rewardsApplied[].amount
975
此獎勵所套用的折扣金額（以最小單位表示，分母）。
rewardsApplied[].rewardId
5
套用的獎勵LAVA ID。
type
transaction
這是何種記錄型別的指示器。
id
8aa43866-173f-4c6e-bfa1-f231e34d6d71
記錄的唯一ID。
timestamp
2026-05-09T22:24:43.951Z
交易完成的時間。

分類帳事件

分類帳事件來源提供成員餘額每次變更的記錄，包括「時刻」的授權、填寫表單的授權、購買或透過LAVA應用程式發生的贖回，以及轉帳。 正數amount表示獎勵已新增至餘額；負數amount表示獎勵已兌換或移除。 移轉事件會產生兩個記錄：一個用於遺失餘額的成員，另一個用於接收餘額的成員。 付款與交易可使用多個餘額，每個餘額都會作為個別事件出現。

在此處下載分類帳事件資料檔範例。

LAVA Source聯結器欄位
範例值
說明
lavaId
292c367c-19ee-4d56-8d33-b2ab2c8fd553
餘額已變更之成員的LAVA ID。
amount
-100
獎勵餘額的變更。 正值表示授權；負值表示贖回或扣減。 對於已儲存的值，這是以最低的單位面額（分）表示。
expiresAt
2026-05-31T22:40:43.109Z
受影響的餘額何時到期。
rewardId
1
LAVA獎勵的識別碼。 對於給定的獎勵，這永遠不會改變。
rewardName
F&B Credit
在LAVA時刻啟用主控台中設定的獎勵名稱。 這可以變更。
rewardSlug
Credit
在LAVA時刻啟用主控台中設定的獎勵主要概要。 這可以變更。
rewardType
stored
獎勵的型別（存取權、優惠方案、點數、已儲存或憑單）。
type
ledger
這是何種記錄型別的指示器。
id
8aa43866-173f-4c6e-bfa1-f231e34d6d71
記錄的唯一ID。
timestamp
2026-05-21T22:40:43.109Z
餘額變更的時間。

合併事件

使用此合併的範例事件資料檔來設定單一資料流，以擷取所有事件型別。

部署考量

  1. 如果您需要有關LAVA個成員的基本資料，並且/或者您想要透過電子郵件地址將LAVA個資料連結到其他設定檔，請為成員設定檔資料建立資料流。
  2. 如果您使用成員餘額資料，則必須將其儲存在與成員設定檔不同的資料集中。
  3. 事件可以儲存在單一資料集或多個資料集中。 若要儲存在單一資料集中，請使用「合併」事件資料檔案/對應建立一個資料流，然後在LAVA MAC中設定多個匯出至相同的擷取URL和流量ID。 若要將每個事件型別儲存在不同的資料集中，請為每個資料集建立資料流，然後將LAVA MAC中的每個匯出設定為適當資料流的擷取URL和流量ID。

載入LAVA封裝

LAVA提供的套件包含我們在Experience Platform中使用LAVA時建議的欄位群組、結構描述、身分名稱空間和資料集。 建議使用這些套件，但並不必要。

若要載入這些套件，請在Experience Platform UI中，從左側導覽選取​ 沙箱 ​以存取沙箱工作區。 封裝畫面會顯示可用的封裝。 選取​ 建立封裝 ​和​貼上封裝承載，並貼上下列專案。

{
  "imsOrgId": "1EF71E43679AAD1E0A495C77@AdobeOrg",
  "packageId": "7ec94330c1ca43a09266a9a3b85f3727"
}

如需載入封裝的詳細資訊，請閱讀封裝共用教學課程。

建立封裝後，選取省略符號(...)以開啟功能表，並選取​ 匯入封裝 ​以匯入封裝。 有關如何匯入套件的詳細資訊，請參閱沙箱工具指南。

LAVA封裝包含三個資料集： LAVA Profiles、LAVA Balances和LAVA Events。 雖然設定檔與平衡使用相同的結構描述，但它們必須是個別的資料集，才能讓平衡更新不會覆寫設定檔更新，反之亦然。

後續步驟

LAVA來源聯結器會將成員設定檔、獎勵餘額、票證掃描事件、交易事件和分類帳事件擷取至Experience Platform。 針對列出的先決條件進行規劃、使用欄位參考表格和範例JSON檔案對應及擴充結構描述，以及選擇性地在您建立連線和資料流之前將LAVA的建議套件匯入沙箱。

如需逐步設定：

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