1 Overview
This page explains how to track order data in Mapp Intelligence. Orders represent completed transactions and include total order value and other order-specific attributes such as coupon values, shipping costs, and payment methods.
Order data can be analyzed under E-Commerce > Orders.
Note: If no order value is transmitted, the order will not be tracked.
2 Configurable Properties
The following table outlines all supported order properties, their descriptions, and request parameters.
Property | Description | Data Type | Request Parameter |
|---|---|---|---|
value | Total order value. Required. Without this value, no order is tracked. Use a dot or comma as decimal separator. No thousands separator allowed. | Number |
|
id | Unique identifier for the order. Prevents double counting. Optional. | String |
|
currency | ISO code of the currency (e.g., "USD") for the order. This value is only passed for currency conversion. The order value will be converted into the default currency defined in your system configuration ({{glossary.Int: Mapp Q3}} > Configuration > System Configuration > Data Collection). | String |
|
couponValue | Value of the applied coupon. | Number |
|
paymentMethod | Payment method used for the order. | String |
|
shippingService | Shipping provider used for the order. | String |
|
shippingSpeed | Shipping speed chosen for the order. | String |
|
shippingCosts | Shipping cost for the order. | Number |
|
grossMargin | Margin or markup of the order. | Number |
|
orderStatus | Status of the order (e.g., confirmed, cancelled). | String |
|
productSoldOut | Flag indicating whether a product in the order is out of stock. | Boolean |
|
tax | Tax amount. | Number |
|
parameter | Custom order-specific parameters. See below. | Object |
|
2.1 Parameters
Order parameters can be used to enrich tracked order data with additional information such as shipping or payment type.
Mapp Intelligence provides a set of predefined E-Commerce parameters, including the ones listed above (e.g., paymentMethod, shippingCosts). These predefined parameters must be set up in Configuration > Custom Parameters > ECommerce Parameter before use. During setup, the ID (used for the request parameter) and data type (text or number) are defined.
Custom parameters are supported as well. You can use any available ID (e.g., cb45) and assign a value depending on your needs. If you transmit multiple custom parameters, each must use a unique ID.
Values can be analyzed in E-Commerce > E-Commerce Parameters if they are of type text, or as metrics if they are of type number.
For setup instructions: How to Set Up Custom Parameters
3 Implementation Example
import { WebtrekkSmartPixelReact, WebtrekkOrderData } from "@webtrekk-smart-pixel/react";import { WebtrekkSmartPixelReact, WebtrekkOrderData } from "@webtrekk-smart-pixel/next";If you do not have automatic page tracking enabled, invoke the track method after adding all relevant tracking information.
WebtrekkSmartPixelReact.order({
value: 120.99,
id: "M-12345",
couponValue: 10.00,
paymentMethod: "paypal",
shippingService: "dhl",
shippingSpeed: "express",
shippingCosts: 4.95,
grossMargin: 12.95,
parameter: {5: "bill"}
});If you do not have automatic page tracking enabled, invoke the track method after adding all relevant tracking information.
render()
{
return (
<div>
<WebtrekkOrderData
value={ 120.99 }
id="M-12345"
couponValue={ 10.00 }
paymentMethod="paypal"
shippingService="dhl"
shippingSpeed="express"
shippingCosts={ 4.95 }
grossMargin={ 12.95 }
parameter={ {5: "bill"} }
/>
</div>
);
}