資料收集的資料準備

「資料準備」是一種 Adob​​e Experience Platform 服務，可讓您和體驗資料模型 (XDM) 相互對應、轉換和驗證資料。設定啟用 Platform 的資料流時，若將來源資料傳送到 Platform Edge Network，可以使用資料準備功能將其對應到 XDM。

所有從網頁傳送的資料都必須以XDM的形式Experience Platform。 有3種方式可以將資料從頁面上的資料層轉譯為Experience Platform接受的XDM：

本指南著重於第3個選項。

何時使用「資料準備」進行資料收集 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。如果您正在查看一般資料流教學課程，現在可以返回到檢視資料流詳細資料的步驟。