Mapp Intelligence enables detailed tracking of product interactions across the entire shopping journey.
Each product event is assigned a product status that defines the context in which a product is viewed or interacted with. This allows you to analyze user behavior from the first product impression to the final purchase.
Product Status
The following product statuses are supported in Mapp Intelligence:
Product Status | Description |
|---|---|
VIEW | Product viewed on a product detail page. |
BASKET | Product added to a shopping cart. |
ADD_TO_WISHLIST | Product added to a wishlist. |
DELETE_FROM_WISHLIST | Product removed from a wishlist. |
ADD_TO_CART | Product added to a shopping cart. |
DELETE_FROM_CART | Product removed from a shopping cart. |
CHECKOUT | Product moved to checkout. |
CONFIRMATION | Product purchased. |
Mapp Intelligence can automatically detect abandoned shopping carts when products are tracked with the relevant statuses, but no purchase confirmation follows.
Categories
Product categories define fixed classifications for products and enable structured analysis.
These groups must be configured in Mapp Q3 before being tracked via the library. Find more information here.
When implementing, include the ID number and the respective value as a string. The value should not exceed 255 characters; additional characters are truncated.
Note
Categories are assigned once to a product. If a product is tracked with a category, all subsequent product calls will also be assigned to this category. Only the first tracked value will be shown. Mapp therefore recommends implementing products and categories while embedding the library. See also How can I replace missing values ("-") in categories?
Parameters
E-Commerce Parameters enrich tracked product data with additional website-specific information or metrics.
They must be configured in Mapp Q3 before they can be tracked via the library. During setup, you define the data type (text or number) and other attributes for each parameter.
Mapp Intelligence provides a range of predefined E-Commerce Parameters for common product-related use cases, such as Product Sold Out, Product on Sale, and Category. Alternatively, you can create custom E-Commerce Parameters to capture completely individual product information — for example, product size, color, brand, or campaign-specific attributes.
For detailed setup instructions and a full overview of predefined parameters, see How to set up custom parameters.
Method | Description | Where to configure * |
|---|---|---|
constructor | Initializes a product object. A product ID is required and may not exceed 110 characters. | – |
setId | Defines the unique product identifier (e.g. SKU or article number). Required for all product measurements. | – |
setCost | Sets the total price of the product. “0” values are allowed. For multiple quantities, use the total price, not the unit price. | – |
setQuantity | Defines the quantity of the product. | – |
setStatus | Defines the product status. The following values are supported:
| – |
setSoldOut | Indicates whether the product is sold out (true) or in stock (false). | EP > Product sold out |
setParameter | Adds product-specific parameters to enrich tracking data. | EP > Own Configuration |
setCategory | Assigns a product category for structured grouping and analysis. | PC > New Category |
* Configuration Path Abbreviations:
EP = Mapp Q3 > Configuration > Custom Parameters > E-Commerce Parameters > Preconfigured > …
PC = Mapp Q3 > Configuration > Categorization > Product Categories > …
constructor
const mappProductData = new MappIntelligenceProduct();/**
* @param i Saves products placed in the shopping cart. This property must be entered if products are to be
* measured. A product ID may not contain more than 110 characters
*/
const mappProductData = new MappIntelligenceProduct(i: string);setId
/**
* @param i Saves products placed in the shopping cart. This property must be entered if products are to be
* measured. A product ID may not contain more than 110 characters
*
* @return MappIntelligenceProduct
*/
mappProductData.setId(i: string);setCost
/**
* @param c Contains the product price ("0" prices are allowed). If you transmit a product several times
* (quantity property greater than 1), use the total price not the unit price
*
* @return MappIntelligenceProduct
*/
mappProductData.setCost(c: number);setQuantity
/**
* @param q Contains the product quantity
*
* @return MappIntelligenceProduct
*/
mappProductData.setQuantity(q: number);setStatus
/**
* @param s Contains states of your product (VIEW, BASKET, CONFIRMATION)
*
* @return MappIntelligenceProduct
*/
mappProductData.setStatus(s: string);setSoldOut
/**
* @param sOut Use this to transmit the product is sold out or in stock (sold out = true, in stock = false)
*
* @return MappIntelligenceProduct
*/
mappProductData.setSoldOut(sOut: boolean);setParameter
/**
* You can use parameters to enrich analytical data with your own website-specific information and/or metrics.
*
* @param i ID of the parameter
* @param v Value of the parameter
*
* @return MappIntelligenceProduct
*/
mappProductData.setParameter(i: number, v: string);setCategory
/**
* Product categories allow the grouping of products.
*
* @param i ID of the parameter
* @param v Value of the parameter
*
* @return MappIntelligenceProduct
*/
mappProductData.setCategory(i: number, v: string);const mic = new MappIntelligenceConfig(
"111111111111111",
"analytics01.wt-eu02.net"
);
const mit = new MappIntelligenceTracking(mic);
const mappProductData = new MappIntelligenceProduct();
mappCustomerData.setId("id of a product")
.setCost(19.95)
.setQuantity(5)
.setStatus(MappIntelligenceProduct.VIEW)
.setSoldOut(true)
.setParameter(2, "parameter 2")
.setParameter(15, "parameter 15")
.setCategory(2, "category 2")
.setCategory(15, "category 15");
const mappProductCollection = new MappIntelligenceProductCollection();
mappProductCollection.add(mappProductData);
mit.track((new MappIntelligenceDataMap()).product(mappProductCollection));