文件Experience Platform資料收集

收集商務、產品和訂單資訊

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員

如果您的組織銷售產品或服務，您可以使用此頁面作為追蹤這些產品和服務的指南。

此頁面使用XDM Commerce結構描述欄位群組。

此欄位群組包含兩個主要部分：

  • commerce物件。 此物件可讓您指出哪些動作發生在productListItems陣列上。
  • productListItems陣列。
TIP
如果您熟悉Adobe Analytics，commerce物件則包含與events變數中的商務事件類似的資料。 productListItems物件陣列包含與products變數類似的資料。

commerce物件 commerce-object

本節說明commerce物件中可用的欄位。

TIP
量值有兩個欄位： id和value。 大部分時間，您只使用value欄位（例如，'value':1）。 id欄位可讓您設定唯一識別碼，以便在傳送量值時進行追蹤。 如需詳細資訊，請參閱量值的XDM檔案。
衡量
建議
說明
cartAbandons
選填
使用者無法再存取或購買購物車。
checkouts
強烈建議
使用者不再瀏覽產品，但正在購買產品。
productListAdds
強烈建議
產品會新增至清單。 請確定同時在productListItems中設定產品。
productListOpens
選填
新產品清單隨即建立。 例如，會建立新的購物車。
productListRemovals
強烈建議
產品會從產品清單中移除。
productListReopens
選填
使用者會重新啟用產品清單。 此動作經常發生在再行銷活動中。
productListViews
強烈建議
已檢視的產品清單。
productViews
強烈建議
產品檢視已發生。 請務必設定在productListItems中檢視的產品。
purchases
強烈建議
已接受訂單。 必須有產品清單。
saveForLaters
選填
儲存產品以供日後使用。

Commerce物件範例

展開以下區段以檢視使用commerce物件欄位的Web SDK命令範例。

productViews

將sendEvent欄位設定為productViews的基本Web SDK 1呼叫：

code language-javascript 
alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

order物件 order-object

commerce物件包含用於收集訂單詳細資料的專用物件。 這稱為order物件。

本節說明order物件支援的所有欄位。

欄位
選項
建議
說明
currencyCode
訂單總計的ISO 4217貨幣。
payments[]
訂單上的付款清單。 paymentItem包含下列專案。
currencyCode
選填
此付款方式的ISO 4217貨幣。
paymentAmount
強烈建議
以指定貨幣代碼表示的付款值。
paymentType
強烈建議
付款型別（例如，credit_card、gift_card、paypal）。 如需詳細資訊，請參閱已知值的清單。
transactionID
選填
此付款交易的唯一識別碼。
priceTotal
強烈建議
此訂單套用所有折扣和稅金後的總計。
purchaseID
強烈建議
賣家為此購買所指派的唯一識別碼。
purchaseOrderNumber
選填
購買者為此購買所指派的唯一識別碼。

排序物件範例

展開以下區段以檢視使用commerce物件的網頁SDK命令範例。

Order物件範例

網頁SDK sendEvent呼叫設定套用至order陣列中多個產品的productListItems物件：

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "order":{
        "purchaseID":"123456789",
        "currencyCode":"USD",
        "priceTotal":39.98,
        "payments":[
          {
            "transactionID":"amx12345",
            "paymentAmount":39.98,
            "paymentType":"credit_card",
            "currencyCode":"USD"
          }
        ]
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "priceTotal":29.99,
        "quantity":1
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "priceTotal":9.99,
        "quantity":1
      }
    ]
  }
});

產品清單物件 product-list-object

產品清單會指出哪些產品與對應動作相關。 它是productListItems的清單。 每個產品都有數個選用欄位。

欄位
建議
說明
currencyCode
選填
產品的ISO 4217貨幣。 此欄位通常僅適用於產品清單中有多個產品具有不同的貨幣代碼時。
priceTotal
強烈建議
僅在適用時設定此欄位。 例如，可能無法在productView事件上設定，因為產品的不同變數可能會有不同的價格，但針對productListAdds事件。
product
強烈建議
產品的XDM ID。
productAddMethod
強烈建議
訪客用來將產品專案新增至清單的方法。 設定為productListAdds個測量值，且僅在產品新增至清單時使用。 範例包括add to cart button、quick add和upsell。
productName
強烈建議
產品的顯示名稱或人類看得懂的名稱。
quantity
強烈建議
客戶已表示所需的產品單位數。 應該設定在productListAdds、productListRemoves、purchases、saveForLaters等。
SKU
強烈建議
存放區維護單位。 這是產品的唯一識別碼。

產品清單範例

展開下列各節，檢視使用productListItems物件的網頁SDK命令範例。

productListItems範例

網頁SDK sendEvent呼叫設定productViews陣列中多個產品的productListItems：

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});
productListAdds範例

網頁SDK sendEvent呼叫設定productListAdds陣列中多個產品的productListItems事件：

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productListAdds":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99,
        "productAddMethod":"Add to Cart Button"
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99,
        "productAddMethod":"Add-on"
      }
    ]
  }
});
checkouts範例

網頁SDK sendEvent呼叫設定checkouts陣列中多個產品的productListItems事件：

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "checkouts":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99
      }
    ]
  }
});
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1