XDM ExperienceEvent class

XDM ExperienceEvent 는 특정 이벤트가 발생하거나 특정 조건 세트에 도달했을 때 시스템의 타임스탬프가 지정된 스냅샷을 만들 수 있는 표준 경험 데이터 모델(XDM) 클래스입니다.

경험 이벤트 는 시점 및 관련된 개인의 ID를 포함하여 발생한 사항에 대한 팩트 레코드입니다. 사건은 명시적(직접 관찰 가능한 인간 행동) 또는 암시적(직접 인간 행동 없이 발생)일 수 있으며 집계나 해석 없이 기록된다. 플랫폼 생태계에서 이 클래스의 사용에 대한 자세한 내용은 XDM 개요.

다음 XDM ExperienceEvent 클래스 자체는 스키마에 여러 시계열 관련 필드를 제공합니다. 이 필드 중 두 개(_id 및 timestamp) 필수 클래스를 기반으로 하는 모든 스키마의 경우 나머지는 선택 사항입니다. 일부 필드의 값은 데이터가 수집될 때 자동으로 채워집니다.

Platform UI에 표시되는 XDM ExperienceEvent 구조

속성 설명
_id
(필수 여부)		 경험 이벤트 클래스 _id 필드는 Adobe Experience Platform에 수집되는 개별 이벤트를 고유하게 식별합니다. 이 필드는 개별 이벤트의 고유성을 추적하고, 데이터 중복을 방지하고, 다운스트림 서비스에서 해당 이벤트를 조회하는 데 사용됩니다.

중복 이벤트가 감지되면 플랫폼 애플리케이션과 서비스는 중복을 다르게 처리할 수 있습니다. 예를 들어 프로필 서비스의 중복 이벤트는 동일한 이벤트가 있는 경우 삭제됩니다 _id 이(가) 이미 프로필 저장소에 있습니다.

경우에 따라, _id 다음이 될 수 있음: UUID(범용 고유 식별자) 또는 GUID(Globally Unique Identifier).

소스 연결에서 데이터를 스트리밍하거나 Parquet 파일에서 직접 수집하는 경우, 기본 ID, 타임스탬프, 이벤트 유형 등과 같이 이벤트를 고유하게 하는 필드의 특정 조합을 연결하여 이 값을 생성해야 합니다. 연결된 값은 이어야 합니다. uri-reference 형식이 지정된 문자열입니다. 즉, 콜론 문자는 제거해야 합니다. 그런 다음 연결된 값을 SHA-256 또는 선택한 다른 알고리즘을 사용하여 해시해야 합니다.

이를 구별하는 것이 중요합니다 이 필드는 개별 사용자와 관련된 id를 나타내지 않습니다.​를 검색하는 것이 더 효율적입니다. 개인과 관련된 ID 데이터는 다음으로 내보냅니다. id 필드 호환 가능한 필드 그룹에서 대신 제공합니다.
eventMergeId 을 사용하는 경우 Adobe Experience Platform 웹 SDK 데이터를 수집하기 위해 레코드를 만들게 한 수집된 일괄 처리의 ID를 나타냅니다. 이 필드는 데이터 수집 시 시스템에서 자동으로 채워집니다. 웹 SDK 구현의 컨텍스트 외부에서 이 필드를 사용할 수 없습니다.
eventType 이벤트의 유형 또는 범주를 나타내는 문자열입니다. 이 필드는 제품 보기 이벤트를 소매 회사에 대한 장바구니에 추가 이벤트와 구분하는 것처럼 동일한 스키마 및 데이터 세트 내에서 다른 이벤트 유형을 구분하려는 경우 사용할 수 있습니다.

이 속성의 표준 값은 부록 섹션, 의도한 사용 사례에 대한 설명 포함. 이 필드는 확장 가능한 열거형입니다. 즉, 고유한 이벤트 유형 문자열을 사용하여 추적 중인 이벤트를 분류할 수도 있습니다.

