[Alpha]{class="badge informative"}

xdm （服务器SDK）

本页介绍了Server SDK sendEvent方法中的xdm。 对于Web SDK，请参阅xdm.

xdm对象包含您以与Experience Data Model (XDM)架构匹配的结构发送到Adobe的数据。 在此对象中设置的字段直接映射到数据流向其发送数据的数据集架构中的字段。

确保此对象中的层级与配置的数据集的架构匹配。 在同一sendEvent调用中可以同时包含xdm对象和data对象。

以下示例使用Commerce详细信息架构字段组：

await visitor.sendEvent({
  xdm: {
    eventType: "commerce.productViews",
    identityMap: {
      Email: [{ id: "visitor@example.com", primary: true }]
    },
    commerce: {
      productViews: { value: 1 }
    },
    productListItems: [
      { SKU: "HT105", name: "Large field hat" },
      { SKU: "HT104", name: "Small field hat" }
    ]
  }
});

包括主要身份 primary-identity

服务器SDK发送的每个事件都必须在xdm.identityMap中包含主标识。 在浏览器中，Edge Network可以从其Cookie中识别访客。 对于服务器到服务器请求，它需要在事件本身中有一个标识。 如果事件中没有任何标识标记为主，则Edge Network会拒绝该事件，错误代码为EXEG-0306-400，并且sendEvent会拒绝。

仅在一个标识上设置primary: true：

xdm: {
  identityMap: {
    Email: [
      { id: "visitor@example.com", primary: true }
    ],
    CRMID: [
      { id: "1234567" }
    ]
  }
}

identityMap中的每个键都是您在组织中定义的标识命名空间，每个值是该命名空间中的标识数组。 有关详细信息，请参阅使用identityMap。

SDK添加的数据 automatic

SDK将xdm.implementationDetails添加到每个事件，并可以从请求的Referer标头添加xdm.web.webPageDetails.URL。 如果还设置xdm.web.webPageDetails.URL，则使用您的值。 请参阅上下文和转发的标头。

如果同时设置xdm.eventType和type选项，则使用xdm.eventType中的值。