コマースおよび製品情報の収集

サイト上に製品がある場合は、アドビのほとんどの機能を有効にするために、このデフォルトのセットを送信することができます。これは提案ですが、最初から非常に強力なデータセットを提供します。

このドキュメントは、ExperienceEventコマースの詳細スキーマフィールドグループを使用します。 commerceフィールドグループは2つの部分に分かれています。commerceオブジェクトとproductListItems配列。 commerce オブジェクトを使用すると、productListItems 配列に対してどのアクションが発生しているかを指定できます。

ヒント

Adobe Analytics に詳しい方向けに説明すると、commerceevents と最も密接に関係しています。productListItems は、products 変数とより密接に関連しています。

製品に関するアクション

以下に、commerce オブジェクトで使用可能な measures のリストを示します。

ヒント

測定には、2 つのフィールド(idvalue)があります。ほとんどの場合、value フィールドのみを使用します(例:'value':1)。この id フィールドでは、測定が送信されたタイミングを追跡可能な一意の ID を設定できます。測定については、XDM のドキュメントを参照してください。

測定 推奨 説明
cartAbandons オプション ユーザーが買い物かごにアクセスできなくなった、または購入できなくなった。
checkouts 強く推奨 ユーザーは製品を閲覧しなくなったが、製品の購入処理を進めている。
productListAdds 強く推奨 製品がリストに追加されている。必ず、productListItems で製品を同時に設定してください。
productListOpens オプション 新しい製品リストが作成されます。(例:新しい買い物かごが作成される)
productListRemovals 強く推奨 製品が製品リストから削除されています。
productListReopens オプション 製品リストがユーザーによって再アクティブ化されています。これは、リマーケティングキャンペーンで頻繁に発生します。
productListViews 強く推奨 製品のリストが表示されている。
productViews 強く推奨 製品の表示が発生した。productListItems で表示する製品は必ず設定してください 。
purchases 強く推奨 注文を受け付けている。製品リストが必要です。
saveForLaters オプション 後で使用するために製品を保存します。

SDK でこれらの Measures を設定する方法の例を以下に示します。

alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

コマースオブジェクトには、注文の詳細を収集するための、order と呼ばれる特別なフィールドもあります。

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

SDK の一般的な購入例を次に示します。

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

製品のリスト

製品リストには、対応するアクションに関連する製品が示されます。productListItems のリストです。各製品には、多数のオプションフィールドがあります。

フィールド 推奨 説明
currencyCode オプション 製品の ISO 4217 通貨。異なる通貨コードを持つ製品がある場合と、該当する場合にのみ便利です。例えば、購入があった場合や買い物かごに追加された場合などです。
priceTotal 強く推奨 該当する場合にのみ設定する必要があります。例えば、製品のバリエーションが異なると、価格が異なるのに productListAdds に記載されている場合があるので、productView では設定できない場合があります。
product 強く推奨 製品の XDM ID。
productAddMethod 強く推奨 訪問者が製品項目をリストに追加するために使用した方法。productListAdds 測定とともに設定され、製品がリストに追加された場合にのみ使用します。例として、add to cart buttonquick add、および upsell があります。
productName 強く推奨 製品の表示名または人が読み取り可能な名前に設定します。
quantity 強く推奨 顧客が製品を必要と示した数量。productListAddsproductListRemovespurchasessaveForLaters、などで設定する必要があります。
SKU 強く推奨 店舗在庫単位(Store Keeping Unit)。製品の一意の ID です。

productView イベント

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});

productView イベント

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

checkout イベント

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

purchase イベント

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

このページ