Raccogliere informazioni su prodotti e ordini
Creato per:
- Sviluppatore
Se la tua organizzazione vende prodotti o servizi, puoi utilizzare questa pagina come guida su come tracciare tali prodotti e servizi.
In questa pagina viene utilizzato il gruppo di campi Schema Commerce XDM.
Questo gruppo di campi è costituito da due parti principali:
- Oggetto
commerce. Questo oggetto consente di indicare quali azioni vengono eseguite sull'arrayproductListItems. - Array
productListItems.
TIPcommerce contiene dati simili agli eventi commerce nella variabile events. L'array di oggetti productListItems contiene dati simili alla variabile products.Oggetto commerce
Questa sezione descrive i campi disponibili nell'oggetto commerce.
TIPid e value. Nella maggior parte dei casi si utilizza solo il campo value (ad esempio 'value':1). Il campo id consente di impostare un identificatore univoco per il tracciamento al momento dell'invio della misura. Per ulteriori informazioni, consulta la documentazione XDM per Measure.productListItems contemporaneamente.productListItems.Commerce esempi di oggetti
Espandere la sezione seguente per visualizzare un esempio di un comando Web SDK che utilizza un campo dell'oggetto commerce.
productViewsUna chiamata Web SDK di base sendEvent che imposta il campo productViews su 1:
alloy("sendEvent", {
"xdm":{
"commerce":{
"productViews":{
"value":1
}
}
}
});
Oggetto order
L'oggetto commerce contiene un oggetto dedicato per la raccolta dei dettagli dell'ordine. Questo è denominato oggetto order.
Questa sezione descrive tutti i campi supportati dall'oggetto order.
credit_card, gift_card, paypal). Per ulteriori informazioni, vedere l'elenco di valori noti.Esempi di oggetti dell’ordine
Espandere la sezione seguente per visualizzare un esempio di un comando Web SDK che utilizza l'oggetto commerce.
Order esempio di oggettoUna chiamata SDK Web sendEvent che imposta l'oggetto order che si applica a più prodotti nell'array productListItems:
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
}
]
}
});
Oggetto elenco prodotti
L’elenco dei prodotti indica quali prodotti sono correlati all’azione corrispondente. È un elenco di productListItems. Ogni prodotto ha diversi campi facoltativi.
productView perché diverse varianti del prodotto possono avere prezzi diversi ma su un evento productListAdds.productListAdds misure e utilizzato solo quando un prodotto viene aggiunto all'elenco. Gli esempi includono add to cart button, quick add e upsell.productListAdds, productListRemoves, purchases, saveForLaters e così via.Esempi di elenco dei prodotti
Espandere le sezioni seguenti per visualizzare esempi di comandi Web SDK che utilizzano l'oggetto productListItems.
productListItems esempioUna chiamata SDK Web sendEvent che imposta productViews per più prodotti nell'array productListItems:
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
productListAdds esempioUna chiamata SDK Web sendEvent che imposta l'evento productListAdds per più prodotti nell'array productListItems:
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 esempioUna chiamata SDK Web sendEvent che imposta l'evento checkouts per più prodotti nell'array productListItems:
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
}
]
}
});