XDM ExperienceEvent 類別
XDM ExperienceEvent 是一個標準的體驗資料模型(XDM)類別。 當特定事件發生或達到特定條件集合時,使用此類別建立系統的時間戳記快照。
體驗事件是所發生事件的事實記錄,包括時間點和所涉及個人的身分。 事件可以是明確的(直接可觀察的人類動作)或內隱的(在沒有直接人類動作的情況下引發),並且記錄時不會進行彙總或解譯。 如需有關在平台生態系統中使用此類別的高層級資訊,請參閱 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的資料。 使用可用的 對應函式 由服務提供,您可以叫用邏輯運運算元,以便在資料擷取至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
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