XDM ExperienceEvent 類

XDM ExperienceEvent 是標準的體驗資料模型(XDM)類別,可讓您在特定事件發生時或達到特定條件集時,建立系統的時間戳記快照。

體驗事件是所發生事件的事實記錄,包括相關個人的時間點和身分。 事件可以是顯性(直接可觀察的人類行為)或隱性(在沒有直接人類行為的情況下引起),並記錄在案時不進行匯總或解釋。 如需在Platform生態系統中使用此類別的詳細資訊,請參閱XDM概述

XDM ExperienceEvent類本身為架構提供了多個與時間序列相關的欄位。 擷取資料時,會自動填入其中某些欄位的值:

屬性 說明
_id 事件的唯一字串識別碼。 此欄位可用來追蹤個別事件的獨特性、防止資料重複,以及在下游服務中尋找該事件。 在某些情況下,_id可以是通用唯一識別碼(UUID)全域唯一識別碼(GUID)

如果您是從來源連線串流資料,或直接從Parquet檔案內嵌資料,應串連使事件唯一的特定欄位組合(例如主要ID、時間戳記、事件類型等),以產生此值。串連值必須是uri-reference格式字串,表示必須移除任何冒號字元。 之後,串連值應該會使用SHA-256或您選擇的其他演算法來雜湊。

請務必區分, 此欄位不代表與個人相關的身分,而是資料本身的記錄。與人員相關的身份資料應降級為由相容欄位群組提供的身分欄位
eventMergeId 如果使用Adobe Experience Platform Web SDK來內嵌資料,則此量度代表內嵌批次的ID,該批次會建立記錄。 資料擷取時,系統會自動填入此欄位。 不支援在Web SDK實作內容之外使用此欄位。
eventType 指出事件類型或類別的字串。 如果您想要區分相同結構和資料集中的不同事件類型,例如區分零售公司的產品檢視事件與購物車附加事件,則可使用此欄位。

此屬性的標準值在附錄部分 中提供,包括其預期使用案例的說明。此欄位是可擴充的列舉,這表示您也可以使用自己的事件類型字串,將您追蹤的事件分類。

eventType 限制您在應用程式上每次點擊只使用單一事件,因此您必須使用計算欄位,讓系統知道最重要的事件。如需詳細資訊,請參閱計算欄位最佳實務一節。
producedBy 描述事件產生者或來源的字串值。 如果需要,此欄位可用來篩選特定事件產生器以用於細分。

附錄一節提供此屬性的一些建 議值。此欄位是可擴充的列舉,這表示您也可以使用自己的字串來代表不同的事件產生者。
identityMap 一個地圖欄位,其中包含事件所套用之個人的命名空間身分識別集。 系統會在擷取身分資料時自動更新此欄位。 為了為即時客戶配置檔案正確使用此欄位,請勿嘗試手動更新資料操作中欄位的內容。

如需其使用案例的詳細資訊,請 參閱結構組合基 本概念中的身分對應區段。
timestamp 事件發生時的ISO 8601時間戳記,格式為RFC 3339第5.6節。 此時間戳記必須發生在過去。 如需使用此欄位的最佳實務,請參閱下方時間戳記的一節。

事件模型的最佳作法

以下章節涵蓋在Adobe Experience Platform中設計事件型Experience Data Model(XDM)結構的最佳作法。

時間戳記

事件架構的根timestamp欄位只能​​代表事件本身的觀察,且必須發生在過去。 如果您的分段使用案例需要使用未來可能發生的時間戳記,這些值必須在體驗事件結構的其他位置受到限制。

例如,如果旅行和旅館業中的企業正在建立航班預訂事件的模型,則班級timestamp欄位表示觀察預訂事件的時間。 與事件相關的其他時間戳記,例如旅行預訂的開始日期,應在標準或自訂欄位群組提供的個別欄位中擷取。

通過將類級時間戳記與事件結構中的其他相關日期時間值分開,您可以實施靈活的分段使用案例,同時保留體驗應用程式中客戶歷程的時間戳記帳戶。

使用計算欄位

您的體驗應用程式中的某些互動可能會產生多個相關事件,技術上會共用相同的事件時間戳記,因此可以呈現為單一事件記錄。 例如,如果客戶在您的網站上檢視產品,則可能會產生有兩個潛在eventType值的事件記錄:「產品檢視」事件(commerce.productViews)或一般「頁面檢視」事件(web.webpagedetails.pageViews)。 在這些情況下,當單一點擊中擷取多個事件時,您可以使用計算欄位來擷取最重要的屬性。

Adobe Experience Platform Data Prepack可讓您將資料對應、轉換及驗證至XDM和從XDM。使用服務提供的可用映射函式,可以調用邏輯運算子,以在將資料內嵌到Experience Platform中時優先處理、轉換和/或合併來自多事件記錄的資料。 在上述範例中,您可以將eventType指定為計算欄位,在「產品檢視」和「頁面檢視」同時發生時,將「產品檢視」優先順序設定於「頁面檢視」之上。

如果您要透過UI手動將資料內嵌至Platform,請參閱計算欄位指南上的指南,以了解如何建立計算欄位的特定步驟。

如果您使用來源連線將資料串流至Platform,您可以設定來源,改為使用計算欄位。 有關配置連接時如何實施計算欄位的說明,請參閱特定源🔗的文檔。

相容的架構欄位組

注意

數個欄位組的名稱已變更。 有關詳細資訊,請參閱欄位組名稱更新上的文檔。

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 從行銷電子郵件取消訂閱的人員。
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 Self
system 系統
salesRef 銷售代表
customerRep 客戶代表

本頁內容