为数据收集准备数据

上次更新： 2023-12-06

主题：
Datastreams
查看有关此主题的更多信息

创建对象：
Developer

User

Admin

Leader

数据准备是一项 Adobe Experience Platform 服务，可让您从 Experience Data Model (XDM)映射数据并将数据映射到它、转换和验证数据。如果配置支持 Platform 的数据流，可以在将源数据发送到 Platform Edge Network 时，使用数据准备函数将源数据映射到 XDM。

所有从网页发送的数据必须以XDM形式登陆Experience Platform。有3种方法可以将数据从页面上的数据层转换为Experience Platform接受的XDM：

在网页上将数据层重新格式化为XDM。
使用标记本机数据元素功能，将网页的现有数据层格式重新格式化为XDM。
使用为数据收集准备数据，通过Edge Network将网页的现有数据层格式重新格式化为XDM。

本指南重点介绍第三个选项。

何时使用数据准备进行数据收集

在两种用例中，为数据收集准备数据很有用：

该网站具有格式正确、受管理和维护的数据层，并且更愿意将其直接发送到Edge Network，而不是使用JavaScript操作在页面上将其转换为XDM（通过标记数据元素或通过手动JavaScript操作）。
在该站点上部署了标记系统以外的标记系统。

通过WebSDK将现有数据层发送到Edge Network

现有的数据层必须使用 data 的选项 sendEvent 命令，如 Web SDK文档.

如果您使用的是标记，则必须使用数据字段 发送事件 操作类型，如 Web SDK标记扩展文档.

本指南的其余部分将重点介绍在WebSDK发送数据层后，如何将其映射到XDM标准。

注意

有关所有数据准备函数（包括计算字段的转换函数）的综合指南，请参阅以下文档：

本指南介绍如何在 UI 中映射数据。要执行这些步骤，请开始创建数据流的过程，直至（并包括）基本配置步骤。

有关“为数据收集准备数据”过程的快速演示，请观看以下视频：

选择数据

完成数据流的基本配置后，选择保存并添加映射，选择数据步骤随即出现。从该位置，您必须提供一个示例 JSON 对象，该对象表示您计划发送到 Platform 的数据的结构。

要直接从数据层捕获属性，该 JSON 对象必须具有单个根属性 data。的子属性 data 然后，应通过映射到要捕获的数据层属性的方式构建对象。选择以下部分可查看具有 data 根的格式正确的 JSON 对象示例。

示例 JSON 文件，具有 data 根

{
  "data": {
    "eventMergeId": "cce1b53c-571f-4f36-b3c1-153d85be6602",
    "eventType": "view:load",
    "timestamp": "2021-09-30T14:50:09.604Z",
    "web": {
      "webPageDetails": {
        "siteSection": "Product section",
        "server": "example.com",
        "name": "product home",
        "URL": "https://www.example.com"
      },
      "webReferrer": {
        "URL": "https://www.adobe.com/index2.html",
        "type": "external"
      }
    },
    "commerce": {
      "purchase": 1,
      "order": {
        "orderID": "1234"
      }
    },
    "product": [
      {
        "productInfo": {
          "productID": "123"
        }
      },
      {
        "productInfo": {
          "productID": "1234"
        }
      }
    ],
    "reservation": {
      "id": "anc45123xlm",
      "name": "Embassy Suits",
      "SKU": "12345-L",
      "skuVariant": "12345-LG-R",
      "priceTotal": "112.99",
      "currencyCode": "USD",
      "adults": 2,
      "children": 3,
      "productAddMethod": "PDP",
      "_namespace": {
        "test": 1,
        "priceTotal": "112.99",
        "category": "Overnight Stay"
      },
      "freeCancellation": false,
      "cancellationFee": 20,
      "refundable": true
    }
  }
}

要从 XDM 对象数据元素捕获属性，相同的规则将适用于 JSON 对象，但根属性必须键入为 xdm。选择以下部分可查看具有 xdm 根的格式正确的 JSON 对象示例。

示例 JSON 文件，具有 xdm 根

{
  "xdm": {
    "environment": {
      "type": "browser",
      "browserDetails": {
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebkit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36",
        "javaScriptEnabled": true,
        "javaScriptVersion": "1.8.5",
        "cookiesEnabled": true,
        "viewportHeight": 900,
        "viewportWidth": 1680,
        "javaEnabled": true
      },
      "domain": "adobe.com",
      "colorDepth": 24,
      "viewportHeight": 1050,
      "viewportWidth": 1680
    },
    "device": {
      "screenHeight": 1050,
      "screenWidth": 1680
    }
  }
}

您可以选择用于将对象作为文件上传的选项，或将原始对象粘贴到提供的文本框中。如果 JSON 有效，预览架构将显示在右侧面板中。选择下一步以继续。

预期的传入数据的 JSON 示例