Recopilar información comercial, de productos y de pedidos
Creado para:
- Desarrollador
Si su organización vende productos o servicios, puede utilizar esta página como guía sobre cómo rastrear esos productos y servicios.
Esta página utiliza el grupo de campos XDM Esquema de Commerce.
Este grupo de campos consta de dos partes principales:
- El objeto
commerce. Este objeto le permite indicar qué acciones suceden a la matrizproductListItems. - La matriz
productListItems.
TIPcommerce contiene datos similares a los eventos de comercio en la variable events. La matriz de objetos productListItems contiene datos similares a la variable products.El objeto commerce
Esta sección describe los campos disponibles en el objeto commerce.
TIPid y value. La mayoría de las veces, solo utiliza el campo value (por ejemplo, 'value':1). El campo id le permite establecer un identificador único para el seguimiento de cuándo se envió la medida. Consulte la documentación de XDM para Measure para obtener más información.productListItems al mismo tiempo.productListItems.Commerce ejemplos de objeto
Expanda la sección siguiente para ver un ejemplo de un comando del SDK web que utiliza un campo del objeto commerce.
productViewsUna llamada básica del SDK web sendEvent que establece el campo productViews en 1:
alloy("sendEvent", {
"xdm":{
"commerce":{
"productViews":{
"value":1
}
}
}
});
El objeto order
El objeto commerce contiene un objeto dedicado para recopilar detalles de pedidos. Se denomina objeto order.
En esta sección se describen todos los campos admitidos por el objeto order.
credit_card, gift_card, paypal). Consulte la lista de valores conocidos para obtener detalles.Ejemplos de objetos de pedidos
Expanda la sección siguiente para ver un ejemplo de un comando del SDK web que utiliza el objeto commerce.
OrderUna llamada del SDK web sendEvent que establece el objeto order que se aplica a varios productos de la matriz 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
}
]
}
});
El objeto de lista de productos
La lista de productos indica qué productos están relacionados con la acción correspondiente. Es una lista de productListItems. Cada producto tiene varios campos opcionales.
productView porque distintas variaciones del producto pueden tener precios diferentes pero en un evento productListAdds.productListAdds medidas y solo se usa cuando se agrega un producto a la lista. Algunos ejemplos son add to cart button, quick add y upsell.productListAdds, productListRemoves, purchases, saveForLaters, etc.Ejemplos de listas de productos
Expanda las secciones siguientes para ver ejemplos de comandos del SDK web que utilizan el objeto productListItems.
productListItemsUna llamada del SDK web sendEvent que configura productViews para varios productos en la matriz productListItems:
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
productListAddsUna llamada del SDK web sendEvent que configura el evento productListAdds para varios productos en la matriz 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"
}
]
}
});
checkoutsUna llamada del SDK web sendEvent que configura el evento checkouts para varios productos en la matriz 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
}
]
}
});