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 XDM Esquema de Commerce grupo de campos.
Este grupo de campos consta de dos partes principales:
commerce
objeto. Este objeto permite indicar qué acciones se producen en el productListItems
matriz.productListItems
matriz.Si está familiarizado con Adobe Analytics, la variable commerce
contiene datos similares a eventos de comercio en el events
variable. El productListItems
la matriz de objetos contiene datos similares a los de products
variable.
commerce
objetoEsta sección describe los campos disponibles en la variable commerce
objeto.
Una medida tiene dos campos: id
y value
. La mayoría de las veces, solo se utiliza el value
field (por ejemplo, 'value':1
). El id
Este campo permite establecer un identificador único para el seguimiento del envío de la medida. Consulte la documentación de XDM para Medida para obtener más información.
Medida | Recomendación | Descripción |
---|---|---|
cartAbandons |
Opcional | El usuario ya no puede comprar ni acceder al carro de compras. |
checkouts |
Muy recomendado | Un usuario ya no está buscando productos, pero está en el proceso de comprar un producto. |
productListAdds |
Muy recomendado | Se agrega un producto a una lista. Asegúrese de configurar el producto en la productListItems al mismo tiempo. |
productListOpens |
Opcional | Se crea una nueva lista de productos. Por ejemplo, se crea un nuevo carro de compras. |
productListRemovals |
Muy recomendado | Los productos se eliminan de las listas de productos. |
productListReopens |
Opcional | El usuario reactiva una lista de productos. Esta acción suele ocurrir en campañas de remarketing. |
productListViews |
Muy recomendado | Se muestra una lista de productos. |
productViews |
Muy recomendado | Se produjo una vista de un producto. Asegúrese de configurar el producto visualizado en la productListItems . |
purchases |
Muy recomendado | Se acepta una solicitud. Debe tener una lista de productos. |
saveForLaters |
Opcional | Se ha guardado un producto para uso futuro. |
Commerce
ejemplos de objetoExpanda la sección siguiente para ver un ejemplo de un comando del SDK web que utiliza un campo del commerce
objeto.
productViews
Un SDK web básico sendEvent
llamada configurar el productViews
field a 1
:
alloy("sendEvent", {
"xdm":{
"commerce":{
"productViews":{
"value":1
}
}
}
});
order
objetoEl commerce
contiene un objeto dedicado para recopilar detalles de pedidos. Esto se denomina order
objeto.
En esta sección se describen todos los campos admitidos por la variable order
objeto.
Campo | Opción | Recomendación | Descripción |
---|---|---|---|
currencyCode |
El ISO 4217 divisa del total del pedido. | ||
payments[] |
La lista de pagos de un pedido. A paymentItem incluye lo siguiente. | ||
currencyCode |
Opcional | El ISO 4217 divisa de esta forma de pago. | |
paymentAmount |
Muy recomendado | El valor del pago en el código de divisa especificado. | |
paymentType |
Muy recomendado | El tipo de pago (por ejemplo, credit_card , gift_card , paypal ). Consulte la lista de valores conocidos para obtener más información. |
|
transactionID |
Opcional | Un ID único para esta transacción de pago. | |
priceTotal |
Muy recomendado | El total de este pedido después de aplicar todos los descuentos e impuestos. | |
purchaseID |
Muy recomendado | El identificador único asignado por el vendedor a esta compra. | |
purchaseOrderNumber |
Opcional | Un identificador único asignado por el comprador a esta compra. |
Expanda la sección siguiente para ver un ejemplo de un comando del SDK web que utiliza el commerce
objeto.
Order
ejemplo de objetoUn SDK web sendEvent
llamada configurar el order
que se aplica a varios productos de la productListItems
matriz:
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
}
]
}
});
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.
Campo | Recomendación | Descripción |
---|---|---|
currencyCode |
Opcional | El ISO 4217 la moneda del producto. Por lo general, este campo solo se aplica cuando hay varios productos en la lista de productos con códigos de moneda diferentes. |
priceTotal |
Muy recomendado | Establezca este campo solo cuando corresponda. Por ejemplo, es posible que no se pueda establecer en productView debido a que diferentes variaciones del producto pueden tener diferentes precios, pero en un productListAdds evento. |
product |
Muy recomendado | ID de XDM para el producto. |
productAddMethod |
Muy recomendado | El método que el visitante utilizó para agregar un producto a la lista. Configurado con productListAdds y solo se utiliza cuando se añade un producto a la lista. Los ejemplos incluyen add to cart button , quick add y upsell . |
productName |
Muy recomendado | El nombre para mostrar o el nombre en lenguaje natural del producto. |
quantity |
Muy recomendado | El número de unidades que el cliente ha indicado que necesita del producto. Debe configurarse en productListAdds , productListRemoves , purchases , saveForLaters , etc. |
SKU |
Muy recomendado | Almacén de la unidad. Es el identificador único del producto. |
Expanda las secciones siguientes para ver ejemplos de comandos del SDK web que utilizan productListItems
objeto.
productListItems
ejemploUn SDK web sendEvent
llamada configurar el productViews
para varios productos en la productListItems
matriz:
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
productListAdds
ejemploUn SDK web sendEvent
llamada configurar el productListAdds
evento para varios productos en la productListItems
matriz:
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
ejemploUn SDK web sendEvent
llamada configurar el checkouts
evento para varios productos en la productListItems
matriz:
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
}
]
}
});