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

組織で製品やサービスを販売している場合は、このページを、それらの製品やサービスの追跡方法に関するガイドとして使用できます。

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

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

  • commerce オブジェクト。 このオブジェクトを使用すると、productListItems配列に対して実行されるアクションを指定できます。
  • productListItems配列。
TIP
Adobe Analyticsに精通している場合、commerce オブジェクトには、events変数にコマースイベントに似たデータが含まれています。 productListItems オブジェクト配列には、products変数に類似したデータが含まれています。

commerce オブジェクト commerce-object

この節では、commerce オブジェクトで使用可能なフィールドについて説明します。

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

Commerce オブジェクトの例

以下のセクションを展開して、commerce オブジェクトのフィールドを使用したWeb SDK コマンドの例を確認します。

productViews

productViews フィールドを1に設定する基本的なWeb SDK sendEvent呼び出し:

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
オプション
この支払トランザクションの一意の ID。
priceTotal
強くお勧めします
すべての割引と税金が適用された後の、この注文の合計。
purchaseID
強くお勧めします
販売者がこの購入に割り当てた一意の ID。
purchaseOrderNumber
オプション
購入者がこの購入に割り当てた一意の ID。

注文オブジェクトの例

以下のセクションを展開して、commerce オブジェクトを使用したWeb SDK コマンドの例を確認します。

Order オブジェクトの例

productListItems配列内の複数の商品に適用されるorder オブジェクトを設定するWeb SDK sendEvent呼び出し:

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
強くお勧めします
該当する場合にのみ、このフィールドを設定します。 例えば、商品の異なるバリエーションは異なる価格を持つことができますが、productListAdds イベントでは異なる価格を持つことができるため、productView イベントに設定できない場合があります。
product
強くお勧めします
製品の XDM ID。
productAddMethod
強くお勧めします
訪問者が製品項目をリストに追加するために使用した方法。 productListAdds個のメジャーで設定し、製品がリストに追加されたときにのみ使用します。 例として、add to cart button、quick add、および upsell があります。
productName
強くお勧めします
製品の表示名または読みやすい名前。
quantity
強くお勧めします
顧客が製品を必要と示した数量。 productListAdds、productListRemoves、purchases、saveForLaters、などで設定する必要があります。
SKU
強くお勧めします
店舗在庫単位(Store Keeping Unit)。 製品の一意の ID です。

製品リストの例

以下のセクションを展開して、productListItems オブジェクトを使用したWeb SDK コマンドの例を確認します。

productListItemsの例

productListItems アレイ内の複数の製品に対してproductViewsを設定するWeb SDK sendEvent呼び出し:

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

productListItems アレイ内の複数の製品に対してproductListAdds イベントを設定するWeb SDK sendEvent呼び出し:

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

productListItems アレイ内の複数の製品に対してcheckouts イベントを設定するWeb SDK sendEvent呼び出し:

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
experience-platform-help-collection