文档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
Doe
用户的姓氏。
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奖励的ID。 对于给定的奖励，这永远不会改变。
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
General
由票证提供商提供的部分的标签。
row
GA3
扫描的票证上的行。
seat
13
请坐到扫描的票证上。
gate
团队ST1
扫描的票上的门。
gateLabel
General
票证提供商提供的入口标签。
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奖励的ID。 对于给定的奖励，这永远不会改变。
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