資料收集的資料準備

最後更新： 2025年4月4日

主題：
資料流

建立對象：

開發人員

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

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

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

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

何時使用「資料準備」進行資料收集

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

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

透過WebSDK將現有的資料層傳送至Edge Network

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

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

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

NOTE

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

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

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

video poster

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

選擇資料

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

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

具有 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 根的 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 有效，則會在右側面板中顯示預覽結構描述。選取 「下一步」 以繼續。

預期傳入資料的 JSON範例。