XDM ExperienceEvent類別
XDM ExperienceEvent是標準的體驗資料模型(XDM)類別。 當特定事件發生或達到特定條件集合時,使用此類別建立系統的時間戳記快照。
體驗事件是所發生事件的事實記錄,包括時間點和所涉及個人的身分。 事件可以是明確的(直接可觀察的人類動作)或內隱的(在沒有直接人類動作的情況下引發),並且記錄時不會進行彙總或解譯。 如需在Platform生態系統中使用此類別的高階資訊,請參閱XDM概觀。
XDM ExperienceEvent類別本身為結構描述提供數個時間序列相關欄位。 其中兩個欄位(_id
和timestamp
)是基於此類別的所有結構描述都是 必要,其餘則是選擇性的。 某些欄位的值會在擷取資料時自動填入。
_id
(必要)
_id
欄位可唯一識別擷取至Adobe Experience Platform的個別事件。 此欄位用於追蹤個別事件的唯一性、防止資料重複,以及在下游服務中查詢該事件。在偵測到重複事件的地方,Platform應用程式和服務可能會以不同的方式處理重複。 例如,如果設定檔存放區中已存在具有相同
_id
的事件,則會捨棄設定檔服務中的重複事件。在某些情況下,
_id
可以是通用唯一識別碼(UUID)或全域唯一識別碼(GUID)。如果您要從來源連線串流資料,或直接從Parquet檔案擷取資料,您應該串連特定欄位組合,讓事件具有唯一性,以產生此值。 可串連的事件範例包括主要ID、時間戳記、事件型別等。 串連值必須是
uri-reference
格式字串,這表示必須移除任何冒號字元。 之後,應該使用SHA-256或您選擇的其他演演算法來雜湊串連值。請務必注意,此欄位不代表與個人相關的身分,而是資料本身的記錄。 與個人相關的身分資料應委派給相容欄位群組所提供的身分欄位。
eventMergeId
eventType
producedBy
在附錄區段中提供了這個屬性的某些建議值。 此欄位是可擴充的列舉,這表示您也可以使用自己的字串來代表不同的事件產生器。
identityMap
如需有關其使用案例的詳細資訊,請參閱結構描述組合基本概念中身分對應一節。
timestamp
(必要)
事件模型化的最佳實務
以下章節涵蓋在Adobe Experience Platform中設計事件型Experience Data Model (XDM)結構描述的最佳作法。
時間戳記 timestamps
事件結構描述的根timestamp
欄位 只能 代表事件本身的觀察結果,而且必須發生在過去。 但是,事件 必須 從1970年開始進行。 如果您的分段使用案例需要使用未來可能發生的時間戳記,這些值必須在您的體驗事件結構描述中的其他位置限制。
例如,如果旅遊及旅館業的企業正在模型化航班訂位事件,則類別層級timestamp
欄位代表觀察訂位事件的時間。 與事件相關的其他時間戳記(例如旅行預訂的開始日期)應擷取在標準或自訂欄位群組提供的個別欄位中。
將類別層級的時間戳記與事件結構描述中的其他相關日期時間值分開,您就可以實作靈活的分段使用案例,同時保留體驗應用程式中客戶歷程的時間戳記帳戶。
使用計算欄位 calculated
體驗應用程式中的某些互動可能會產生多個相關事件,這些事件在技術上會共用相同的事件時間戳記,因此可以顯示為單一事件記錄。 例如,如果客戶檢視您網站上的產品,這可能會導致事件記錄有兩個潛在的eventType
值:「產品檢視」事件(commerce.productViews
)或一般的「頁面檢視」事件(web.webpagedetails.pageViews
)。 在這些情況下,您可以在單一點選中擷取多個事件時,使用計算欄位來擷取最重要的屬性。
使用Adobe Experience Platform資料準備來對XDM與來自XDM的資料進行對應、轉換及驗證。 使用服務提供的可用對應函式,您可以叫用邏輯運運算元,以便在資料擷取到Experience Platform時,優先處理、轉換及/或合併多事件記錄中的資料。 在上述範例中,您可以指定eventType
為計算欄位,每當「產品檢視」與「頁面檢視」同時發生時,就會優先處理「產品檢視」。
如果您是透過UI手動將資料擷取到Platform,請參閱計算欄位的指南,以瞭解如何建立計算欄位的特定步驟。
如果您使用來源連線將資料串流至Platform,您可以設定來源以改為利用計算欄位。 請參閱您特定來源🔗的檔案,瞭解設定連線時如何實作計算欄位的指示。
相容的結構描述欄位群組 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
click
decisioning.propositionInteract
。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.propositionFetch
decisioning.propositionInteract
decisioning.propositionSend
decisioning.propositionTrigger
delivery.feedback
directMarketing.emailBounced
directMarketing.emailBouncedSoft
directMarketing.emailClicked
directMarketing.emailDelivered
directMarketing.emailOpened
directMarketing.emailSent
directMarketing.emailUnsubscribed
display
decisioning.propositionDisplay
。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
media.adBreakStart
media.adComplete
media.adSkip
media.adStart
media.bitrateChange
media.bufferStart
media.bufferStart
事件型別。 沒有特定的bufferResume
事件型別;在bufferStart
事件後傳送play
事件時,緩衝會被視為已繼續。media.chapterComplete
media.chapterSkip
media.chapterStart
media.downloaded
media.error
media.pauseStart
pauseStart
事件何時發生。 當使用者起始媒體播放暫停的動作時,就會觸發此事件。 沒有繼續事件型別。 在pauseStart
之後傳送播放事件時會推斷為繼續。media.ping
media.ping
事件型別用於表示持續播放狀態。 針對主要內容,在播放期間必須每10秒傳送此事件,從播放開始後的10秒開始。 對於廣告內容,在廣告追蹤期間必須每秒傳送一次。 Ping事件不應在要求內文中包含引數對應。media.play
buffering,
paused
(當使用者繼續時)或error
(當復原時))轉換為playing
狀態時(包括自動播放等情況),會傳送media.play
事件型別。 此事件由播放器的on('Playing')
回呼觸發。media.sessionComplete
media.sessionEnd
media.sessionEnd
事件型別會通知Media Analytics後端,在使用者放棄檢視且不太可能返回時立即關閉工作階段。 如果未傳送此事件,工作階段將在閒置10分鐘或播放點未移動30分鐘後逾時。 將會忽略任何使用該工作階段ID的後續媒體呼叫。media.sessionStart
media.sessionStart
事件型別會隨工作階段起始呼叫傳送。 在收到回應時,將會從Location標題擷取工作階段ID,並使用於對收集伺服器的所有後續事件呼叫。media.statesUpdate
statesUpdate
事件何時發生。 播放器狀態追蹤功能可附加至音訊或視訊資料流。 標準狀態為: fullscreen
、mute
、closedCaptioning
、pictureInPicture
和inFocus
。opportunityEvent.addToOpportunity
opportunityEvent.opportunityUpdated
opportunityEvent.removeFromOpportunity
personalization.request
decisioning.propositionFetch
。pushTracking.applicationOpened
pushTracking.customAction
web.formFilledOut
web.webinteraction.linkClicks
web.webpagedetails.pageViews
location.entry
location.exit
producedBy
的建議值 producedBy
下表概述producedBy
的一些接受值:
self
system
salesRef
customerRep