eventType 는 애플리케이션에서 히트당 하나의 이벤트만 사용하도록 제한하므로 시스템에서 가장 중요한 이벤트를 알려주기 위해 계산된 필드를 사용해야 합니다. 자세한 내용은 다음 섹션 을 참조하십시오 계산된 필드에 대한 우수 사례.
producedBy 이벤트의 생성자 또는 출처를 설명하는 문자열 값입니다. 이 필드는 세분화 목적으로 필요한 경우 특정 이벤트 제작자를 필터링하는 데 사용할 수 있습니다.

이 속성에 대해 제안된 몇 가지 값은 부록 섹션. 이 필드는 확장 가능한 열거형입니다. 즉, 고유한 문자열을 사용하여 다른 이벤트 생성자를 나타낼 수도 있습니다.
identityMap 이벤트가 적용되는 개인에 대한 네임스페이스 ID 세트가 포함된 맵 필드입니다. 이 필드는 ID 데이터가 수집될 때 시스템에 의해 자동으로 업데이트됩니다. 이 필드를 적절하게 사용하려면 실시간 고객 프로필를 사용하여 데이터 작업에서 필드의 내용을 수동으로 업데이트하지 마십시오.

에서 ID 맵에 대한 섹션을 참조하십시오. 스키마 컴포지션 기본 사항 사용 사례에 대한 자세한 내용을 보려면 여기를 클릭하십시오.
timestamp
(필수 여부)		 다음 형식의 이벤트 발생 시점의 ISO 8601 타임스탬프 RFC 3339 섹션 5.6. 이 타임스탬프는 과거의 날짜여야 합니다. 에 대한 아래 섹션 참조 타임스탬프 이 필드의 사용에 대한 모범 사례입니다.

이벤트 모델링에 대한 우수 사례

다음 섹션에서는 Adobe Experience Platform에서 이벤트 기반 XDM(경험 데이터 모델) 스키마를 디자인하는 모범 사례를 다룹니다.

타임스탬프

루트 timestamp 이벤트 스키마의 필드는 전용 사건 자체의 관찰을 나타내며 과거에 발생해야 합니다. 세분화 사용 사례에서 향후 발생할 수 있는 타임스탬프를 사용해야 하는 경우 이러한 값은 경험 이벤트 스키마의 다른 곳에서 제한되어야 합니다.

예를 들어 여행 및 숙박 산업의 한 업체가 비행 예약 이벤트를 모델링하는 경우 클래스 수준입니다 timestamp 필드는 예약 이벤트가 관찰된 시간을 나타냅니다. 여행 예약 시작 날짜와 같이 이벤트와 관련된 다른 타임스탬프는 표준 또는 사용자 지정 필드 그룹에서 제공하는 별도의 필드에 캡처해야 합니다.

비행 예약 및 시작 일자가 강조 표시된 샘플 경험 이벤트 스키마.

클래스 수준 타임스탬프를 이벤트 스키마의 다른 관련 날짜/시간 값과 별도로 유지함으로써 경험 애플리케이션에서 고객 여정의 타임스탬프가 지정된 계정을 유지하면서 유연한 세분화 사용 사례를 구현할 수 있습니다.

계산된 필드 사용

경험 애플리케이션의 특정 상호 작용으로 인해 동일한 이벤트 타임스탬프를 기술적으로 공유하는 여러 관련 이벤트가 발생할 수 있으므로 단일 이벤트 레코드로 나타낼 수 있습니다. 예를 들어 고객이 웹 사이트에서 제품을 보는 경우 두 가지 가능성이 있는 이벤트 레코드가 발생할 수 있습니다 eventType 값: "제품 보기" 이벤트(commerce.productViews) 또는 일반적인 "페이지 보기" 이벤트(web.webpagedetails.pageViews). 이러한 경우 단일 히트에서 여러 이벤트가 캡처될 때 계산된 필드를 사용하여 가장 중요한 속성을 캡처할 수 있습니다.

