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

wts.push(["product", "pullover;jeans"]);
JS

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

wts.push(["productCost", "99.90;69.95"]);
JS

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

wts.push(["productQuantity", "2;1"]);
JS

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'.

And, if a product is deleted from the wishlist the status is 'del-wl'.


Manual tracking

wts.push(["productStatus", "conf"]);
JS

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

wts.push(["currency", "EUR"]);
JS

Total order value

Contains the total order value. This parameter generates an order.


Manual tracking

wts.push(["orderValue", "12.99"]);
JS

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 to import information on a single order. For example, to import return data.


Manual tracking

wts.push(["orderId", "M-12345"]);
JS

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 dropdown list one of the predefined parameters, which are used for E-Commerce tracking tracking:

    • Payment method
    • Shipper
    • Shipping speed
    • Shipping costs
    • Margin/mark-up
    • Order status
    • Product variant
    • Voucher value
    • Product sold out



  3. Click Save to save your settings.


Predefined product information value

Choose the Tag Integration parameter than 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

wts.push(["couponValue", "10.00"]);
JS

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.

Depending on the setup, E-Commerce parameters refer to a product or to an order. Learn more about it in the FAQ.


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.


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.


Manual tracking

wts.push(["customEcommerceParameter", {
	1: "L;32",
	2: "green;blue",
	3: "invoice"
};
JS

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


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.



  3. Click New Category. The specification dialog for product categories opens.



  4. Specify the parameters as needed. Find additional information here.

  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.


Manual tracking

wts.push(["productCategory", {
	1: "outer clothing;trousers",
	2: "noname;levis"
}]);
JS