[Alpha]{class="badge informative"}

data (伺服器SDK)

此頁面說明伺服器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