Adobe Experience Platform 데이터 준비 를 사용하면 XDM에서 데이터를 매핑, 변환 및 확인할 수 있습니다. 사용 가능한 사용 매핑 함수 이 서비스에서 제공하면 논리 연산자를 호출하여 Experience Platform으로 수집할 때 다중 이벤트 레코드의 데이터를 우선 순위 지정, 변환 및/또는 통합할 수 있습니다. 위의 예에서 eventType 둘 다 발생할 때마다 "페이지 보기"보다 "제품 보기"의 우선 순위를 지정하는 계산된 필드입니다.

UI를 통해 데이터를 플랫폼으로 수동으로 수집하는 경우 의 안내서를 참조하십시오. 계산된 필드 계산된 필드를 만드는 방법에 대한 특정 단계입니다.

소스 연결을 사용하여 데이터를 플랫폼으로 스트리밍하는 경우 계산된 필드를 대신 활용하도록 소스를 구성할 수 있습니다. 다음을 참조하십시오. 특정 소스에 대한 설명서 연결을 구성할 때 계산된 필드를 구현하는 방법에 대한 지침입니다.

호환 가능한 스키마 필드 그룹

노트

여러 필드 그룹의 이름이 변경되었습니다. 다음에 대한 문서 보기: 필드 그룹 이름 업데이트 추가 정보.

Adobe은 와 함께 사용할 수 있도록 여러 표준 필드 그룹을 제공합니다. XDM ExperienceEvent 클래스. 다음은 클래스에서 일반적으로 사용되는 몇 가지 필드 그룹 목록입니다.

부록

다음 섹션은 다음에 대한 추가 정보를 포함합니다. XDM ExperienceEvent 클래스.

에 대해 허용되는 값 eventType

다음 표에서 허용되는 값을 간략하게 설명합니다. eventType, 해당 정의와 함께:

