サイト上に製品がある場合は、アドビのほとんどの機能を有効にするために、このデフォルトのセットを送信することができます。これは提案ですが、最初から非常に強力なデータセットを提供します。
このドキュメントでは、 ExperienceEvent コマースの詳細 スキーマフィールドグループを使用します。 この commerce
フィールドグループは 2 つの部分に分類されます。の commerce
オブジェクトと productListItems
配列。 commerce
オブジェクトを使用すると、productListItems
配列に対してどのアクションが発生しているかを指定できます。
Adobe Analytics に詳しい方向けに説明すると、commerce
は events
と最も密接に関係しています。productListItems
は、products
変数とより密接に関連しています。
以下に、commerce
オブジェクトで使用可能な measures
のリストを示します。
測定には、2 つのフィールド(id
と value
)があります。ほとんどの場合、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_card 、gift_card 、paypal )。詳しくは、既知の値のリストを参照。 |
|
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 | 強く推奨 | 該当する場合にのみ設定する必要があります。例えば、 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 です。 |
productViews
イベント
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
productListAdds
イベント
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
イベント
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
}
]
}
});
order
イベント
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
}
]
}
});