--- title: "Products" slug: "configuration-mapp-intelligence-plugin-products" description: "Track products and orders efficiently with Mapp Q3. Learn to manage product details, statuses, and e-commerce parameters for optimal performance." tags: ["Product Tracking", "Order Tracking", "E Commerce Parameters"] updated: 2026-09-21T16:24:12Z published: 2026-09-21T16:24:12Z canonical: "docs.mapp.com/configuration-mapp-intelligence-plugin-products" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.mapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Products This section includes both product and order tracking. ## Settings ### Product name or ID The name of the product. Using the product ID as a name is recommanded if you want to import additional product information via product categories. If you send multiple products, they have to be separated by a semicolon. A product name may not contain more than 110 characters. **Manual tracking** ```plaintext wts.push(["product", "pullover;jeans"]); ``` ### Product costs -Optional- Contains the product price (0 prices are allowed). If you transmit a product several times (quantity parameter productquantity greater than 1), use the total price not the unit price. If several prices are transmitted, they are each separated by a semicolon. The default value is 0. **Manual tracking** ```plaintext wts.push(["productCost", "99.90;69.95"]); ``` ### Product quantity -Optional- Contains the product quantity. If several products are transmitted, they are each separated by a semicolon. The default value is 1. **Manual tracking** ```plaintext wts.push(["productQuantity", "2;1"]); ``` ### Product Status -Optional- Contains the status of a product. If a product is viewed (e.g. on a product’s detailed view), the status is "view". This status should always be set if the product can be placed in the shopping cart. - If a product has been placed in the shopping cart, the status is '**add**' - If the shopping basket is purchased, the status is '**conf**' - If a product is removed from the cart, the status is '**del**' - If a product is in checkout, the status is '**checkout**' - If a product is added to a wishlist, the status is '**add-wl**' - If a product is deleted from the wishlist, the status is '**del-wl**' - If a product is loaded in a [recommendation](/v1/docs/recommendation-tracking-plugin-intelligence), the status is '**loaded-reco**' - If a product becomes viewable in a [recommendation](/v1/docs/recommendation-tracking-plugin-intelligence), the status is '**viewable-reco**' - And if a product is clicked in a [recommendation](/v1/docs/recommendation-tracking-plugin-intelligence), the status is '**click-reco**' **Manual tracking** ```plaintext wts.push(["productStatus", "conf"]); ``` ### Currency -Optional- Contains the currency code of a product or order; the value must be passed to the Mapp Intelligence pixel in line with the ISO standard. If multiple products are transmitted (e.g. on the order confirmation page if more than one product was purchased), only one currency will be applied to all products. **Manual tracking** ```plaintext wts.push(["currency", "EUR"]); ``` ### Total order value Contains the total order value. This parameter generates an order. **Manual tracking** ```plaintext wts.push(["orderValue", "12.99"]); ``` ### Order ID -Optional- The parameter contains a unique order number (order ID). This ensures that no orders are counted twice. If no order ID has been given for a total order value, Mapp will generate an ID. Also, it allows the import of information in a single order. For example, to import [return data](/v1/docs/import-return-data-to-analyze-shopping-behavior-in-detail). **Manual tracking** ```plaintext wts.push(["orderId", "M-12345"]); ``` ### Predefined product information -Optional- With the help of predefined e-commerce parameters, you add insights to product and order analyses. **Predefined product information** Add the parameters that are set up in Mapp Q3 **Creating Parameters in Mapp Q3** To create these parameters, proceed as follows: 1. Log in to your Mapp Q3 account and go to *Configuration > Custom Parameters > E-Commerce Parameter > Create new custom parameter.* 2. Add **title** and select from the **preconfigured** drop-down list one of the predefined parameters, which are used for E-Commerce tracking tracking: ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/f692a11d-e89d-4816-a718-85f6b86e3fd2.png) - Payment method - Shipper - Shipping speed - Shipping costs - Margin/mark-up - Order status - Voucher value - Product sold out 3. Click **Save** to save your settings. **Predefined product information value** Choose the Tag Integration parameter that contains the value you want to use. **Page area** Choose the Tag Integration rule that defines when the predefined parameter should be passed. **Manual tracking** ```plaintext wts.push(["couponValue", "10.00"]); ``` ### E-Commerce parameter -Optional- Products, as well as orders, can be supplemented by any additional information through e-commerce parameters. In contrast to product categories, the relationship between the product/order and the e-commerce parameter does not have to be unique. Learn more about it in the [FAQ](/v1/docs/whats-the-difference-between-product-categories-and-e-commerce-parameters). Depending on the setup, E-Commerce parameters refer to a product or an order. Learn more about it in the [FAQ](/v1/docs/what-is-the-difference-between-single-value-and-several-values-when-setting-up-custom-parameters). Also, you can track website goals with E-Commerce parameters. In this case, you don't have to send any other product information. Learn more in our [How-To](/v1/docs/how-to-define-website-goals). **Examples for E-Commerce Parameter** | Product-related | - Product aspects (number, type) - Product characteristics (size, color, availability) | | --- | --- | | Order-related | - Payment method (cash, credit card, PayPal, etc.) - Shipping method - Vouchers - Discount value and granted discount | | Website targets | - Newsletter subscription - Account creation - Successful use of search or help - View a video - Use of other website functions | Note, that you have to set up the parameter in Mapp Q3, too. [Find more information here.](/v1/docs/how-to-set-up-custom-parameters) **Manual tracking** ```plaintext wts.push(["customEcommerceParameter", { 1: "L;32", 2: "green;blue", 3: "invoice" }; ``` ### Product categories -Optional- Product categories contain static information about the products. They allow you to group the products by assigning them uniquely to a product and product category. **Example Product Categories** - Product name - Main product category - Sub product category > [!NOTE] > Product categories are read only on the first request of a product. Thus, we recommand to integrate both product name and product category at the same time. **Creating Product Categories in Mapp Q3** To create a new product category, proceed as follows: 1. Log in to your Q3 account. 2. Go to *Configuration > Categories > Product categories*. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/3136f9dd-fc93-4e5c-895b-fb45f8fb7235.png) 3. Click **New Category**. The specification dialog for product categories opens. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/0cc80477-483b-4c81-ae10-a0bcc4da7263.png) 4. Specify the parameters as needed. Find additional information [here](/v1/docs/how-to-set-up-categories). 5. Click **Save** to save your settings. In contrast to product categories, the relationship between the product/order and the e-commerce parameter does not have to be unique. Learn more about it in the [FAQ](/v1/docs/whats-the-difference-between-product-categories-and-e-commerce-parameters). **Manual tracking** ```plaintext wts.push(["productCategory", { 1: "outer clothing;trousers", 2: "noname;levis" }]); ``` ## Related - [Product](/product-data-object-java-library-s2s.md) - [Product](/product-1.md) - [Visitor](/visitor.md)