값 정의
advertising.clicks 광고에서 작업을 클릭합니다.
advertising.completes 시간 미디어 에셋이 완료될 때까지 관찰되었습니다. 이는 뷰어가 앞으로 건너뛸 수 있으므로, 뷰어가 전체 비디오를 반드시 시청했음을 의미하지는 않습니다.
advertising.conversions 성능 평가를 위한 이벤트를 트리거하는 고객이 수행한 사전 정의된 작업입니다.
advertising.federated 데이터 페더레이션(고객 간 데이터 공유)을 통해 경험 이벤트가 생성되었는지 보여 줍니다.
advertising.firstQuartiles 디지털 비디오 광고 재생이 정상 속도로 25% 완료되었습니다.
advertising.impressions 조회할 가능성이 있는 고객에 대한 광고의 노출 횟수.
advertising.midpoints 디지털 비디오 광고 재생이 정상 속도로 50% 완료되었습니다.
advertising.starts 디지털 비디오 광고 재생이 시작되었습니다.
advertising.thirdQuartiles 디지털 비디오 광고 재생이 정상 속도로 75% 완료되었습니다.
advertising.timePlayed 특정 시간 미디어 에셋에서 사용자가 사용한 총 시간을 설명합니다.
application.close 애플리케이션이 닫히거나 백그라운드로 전송되었습니다.
application.launch 애플리케이션을 시작했거나 포그라운드로 가져왔습니다.
commerce.checkouts 제품 목록에 대해 체크아웃 이벤트가 발생했습니다. 체크아웃 프로세스에 여러 단계가 있는 경우 두 개 이상의 체크아웃 이벤트가 있을 수 있습니다. 여러 단계가 있는 경우 타임스탬프 및 각 이벤트에 대해 참조된 페이지/경험을 사용하여 순서대로 표시되는 각 개별 이벤트(단계)를 식별합니다.
commerce.productListAdds 제품이 제품 목록 또는 장바구니에 추가되었습니다.
commerce.productListOpens 새 제품 목록(장바구니)이 초기화되거나 만들어졌습니다.
commerce.productListRemovals 제품 목록 또는 장바구니에서 하나 이상의 제품 항목이 제거되었습니다.
commerce.productListReopens 고객이 더 이상 액세스할 수 없는(포기된) 제품 목록(장바구니)을 재마케팅 활동을 통해 다시 활성화했습니다.
commerce.productListViews 제품 목록 또는 장바구니가 하나 이상의 보기를 받았습니다.
commerce.productViews 제품이 하나 이상의 보기를 받았습니다.
commerce.purchases 주문이 수락되었습니다. 이것은 상거래 전환에서 유일한 필수 작업입니다. 구매 이벤트에는 참조된 제품 목록이 있어야 합니다.
commerce.saveForLaters 나중에 사용할 수 있도록 제품 목록(예: 제품 위시리스트)이 저장되었습니다.
decisioning.propositionDisplay 결정 제안이 사람에게 표시되었습니다.
decisioning.propositionInteract 한 사람이 의사 결정 제안에 상호 작용했다.
delivery.feedback 이메일 게재와 같은 게재에 대한 피드백 이벤트.
directMarketing.emailBounced 반송된 사람에게 보내는 이메일.
directMarketing.emailBouncedSoft 가볍게 반송된 사람에게 보내는 이메일.
directMarketing.emailClicked 마케팅 이메일의 링크를 클릭한 사용자.
directMarketing.emailDelivered 이메일이 개인의 이메일 서비스에 정상적으로 전달되었습니다.
directMarketing.emailOpened 사용자가 마케팅 이메일을 열었습니다.
directMarketing.emailUnsubscribed 마케팅 이메일 구독을 취소한 사람.
inappmessageTracking.dismiss 인앱 메시지가 무시되었습니다.
inappmessageTracking.display 인앱 메시지가 표시되었습니다.
inappmessageTracking.interact 인앱 메시지가 와(과) 상호 작용했습니다.
leadOperation.callWebhook 리드에 대한 응답으로 웹후크가 호출되었습니다.
leadOperation.convertLead 잠재 고객이 전환되었습니다.
leadOperation.interestingMoment 한 사람을 위해 흥미로운 순간이 기록되었습니다.
leadOperation.newLead 리드가 생성되었습니다.
leadOperation.scoreChanged 잠재 고객의 스코어 속성 값이 변경되었습니다.
leadOperation.statusInCampaignProgressionChanged 캠페인에서 잠재 고객의 상태가 변경되었습니다.
listOperation.addToList 마케팅 목록에 개인이 추가되었습니다.
listOperation.removeFromList 마케팅 목록에서 개인이 제거되었습니다.
message.feedback 고객에게 보낸 메시지에 대한 보냄/바운스/오류와 같은 피드백 이벤트.
message.tracking 고객에게 전송된 메시지에 대한 열기/클릭/사용자 지정 작업과 같은 이벤트 추적.
opportunityEvent.addToOpportunity 영업 기회에 개인이 추가되었습니다.
opportunityEvent.opportunityUpdated 영업 기회가 업데이트되었습니다.
opportunityEvent.removeFromOpportunity 영업 기회에서 개인이 제거되었습니다.
pushTracking.applicationOpened 푸시 알림에서 애플리케이션을 연 사용자입니다.
pushTracking.customAction 푸시 알림에서 사용자가 사용자 지정 작업을 클릭했습니다.
web.formFilledOut 한 사람이 wep 페이지에서 양식을 작성했습니다.
web.webinteraction.linkClicks 링크가 한 번 이상 선택되었습니다.
web.webpagedetails.pageViews 웹 페이지가 하나 이상의 보기를 받았습니다.

에 대한 제안 값 producedBy

다음 표에서 허용되는 몇 가지 값을 간략하게 설명합니다. producedBy:

값 정의
self 자가
system 시스템
salesRef 영업 담당자
customerRep 고객 담당자

이 페이지에서는