为数据收集准备数据

数据准备是一项Adobe Experience Platform服务,允许您映射、转换和验证来往数据 体验数据模型(XDM). 配置启用平台时 数据流,则可在将源数据发送到Platform Edge Network时,使用数据准备功能将其映射到XDM。

注意

有关所有数据准备功能的全面指南,包括计算字段的转换函数,请参阅以下文档:

本指南介绍如何在UI中映射数据。 要遵循这些步骤,请开始创建数据流的过程,直到(并包括) 基本配置步骤.

有关为数据收集准备数据过程的快速演示,请参阅以下视频:

选择数据

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

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

 示例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 而是。 选择以下部分可查看正确格式化JSON对象的示例 xdm 根。

 示例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示例

映射

映射 步骤,以便将源数据中的字段映射到Platform中目标事件架构的字段。 在此,您可以通过两种方式配置映射:

创建新映射

要开始配置,请选择 添加新映射 以创建新的映射行。

添加新映射

选择源图标(“源”图标),然后在显示的对话框中,选择要映射到所提供画布的源字段。 选择字段后,使用 选择 按钮以继续。

选择要在源架构中映射的字段

接下来,选择架构图标(“架构”图标)以打开目标事件架构的类似对话框。 在使用进行确认之前,选择要将数据映射到其中的字段 选择.

选择要映射到目标架构中的字段

此时会重新显示映射页面,并显示已完成的字段映射。 此 映射进度 部分更新以反映已成功映射的字段总数。

字段已成功映射,并反映了进度

小贴士

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

数组对象映射

导入现有映射规则

如果您之前已创建数据流,则可以将它配置的映射规则重新用于新数据流。

警告

从其他数据流导入映射规则将覆盖导入之前可能已添加的任何字段映射。

要开始,请选择 导入映射.

图像显示 导入映射 正在选择按钮

在显示的对话框中,选择要导入其映射规则的数据流。 选择数据流后,选择 预览.

显示正在选择的现有数据流的图像

注意

数据流只能导入同一个 沙盒. 换言之,您不能将数据流从一个沙盒导入另一个沙盒。

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

显示要导入的映射规则的图像

注意

如果导入的映射规则中的任何源字段未包含在您输入的示例JSON数据中, 先前提供,这些字段映射将不会包含在导入中。

完成映射

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

一旦必填字段数达到零且对映射满意,请选择 保存 以完成更改。

映射完成

后续步骤

本指南介绍了在UI中设置数据流时如何将数据映射到XDM。 如果您正在学习常规数据流教程,现在可以返回到上的步骤 查看数据流详细信息.

在此页面上