설명서Experience Platform소스 커넥터 안내서

LAVA

마지막 업데이트: 2026년 6월 11일

작성 대상:

  • Developer

LAVA은(는) 고객 참여 플랫폼입니다. LAVA은(는) 티켓, 판매 지점, 모바일 앱 및 기타 접점과 통합되며 자동화, 충성도 및 모바일 패스 솔루션과 중요한 순간을 만듭니다.

사전 요구 사항

이 소스 커넥터를 사용하기 전에 다음을 확인하십시오.

  • 기존 LAVA 고객이며 Adobe 내보내기 권한이 부여되었습니다.
  • “관리자” 또는 “내보내기 관리자” 액세스 권한이 있는 LAVA 콘솔 계정이 있습니다.
  • (권장) Adobe Experience Cloud에서 샌드박스 관리자 권한이 있습니다.

데이터 스트림

LAVA 원본 커넥터는 여러 프로필 데이터 및 이벤트 집합에 사용할 수 있습니다. 해당하는 레코드만 Adobe으로 스트리밍하여 결정할 수 있습니다.

구성원 프로필

멤버 프로필에는 멤버에 저장된 LAVA 스토어의 주요 프로필 속성이 나열됩니다. email을(를) ID 필드로 사용하여 Adobe Real-time Customer Profiles에서 LAVA개의 레코드를 다른 Adobe 프로필과 연결할 수 있습니다.

여기에서 샘플 구성원 프로필 데이터 파일을 다운로드하십시오.

LAVA Source 커넥터 필드
샘플 값
설명
lavaId
c448e091-af0f-4eab-98ff-2c758c149051
사용자의 LAVA ID입니다.
firstName
John
사용자의 이름입니다.
lastName
Do
사용자의 성입니다.
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
스타디움
티켓 공급자가 제공한 장소에 대한 설명.
section
GA4
스캔한 티켓의 좌석 구역.
sectionLabel
일반
티켓 공급자에서 제공하는 섹션의 레이블입니다.
row
GA3
스캔한 티켓의 행입니다.
seat
13
스캔한 표에 앉으십시오.
gate
팀
스캔한 티켓의 게이트.
gateLabel
일반
티켓 공급자가 제공하는 게이트의 레이블입니다.
type
event-ticketscan
어떤 유형의 기록인지 보여 주는 지표.
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
거래의 POS 생성 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을(를) 사용하기 위한 권장 필드 그룹, 스키마, id 네임스페이스 및 데이터 세트를 포함하는 패키지를 제공합니다. 이러한 패키지의 사용이 권장되지만 필수는 아닙니다.

이러한 패키지를 로드하려면 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