資料收集的資料準備

Last update: Tue Mar 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Datastreams

建立對象：

Developer

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

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

在網頁本身上將資料層重新格式化為XDM。
使用標籤原生資料元素功能，將網頁的現有資料層格式重新格式化為XDM。
使用資料收集的資料準備，透過Edge Network將網頁的現有資料層格式重新格式化為XDM。

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

何時使用「資料準備」進行資料收集 when-to-use-data-prep

在兩種使用案例中，「資料收集的資料準備」很有用：

網站具有格式正確、受控管和維護的資料層，且偏好直接傳送至Edge Network，而非使用JavaScript操作在頁面上將其轉換為XDM （透過Tags資料元素或手動JavaScript操作）。
網站上會部署標籤系統以外的標籤系統。

透過WebSDK將現有的資料層傳送至Edge Network send-datalayer-via-websdk

現有的資料層必須使用 data 內的物件 sendEvent 命令。

如果您使用標籤，則必須使用資料欄位屬於 傳送事件 動作型別，如 Web SDK標籤擴充功能檔案.

本指南的其餘部分著重於在WebSDK傳送資料層後，如何將資料層對應至XDM標準。

NOTE

如需有關所有資料準備功能 (包括計算欄位的轉換函數) 的綜合性指南，請參閱以下文件：

本指南會介紹如何在 UI 中對應資料。若要遵照這些步驟進行，請先開始從建立資料流一直到 (並包括) 基本設定步驟的流程。

如需「資料集合的資料準備」流程的快速示範，請參考以下影片：

https://video.tv.adobe.com/v/342120?quality=12&enable10seconds=on&speedcontrol=on

選擇資料 select-data

完成資料流的基本設定之後，請選取「儲存並新增對應」，「選取資料」步驟會隨即顯示。在這裡，您必須提供一個 JSON 物件範例 (代表您計劃傳送到 Platform 的資料的結構)。

若要直接從資料層擷取屬性，JSON 物件必須具有單一根屬性data。的子屬性 data 物件之後應該會以對應至您要擷取的資料層屬性的方式建構。請選取以下區段，即可檢視正確格式化並具有 data 根的 JSON 物件範例。

具有 data 根的 JSON 檔案範例

code language-json

code language-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 } } }

{
  "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 根的 JSON 檔案範例

code language-json

code language-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 } } }

{
  "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範例。