Si tiene productos en el sitio, este es un conjunto predeterminado de elementos que puede que desee enviar para habilitar la mayoría de las funciones desde el Adobe. Aunque esto es una sugerencia, proporciona un conjunto de datos muy sólido desde el principio.
Este documento usa el Detalles comerciales de ExperienceEvent grupo de campos de esquema. El commerce
grupo de campos se divide en dos partes: la variable commerce
y el objeto productListItems
matriz. El commerce
permite indicar qué acciones se están produciendo en el productListItems
matriz.
Si está familiarizado con Adobe Analytics, puede usar el commerce
está más estrechamente relacionado con la variable events
variable. El productListItems
está más estrechamente relacionado con el products
variable.
A continuación se muestra una lista de measures
disponible en el commerce
objeto.
Una medida tiene dos campos: id
y value
. La mayoría de las veces, utilizará el value
solo de campo (por ejemplo, 'value':1
). El id
Este campo le permite establecer un identificador único que puede utilizar para realizar un seguimiento del momento en el que se envió la medida. Consulte la documentación de XDM para Medida.
Medida | Recomendación | Descripción |
---|---|---|
cartAbandons | Opcional | El usuario ya no puede comprar ni acceder al carro de compras. |
cierres | 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. Esto suele ocurrir en las campañas de remarketing. |
productListViews | Muy recomendado | Se muestra una lista de productos. |
productViews | Muy recomendado | Se ha producido una vista de un producto. Asegúrese de configurar el producto visualizado en la productListItems . |
compras | Muy recomendado | Se acepta una solicitud. Debe tener una lista de productos. |
saveForLaters | Opcional | Se ha guardado un producto para uso futuro. |
A continuación se muestra un ejemplo de cómo configuraría estos Measures
en el SDK.
alloy("sendEvent", {
"xdm":{
"commerce":{
"productViews":{
"value":1
}
}
}
});
El objeto de comercio también tiene un campo especial para recopilar detalles de pedidos denominado order
.
Pedido | Opción | Recomendación | Descripción |
---|---|---|---|
currencyCode | El ISO 4217 divisa del total del pedido. | ||
pagos[paymentItems] | 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. |
A continuación, se muestra un ejemplo de una compra típica en el 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
}
]
}
});
La lista de productos indica qué productos están relacionados con la acción correspondiente. Es una lista de productListItems. Cada producto tiene una serie de campos opcionales.
Campo | Recomendación | Descripción |
---|---|---|
currencyCode | Opcional | El ISO 4217 moneda para el producto. Esto solo es útil cuando puede tener productos con diferentes códigos de moneda y cuando se aplica. Por ejemplo, cuando hay una compra o una adición al carro de compras. |
priceTotal | Muy recomendado | Solo debe configurarse 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. |
producto | 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 medidas, y solo deben utilizarse cuando se añada un producto a la lista. Los ejemplos incluyen add to cart button , quick add y upsell . |
productName | Muy recomendado | Se establece en el nombre para mostrar o en un nombre legible en lenguaje natural del producto. |
cantidad | 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. |
productViews
evento
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
productListAdds
evento
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
evento
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
evento
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
}
]
}
});