为数据收集准备数据

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

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

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

何时使用数据准备进行数据收集 when-to-use-data-prep

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

通过WebSDK将现有数据层发送到Edge Network send-datalayer-via-websdk

现有数据层必须使用sendEvent命令中的data对象发送。

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

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

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

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

选择数据 select-data

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

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

{
  "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 对象示例。

{
  "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 有效，预览架构将显示在右侧面板中。选择​ 下一步 ​以继续。

预期传入数据的

映射

映射 ​步骤随即出现，可让您将源数据中的字段映射到 Platform 中目标事件架构的字段。从该位置，您可以通过两种方式配置映射：

创建映射规则 create-mapping

要创建映射规则，请选择​ 添加新映射。

选择源图标（ ），在出现的对话框中，选择要在提供的画布中映射的源字段。选择字段后，使用​ 选择 ​按钮以继续。

接下来，选择架构图标（ ），打开类似的目标事件架构对话框。在确认之前，使用​ 选择 ​来选择要将数据映射到的字段。

映射页面将重新出现，并显示已完成的字段映射。映射进度 ​部分将更新以反映已成功映射的字段总数。

TIP

如果要将一个对象数组（在源字段中）映射到不同对象的数组（在目标字段中），请在源字段路径和目标字段路径中的数组名称后添加 [*]，如下所示。

导入现有映射规则 import-mapping

如果以前创建过数据流，则可以为新数据流重复使用其配置的映射规则。

要开始，请选择​ 导入映射。

正在选择

在出现的对话框中，选择要导入其映射规则的数据流。选择该数据流后，选择​ 预览。

下一个屏幕显示所选数据流的已保存映射规则的预览。确保显示的映射为预期映射，然后选择​ 导入 ​以确认映射并将其添加到新数据流。

完成映射

继续执行上述步骤，将其余字段映射到目标架构。虽然您不必映射所有可用的源字段，但必须映射目标架构中设置为必需的任何字段才能完成此步骤。 必填字段 ​计数器指示当前配置中尚未映射的必填字段的数量。

在必填字段数达到零且对映射感到满意后，选择​ 保存 ​以完成更改。

后续步骤

本指南介绍如何在 UI 中设置数据流时将数据映射到 XDM。如果您正在按照一般数据流教程执行操作，现在可以返回到查看数据流详细信息步骤。