ドキュメントExperience PlatformWeb SDK ガイド

コマース、製品、注文情報の収集

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer

組織が製品やサービスを販売している場合は、このページを使用して、製品やサービスの追跡方法を確認できます。

このページでは XDM を使用します コマーススキーマ フィールドグループを使用します。

このフィールドグループは、次の 2 つの主要な部分で構成されます。

  • The commerce オブジェクト。 このオブジェクトを使用すると、 productListItems 配列。
  • The productListItems 配列。
TIP
Adobe Analyticsに詳しい方は、 commerce オブジェクトには、 events 変数を使用します。 The productListItems オブジェクト配列には、 products 変数を使用します。

The commerce object commerce-object

この節では、 commerce オブジェクト。

TIP
測定には、2 つのフィールド（id と value）があります。ほとんどの場合、 value フィールド ( 例： 'value':1) をクリックします。 The id 「 」フィールドでは、測定が送信された際の追跡用の一意の識別子を設定できます。 詳しくは、 XDM のドキュメントを参照してください。 測定 を参照してください。
測定
レコメンデーション
説明
cartAbandons
オプション
ユーザーが買い物かごにアクセスできなくなった、または購入できなくなった。
checkouts
強く推奨
ユーザーは製品を閲覧しなくなったが、製品の購入処理を進めている。
productListAdds
強く推奨
製品がリストに追加されている。必ず、productListItems で製品を同時に設定してください。
productListOpens
オプション
新しい製品リストが作成されます。例えば、新しい買い物かごが作成されるとします。
productListRemovals
強く推奨
製品が製品リストから削除されています。
productListReopens
オプション
製品リストがユーザーによって再アクティブ化されています。このアクションは、リマーケティングキャンペーンで頻繁に発生します。
productListViews
強く推奨
製品のリストが表示されている。
productViews
強く推奨
製品の表示が発生しました。 productListItems で表示する製品は必ず設定してください 。
purchases
強く推奨
注文を受け付けている。製品リストが必要です。
saveForLaters
オプション
後で使用するために製品を保存します。

Commerce オブジェクトの例

以下の節を展開して、 commerce オブジェクト。

productViews

基本的な Web SDK sendEvent を呼び出し、 productViews ～に向かって 1:

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

The order object order-object

The commerce オブジェクトには、注文の詳細を収集するための専用のオブジェクトが含まれています。 これは、 order オブジェクト。

この節では、 order オブジェクト。

フィールド
オプション
レコメンデーション
説明
currencyCode
注文合計の ISO 4217 通貨。
payments[]
注文の支払の一覧。paymentItem には、次が含まれます。
currencyCode
オプション
この支払い方法の ISO 4217 通貨。
paymentAmount
強く推奨
指定した通貨コードでの支払金額。
paymentType
強く推奨
支払のタイプ（例：credit_card、gift_card、paypal）。詳しくは、既知の値のリストを参照。
transactionID
オプション
この支払トランザクションの一意の ID。
priceTotal
強く推奨
すべての割引と税金が適用された後の、この注文の合計。
purchaseID
強く推奨
販売者がこの購入に割り当てた一意の ID。
purchaseOrderNumber
オプション
購入者がこの購入に割り当てた一意の ID。

Order オブジェクトの例

以下の節を展開して、 commerce オブジェクト。

Order オブジェクトの例

Web 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
オプション
The ISO 4217 通貨を設定します。 このフィールドは、通常、異なる通貨コードを持つ製品リストに複数の製品がある場合にのみ適用されます。
priceTotal
強く推奨
このフィールドは、該当する場合にのみ設定します。 例えば、 productView 製品の異なるバリエーションは、異なる価格を持つことができますが、 productListAdds イベント。
product
強く推奨
製品の XDM ID。
productAddMethod
強く推奨
訪問者が製品項目をリストに追加するために使用した方法。次で設定： productListAdds はを測定し、製品がリストに追加された場合にのみ使用します。 例として、add to cart button、quick add、および upsell があります。
productName
強く推奨
製品の表示名または人間が読み取り可能な名前。
quantity
強く推奨
顧客が製品を必要と示した数量。productListAdds、productListRemoves、purchases、saveForLaters、などで設定する必要があります。
SKU
強く推奨
店舗在庫単位（Store Keeping Unit）。製品の一意の ID です。

製品リストの例

以下のセクションを展開して、 productListItems オブジェクト。

productListItems 例

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

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

Web 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
def05a9c-d048-422c-a3a1-88b2de863f4f