XDM ExperienceEvent 클래스
XDM ExperienceEvent은(는) 표준 XDM(Experience Data Model) 클래스입니다. 특정 이벤트가 발생하거나 특정 조건 집합에 도달한 경우 이 클래스를 사용하여 시스템의 타임스탬프가 지정된 스냅샷을 만듭니다.
경험 이벤트 는 시점 및 관련된 개인의 ID를 포함하여 발생한 사항에 대한 팩트 레코드입니다. 사건은 명시적(직접 관찰 가능한 인간 행동) 또는 암시적(직접 인간 행동 없이 발생)일 수 있으며 집계나 해석 없이 기록된다. 플랫폼 생태계에서 이 클래스를 사용하는 방법에 대한 자세한 내용은 XDM 개요를 참조하세요.
XDM ExperienceEvent 클래스 자체는 스키마에 여러 시계열 관련 필드를 제공합니다. 이 필드 중 두 개(_id
및 timestamp
)는 이 클래스를 기반으로 하는 모든 스키마에 대해 필수 이고 나머지는 선택 사항입니다. 일부 필드의 값은 데이터가 수집될 때 자동으로 채워집니다.
_id
(필수)
_id
필드는 Adobe Experience Platform에 수집되는 개별 이벤트를 고유하게 식별합니다. 이 필드는 개별 이벤트의 고유성을 추적하고, 데이터 중복을 방지하고, 다운스트림 서비스에서 해당 이벤트를 조회하는 데 사용됩니다.중복 이벤트가 검색되면 Platform 응용 프로그램과 서비스가 중복을 다르게 처리할 수 있습니다. 예를 들어 동일한
_id
을(를) 가진 이벤트가 프로필 저장소에 이미 있는 경우 프로필 서비스의 중복 이벤트가 삭제됩니다.경우에 따라
_id
은(는) UUID(Universally Unique Identifier) 또는 GUID(Globally Unique Identifier)일 수 있습니다.소스 연결에서 데이터를 스트리밍하거나 Parquet 파일에서 직접 수집하는 경우, 이벤트를 고유하게 만드는 특정 필드 조합을 연결하여 이 값을 생성해야 합니다. 연결할 수 있는 이벤트의 예로는 기본 ID, 타임스탬프, 이벤트 유형 등이 있습니다. 연결된 값은
uri-reference
형식의 문자열이어야 합니다. 즉, 콜론 문자는 모두 제거해야 합니다. 그런 다음 연결된 값을 SHA-256 또는 선택한 다른 알고리즘을 사용하여 해시해야 합니다.이 필드가 개별 사용자와 관련된 ID를 나타내는 것이 아니라 데이터 기록 자체를 나타내는 것임을 구별하는 것이 중요합니다 . 사용자와 관련된 ID 데이터는 대신 호환 가능한 필드 그룹에서 제공하는 ID 필드(으)로 수준을 내려야 합니다.
eventMergeId
eventType
이 속성의 표준 값은 의도한 사용 사례에 대한 설명을 포함하여 부록 섹션에 제공됩니다. 이 필드는 확장 가능한 열거형입니다. 즉, 고유한 이벤트 유형 문자열을 사용하여 추적 중인 이벤트를 분류할 수도 있습니다.
eventType
은(는) 응용 프로그램에서 히트당 하나의 이벤트만 사용하도록 제한하므로 시스템에서 가장 중요한 이벤트를 알려주기 위해 계산된 필드를 사용해야 합니다. 자세한 내용은 계산된 필드에 대한 모범 사례의 섹션을 참조하십시오.producedBy
이 속성에 대해 제안된 일부 값은 부록 섹션에 제공됩니다. 이 필드는 확장 가능한 열거형입니다. 즉, 고유한 문자열을 사용하여 다른 이벤트 생성자를 나타낼 수도 있습니다.
identityMap
사용 사례에 대한 자세한 내용은 스키마 컴포지션의 기본 사항에서 ID 맵에 대한 섹션을 참조하십시오.
timestamp
(필수)
이벤트 모델링에 대한 우수 사례
다음 섹션에서는 Adobe Experience Platform에서 이벤트 기반 XDM(경험 데이터 모델) 스키마를 디자인하는 모범 사례를 다룹니다.
타임스탬프 timestamps
이벤트 스키마의 루트 timestamp
필드는 이벤트 자체의 관찰을 전용 할 수 있으며 과거에 발생해야 합니다. 그러나 이벤트 must 은(는) 1970년 이후에 발생합니다. 세분화 사용 사례에서 향후 발생할 수 있는 타임스탬프를 사용해야 하는 경우 이러한 값은 경험 이벤트 스키마의 다른 곳에서 제한되어야 합니다.
예를 들어 여행 및 접대 업계의 비즈니스가 비행 예약 이벤트를 모델링하는 경우 클래스 수준 timestamp
필드는 예약 이벤트가 관찰된 시간을 나타냅니다. 여행 예약 시작 날짜와 같이 이벤트와 관련된 다른 타임스탬프는 표준 또는 사용자 지정 필드 그룹에서 제공하는 별도의 필드에 캡처해야 합니다.
클래스 수준 타임스탬프를 이벤트 스키마의 다른 관련 날짜/시간 값과 별도로 유지함으로써 경험 애플리케이션에서 고객 여정의 타임스탬프가 지정된 계정을 유지하면서 유연한 세분화 사용 사례를 구현할 수 있습니다.
계산된 필드 사용 calculated
경험 애플리케이션의 특정 상호 작용으로 인해 동일한 이벤트 타임스탬프를 기술적으로 공유하는 여러 관련 이벤트가 발생할 수 있으므로 단일 이벤트 레코드로 나타낼 수 있습니다. 예를 들어 고객이 웹 사이트에서 제품을 보는 경우 "제품 보기" 이벤트(commerce.productViews
) 또는 일반 "페이지 보기" 이벤트(web.webpagedetails.pageViews
)의 두 가지 가능한 eventType
값이 있는 이벤트 레코드가 발생할 수 있습니다. 이러한 경우 단일 히트에서 여러 이벤트가 캡처될 때 계산된 필드를 사용하여 가장 중요한 속성을 캡처할 수 있습니다.
Adobe Experience Platform 데이터 준비를 사용하여 XDM과 데이터를 매핑, 변환 및 확인합니다. 서비스에서 제공하는 사용 가능한 매핑 함수를 사용하면 논리 연산자를 호출하여 Experience Platform으로 수집할 때 다중 이벤트 레코드의 데이터를 우선 순위 지정, 변환 및/또는 통합할 수 있습니다. 위의 예에서 eventType
을(를) 계산된 필드로 지정하여 둘 다 발생할 때마다 "페이지 보기"보다 "제품 보기"의 우선 순위를 지정할 수 있습니다.
UI를 통해 데이터를 플랫폼으로 수동으로 수집하는 경우 계산된 필드를 만드는 방법에 대한 특정 단계는 계산된 필드의 안내서를 참조하십시오.
소스 연결을 사용하여 데이터를 플랫폼으로 스트리밍하는 경우 계산된 필드를 대신 활용하도록 소스를 구성할 수 있습니다. 연결을 구성할 때 계산된 필드를 구현하는 방법에 대한 지침은 특정 원본의 설명서를 참조하세요.
호환 가능한 스키마 필드 그룹 field-groups
Adobe은 XDM ExperienceEvent 클래스와 함께 사용할 여러 표준 필드 그룹을 제공합니다. 다음은 클래스에서 일반적으로 사용되는 몇 가지 필드 그룹 목록입니다.
부록
다음 섹션에는 XDM ExperienceEvent 클래스에 대한 추가 정보가 포함되어 있습니다.
eventType
에 대해 허용되는 값 eventType
다음 표에서는 eventType
에 대해 허용되는 값과 해당 정의를 설명합니다.
advertising.clicks
advertising.completes
advertising.conversions
advertising.federated
advertising.firstQuartiles
advertising.impressions
advertising.midpoints
advertising.starts
advertising.thirdQuartiles
advertising.timePlayed
application.close
application.launch
commerce.backofficeCreditMemoIssued
commerce.backofficeOrderCancelled
commerce.backofficeOrderItemsShipped
commerce.backofficeOrderPlaced
commerce.backofficeShipmentCompleted
commerce.checkouts
commerce.productListAdds
commerce.productListOpens
commerce.productListRemovals
commerce.productListReopens
commerce.productListViews
commerce.productViews
commerce.purchases
commerce.saveForLaters
decisioning.propositionDisplay
decisioning.propositionDismiss
decisioning.propositionInteract
decisioning.propositionSend
decisioning.propositionTrigger
delivery.feedback
directMarketing.emailBounced
directMarketing.emailBouncedSoft
directMarketing.emailClicked
directMarketing.emailDelivered
directMarketing.emailOpened
directMarketing.emailSent
directMarketing.emailUnsubscribed
inappmessageTracking.dismiss
inappmessageTracking.display
inappmessageTracking.interact
leadOperation.callWebhook
leadOperation.changeCampaignStream
leadOperation.changeEngagementCampaignCadence
leadOperation.convertLead
leadOperation.interestingMoment
leadOperation.mergeLeads
leadOperation.newLead
leadOperation.scoreChanged
leadOperation.statusInCampaignProgressionChanged
listOperation.addToList
listOperation.removeFromList
media.adBreakComplete
adBreakComplete
이벤트가 발생하면 추적합니다. 이 이벤트는 광고 브레이크가 시작될 때 트리거됩니다.media.adBreakStart
adBreakStart
이벤트가 발생하면 추적합니다. 이 이벤트는 광고 브레이크가 끝날 때 트리거됩니다.media.adComplete
adComplete
이벤트가 발생하면 추적합니다. 이 이벤트는 광고가 완료되면 트리거됩니다.media.adSkip
adSkip
이벤트가 발생하면 추적합니다. 이 이벤트는 광고를 건너뛸 때 트리거됩니다.media.adStart
adStart
이벤트가 발생하면 추적합니다. 이 이벤트는 광고가 시작될 때 트리거됩니다.media.bitrateChange
bitrateChange
이벤트가 발생하면 추적합니다. 이 이벤트는 비트 전송률이 변경될 때 트리거됩니다.media.bufferStart
bufferStart
이벤트가 발생하면 추적합니다. 이 이벤트는 미디어가 버퍼링되기 시작할 때 트리거됩니다.media.chapterComplete
chapterComplete
이벤트가 발생하면 추적합니다. 이 이벤트는 미디어의 챕터 완료 시 트리거됩니다.media.chapterSkip
chapterSkip
이벤트가 발생하면 추적합니다. 이 이벤트는 사용자가 미디어 콘텐츠 내의 다른 섹션 또는 챕터로 앞이나 뒤로 건너뛸 때 트리거됩니다.media.chapterStart
chapterStart
이벤트가 발생하면 추적합니다. 이 이벤트는 미디어 콘텐츠 내의 특정 섹션 또는 챕터의 시작 시 트리거됩니다.media.downloaded
media.error
error
이벤트가 발생하면 추적합니다. 이 이벤트는 미디어 재생 중에 오류 또는 문제가 발생할 때 트리거됩니다.media.pauseStart
pauseStart
이벤트가 발생하면 추적합니다. 이 이벤트는 사용자가 미디어 재생에서 일시 중지를 시작할 때 트리거됩니다.media.ping
ping
이벤트가 발생하면 추적합니다. 미디어 리소스의 가용성을 확인합니다.media.play
play
이벤트가 발생하면 추적합니다. 이 이벤트는 미디어 콘텐츠가 재생 중일 때 트리거되며, 사용자의 활성 소비를 나타냅니다.media.sessionComplete
sessionComplete
이벤트가 발생하면 추적합니다. 이 이벤트는 미디어 재생 세션의 끝을 표시합니다.media.sessionEnd
sessionEnd
이벤트가 발생하면 추적합니다. 이 이벤트는 미디어 세션의 종료를 나타냅니다. 이 결론에는 미디어 플레이어를 닫거나 재생을 중지하는 작업이 포함될 수 있습니다.media.sessionStart
sessionStart
이벤트가 발생하면 추적합니다. 이 이벤트는 미디어 재생 세션의 시작을 표시합니다. 사용자가 미디어 파일 재생을 시작할 때 트리거됩니다.media.statesUpdate
statesUpdate
이벤트가 발생하면 추적합니다. 플레이어 상태 추적 기능을 오디오 또는 비디오 스트림에 연결할 수 있습니다. 표준 상태는 fullscreen, mute, closedCaptioning, pictureInPicture 및 inFocus입니다.opportunityEvent.addToOpportunity
opportunityEvent.opportunityUpdated
opportunityEvent.removeFromOpportunity
pushTracking.applicationOpened
pushTracking.customAction
web.formFilledOut
web.webinteraction.linkClicks
web.webpagedetails.pageViews
location.entry
location.exit
producedBy
에 대한 제안 값 producedBy
다음 표에서는 producedBy
에 대해 허용되는 일부 값을 간략하게 설명합니다.
self
system
salesRef
customerRep