Kameleoon.API.Products: Tracking - Kameleoon Documentation

Use estos métodos para enviar a Kameleoon las vistas de productos y de categorías, las búsquedas, los cambios en el carrito y en la lista de deseos, y las compras.

Este módulo está disponible al suscribirse al módulo Product Recommendation o al add-on Product Targeting.

trackAddToCart

El método trackAddToCart() se dispara cuando un visitante añade un producto al carrito de la compra.

var buyButton = Kameleoon.API.Utils.querySelectorAll("#buyButton")[0];
Kameleoon.API.Utils.addEventListener(buyButton, "mousedown", function () {
  Kameleoon.API.Products.trackAddToCart("myProductId", 19.99, 1, {
    stock: true, 
    recommended_code: 'some-unique-code', //consulte la tabla de argumentos para más información
    recommended_by: 'dynamic'//consulte la tabla de argumentos para más información
  });
});

Argumentos

Nombre	Tipo	Descripción
productID	String	Identificador único del producto. Este campo es obligatorio.
unitPrice	Number	Precio de una unidad del producto al que hace referencia productID. Este campo es opcional; si no lo especifica, Kameleoon usa el precio predeterminado del producto del feed de productos importado.
amount	Number	Cantidad total del producto tras la actualización del carrito. Use valores no incrementales. Por ejemplo, si el carrito contiene dos artículos con el mismo `productID` y añade otro, indique 3. Si elimina dos artículos de un carrito que contiene 20, indique 18.
parameters	Object	Parámetros para la plataforma de recomendaciones. Este campo es opcional.

Parámetros para la plataforma de recomendaciones

Nombre	Tipo	Descripción
recommended_by	String	Para SPAs o pop-ups, establezca este valor en “dynamic”. Este campo es obligatorio en escenarios específicos.
recommended_code	String	Para SPAs o pop-ups, proporcione el código único del widget que se encuentra en el atributo “data-recommender-code” de su cuenta.
stock	Boolean	Disponibilidad del producto. Este valor sobrescribe los datos de los feeds de productos o de las importaciones de catálogo. Este campo es opcional.

trackAddToWishList

El método trackAddToWishList() se ejecuta cuando un visitante añade o elimina un producto de la wish list o de favoritos.

Kameleoon.API.Products.trackAddToWishList("myProductId"); // para añadir a la wish list

Kameleoon.API.Products.trackAddToWishList("myProductId", -1); // para eliminar de la wish list

Nombre	Tipo	Descripción
productId	String	Identificador único del producto añadido a la wishlist. Este campo es obligatorio.
quantity	Number	Cantidad que se va a actualizar. Use valores negativos (por ejemplo, -1) para indicar eliminación. Si se omite, el método utiliza 1 por defecto.

trackCategoryView

El método trackCategoryView() se ejecuta para cada vista de página de categoría durante una sesión.

if (location.href.indexOf("productPage") != -1) {
  Kameleoon.API.Core.runWhenConditionTrue(function () {
    return typeof dataLayer != null;
  }, function () {
    dataLayer.forEach(function (map) {
      if (map.categoryID) {
        Kameleoon.API.Products.trackCategoryView(5);
      }
    });
  }, 200);
}

Argumentos

Nombre	Tipo	Descripción
categoryID	String	Identificador único de la categoría. Este campo es obligatorio.

trackProductView

El método trackProductView() se ejecuta para cada vista de producto durante una sesión. Este método permite a Kameleoon construir un catálogo de productos automatizado sin una integración de feed XML, lo que simplifica la configuración de proyectos de recomendación de productos.

