Producto
El objeto producto representa un artículo de línea de producto que está en el carrito o que ha sido comprado en un pedido.
Propiedades
id
- Tipo:
string - Requerido
Un identificador de producto único. Se utiliza para diferenciar productos en el carrito o en el pedido.
WARNING
Algunos carritos de compra utilizan el mismo identificador o SKU para diferentes variantes de un producto. Si varios productos aparecen con el mismo id, Fanplayr los considerará idénticos y fusionará sus cantidades. Esto puede llevar a que se rastreen datos no deseados, por lo que es importante que proporciones un id único para cada producto distinto que se rastree.
qty
- Tipo:
integer - Requerido
La cantidad del artículo de línea en el carrito o en el pedido.
sku
- Tipo:
string - Requerido
El SKU del producto. Puede ser el mismo que id, pero también se encuentra disponible como opción de segmentación.
name
- Tipo:
string - Requerido
El nombre del producto. P. ej. "Zapatos Rojos".
price
- Tipo:
float - Requerido
El precio unitario del producto visible para el usuario.
Para los carritos que implementan un precio base y un precio con descuento/oferta, utiliza el precio con descuento si es el precio que se muestra a los usuarios cuando añaden el producto al carrito.
brands
- Tipo:
string[] - Alcance: Solo aplica a los objetos Producto utilizados en las páginas de Carrito de Compras y Confirmación de Pedido. Para las páginas de Producto, utiliza la propiedad marcas a nivel de página.
Un array de nombres de marcas asociados con el producto.
Ejemplo: ["Nike"]
categories
- Tipo:
string[] - Alcance: Solo aplica a los objetos Producto utilizados en las páginas de Carrito de Compras y Confirmación de Pedido. Para las páginas de Producto, utiliza la propiedad categorías a nivel de página.
Un array de nombres de categorías asociados con el producto.
Ejemplo: ["Mujeres", "Zapatos"]
catId
- Tipo:
string - Obsoleto. Usa categories en su lugar.
El ID de la categoría a la que pertenece este producto. Se pueden especificar múltiples categorías separándolas por comas. P. ej. "32,762".
catName
- Tipo:
string - Obsoleto. Usa categories en su lugar.
El nombre de la categoría a la que pertenece este producto. Se pueden especificar múltiples categorías separándolas por comas. P. ej. "Suelos de madera,Bancos".
url
- Tipo:
string
La URL de la página que muestra los detalles completos del producto.
image
- Tipo:
string
La URL de la imagen del producto.
Estrategia de fusión de productos
Fanplayr no podrá rastrear estos productos por separado ya que comparten el mismo id:
[
{
id: 'aygwi',
sku: 'aygwi',
name: 'Crew Tee (Black)',
price: 10.0,
qty: 1
},
{
id: 'aygwi',
sku: 'aygwi',
name: 'Crew Tee (White)',
price: 15.0,
qty: 1
}
];En su lugar, Fanplayr verá estos como un solo producto porque fusiona las cantidades de productos con el mismo id. Esto puede llevar a un cálculo incorrecto de los precios y cantidades de los productos.
[
{
id: 'aygwi',
sku: 'aygwi',
name: 'Crew Tee (Black)',
price: 10.0,
qty: 2
}
];Esto se puede evitar proporcionando identificadores únicos para los productos:
[
{
id: 'aygwi-black',
sku: 'aygwi',
name: 'Crew Tee (Black)',
price: 10.0,
qty: 1
},
{
id: 'aygwi-white',
sku: 'aygwi',
name: 'Crew Tee (White)',
price: 15.0,
qty: 1
}
];