コマース、製品および注文の情報を収集します

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

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

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

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

commerce オブジェクト。このオブジェクトを使用すると、productListItems 配列に対して実行されるアクションを指定できます。
productListItems 配列。

TIP

Adobe Analyticsに精通している場合、commerce オブジェクトには、events 変数のコマースイベントに似たデータが含まれます。 productListItems オブジェクト配列には、products 変数に類似したデータが含まれています。

`commerce` オブジェクト commerce-object

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

TIP

測定には、2 つのフィールド（id と value）があります。ほとんどの場合、使用するのは value フィールド（例：'value':1）のみです。「id」フィールドを使用すると、測定が送信された際にトラッキングする一意の ID を設定できます。詳しくは、測定の 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。

Order オブジェクトの例

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

Order オブジェクトの例

Web SDK sendEvent は、productListItems 配列内の複数の製品に適用される order オブジェクトを設定する呼び出しを行います。

code language-javascript

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 } ] } });`

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

強くお勧めします

店舗在庫単位（Store Keeping Unit）。製品の一意の ID です。

製品リストの例

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

productListItems 例

Web SDK は、productListItems 配列の複数の製品の productViews を設定して呼び出すことがで sendEvent ます。

code language-javascript

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", } ] } });`

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 は、productListItems 配列の複数の製品に対して productListAdds イベントを設定する sendEvent を呼び出します。

code language-javascript

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" } ] } });`

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 は、productListItems 配列の複数の製品に対して checkouts イベントを設定する sendEvent を呼び出します。

code language-javascript

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 } ] } });`

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

ad108910-6329-42f1-aa1d-5920a2b13636

コマース、製品および注文の情報を収集します

commerce オブジェクト commerce-object

Commerce オブジェクトの例

order オブジェクト order-object

Order オブジェクトの例

商品リストオブジェクト product-list-object

製品リストの例

`commerce` オブジェクト commerce-object

`Commerce` オブジェクトの例

`order` オブジェクト order-object