Kameleoon.API.Products.trackProductView("myProductID", {
    "name": "productName",
    "categories": [{
        "id": "13",
        "name": "productCategory",
        "parent": null,
        "url": "website.com/category/2"
    }],
    "imageURL": "https://www.mywebsite/productImage.jpg",
    "price": 19.99,
   "oldPrice": 23.99,
    "accessories": ['productID1', 'productID2'],
    "available": true,
    "availableQuantity": 15,
    "brand": "productBrand",
    "groupId": "groupID1",
    "sku": "productSKU",
    "description": "This is a short description",
    "rating": 4,
    "model": "phone 14 128GB",
    "leftovers": "one",
    "tags": ["shirt", "red"],
    "typePrefix": "mobile phone",
    "seasonality": [1, 2, 3, 10, 11, 12],
    "priceMargin": 100,
    "isChild": false,
    "isNew": false,
    "isFashion": true,
    "auto": {
        "vds": ["BP8AN5", "HH5820"],
        "compatibility": [ 
            {
                "brand": "BMW"
            }, 
            { 
                "brand": "Mini", "model": "Cooper S" 
            } 
        ]
    },
    "fashion":  {
        "gender": "f",
        "type": "shoe",
        "sizes": ["37", "42"],
        "feature": "adult",
        "colors": [ 
            { 
                "color": "red" 
            }, 
            { 
                "color": "green", "picture": "https://example.com/items/395532-green.jpg" 
            }
        ]
    },
    "params": [
        {
            "name": "connectivity",
            "value": ["bluetooth", "wi-fi"]
        },
        {
            "name": "lengths",
            "value": ["4", "6", "8"],
            "unit": "cm"
        }
    ]
});

Argumentos

Nombre	Tipo	Descripción
productID	String	Identificador del producto. Use cualquier valor único que identifique este producto en particular. Este campo es obligatorio.
productData	Object	Objeto Product. Este campo es obligatorio para importar feeds de productos mediante el complemento Product Recommendation.

trackSearchQuery

El método trackSearchQuery() registra las consultas de búsqueda del usuario.

Kameleoon.API.Products.trackSearchQuery("Example search request");

Argumentos

Nombre	Tipo	Descripción
search_query	String	Valor de la consulta de búsqueda. Este campo es obligatorio.

trackTransaction

El método trackTransaction() se ejecuta cuando se produce una transacción o compra.

Kameleoon.API.Products.trackTransaction(
 [
  {
   "productID": "myProductID1",
   "quantity": 4
  },
  {
   "productID": "myProductID4564",
   "quantity": 1
  }
 ],
 {
  "order": "N318",
  "order_price": 29999
 }
);

Argumentos

Nombre	Tipo	Descripción
products	Array	Lista de objetos que contienen `productID` y `quantity` para cada producto de la transacción. Este campo es obligatorio.
params	Object	Parámetros adicionales para la plataforma de recomendaciones. Este campo es opcional.

Parámetros adicionales para trackTransaction

Nombre	Tipo	Descripción
order	string	Número de pedido de la tienda. Si lo omite, el motor utiliza un sistema interno de numeración, lo que impide la sincronización del estado del pedido. Consulte las descripciones de parámetros a continuación.
order_price	Number	Coste final del pedido, incluyendo descuentos, bonificaciones y servicios adicionales. Si lo omite, el motor calcula el coste a partir de la base de datos de productos sin descuentos ni servicios.
email	string	Correo electrónico del cliente.
phone	string	Número de teléfono del cliente.
promocode	string	Código promocional de la transacción.
order_cash	number	Importe pagado en efectivo.
order_bonuses	number	Importe pagado con bonificaciones.
order_delivery	number	Coste de envío.
order_discount	number	Importe del descuento del pedido.
delivery_type	string	Método de envío.
payment_type	string	Tipo de pago (por ejemplo, “cash”, “card”, “wire”).
tax_free	boolean	Estado de exención de impuestos.

APIs

​trackAddToCart

​Parámetros para la plataforma de recomendaciones

​trackAddToWishList

​trackCategoryView

​trackProductView

​trackSearchQuery

​trackTransaction

​Parámetros adicionales para trackTransaction

trackAddToCart

Parámetros para la plataforma de recomendaciones

trackAddToWishList

trackCategoryView

trackProductView

trackSearchQuery

trackTransaction

Parámetros adicionales para trackTransaction