[Alpha]{class="badge informative"}

data (服务器SDK)

本页介绍了Server 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