此頁面說明伺服器SDK sendEvent方法中的data。 若為Web SDK,請參閱data.
data物件可讓您傳送不符合XDM結構描述的資料。 這對於特定Adobe服務直接讀取的資料(例如Adobe Analytics或Adobe Target)或您對應至資料串流中XDM欄位的資料非常有用。 當資料到達資料流時,您可以使用資料收集的資料準備,將data物件中的每個欄位對應到XDM欄位。
IMPORTANT
data物件中的每個屬性至少必須以下列其中一種方式使用:- 資料串流中的服務已設定為讀取。
- 它會使用「資料準備」對應到XDM欄位。
如果屬性未對應至XDM欄位或供設定的服務使用,該資料會永久遺失。
呼叫sendEvent時設定data物件。 對於您打算在資料串流中對應的資料,您可以隨意建構此物件。 若是特定服務讀取的資料,請使用服務預期的結構。 您可以將data物件與xdm物件包含在同一個呼叫中。 xdm物件仍必須包含主要身分。
await visitor.sendEvent({
xdm: {
eventType: "web.webpagedetails.pageViews",
identityMap: {
Email: [{ id: "visitor@example.com", primary: true }]
}
},
data: {
loyaltyTier: "gold",
cartItemCount: 3
}
});
onBeforeEventSend回呼會接收data物件,所以您可以在SDK傳送事件之前先變更它。
搭配Adobe Analytics使用data物件 analytics
您可以使用data物件將資料傳送至不含XDM結構描述的Adobe Analytics報表套裝。 變數使用與AppMeasurement變數相同的語法。 請參閱Adobe Analytics實作指南中的資料物件變數對應至Adobe Analytics。
await visitor.sendEvent({
xdm: {
identityMap: {
Email: [{ id: "visitor@example.com", primary: true }]
}
},
data: {
__adobe: {
analytics: {
pageName: "Order confirmation",
eVar1: "Server-side value"
}
}
}
});
recommendation-more-help
experience-platform-help-collection