--- title: "Product" slug: "record-contents-product" description: "Explore product tracking data, including basket interactions and wishlist actions, with detailed field definitions and mapping for optimal e-commerce insights." tags: ["Product Tracking", "E-Commerce Parameters", "Basket Interactions"] updated: 2026-09-24T09:56:57Z published: 2026-09-24T09:56:57Z canonical: "docs.mapp.com/record-contents-product" --- > ## 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. # Product ## Overview This page lists every record-content field captured for product-related events — basket interactions, wishlist actions, and recommendation events. All field names below match the technical record schema (e.g. `basket.status`, `basket.items[X].quantity`). For the sender-side perspective — how product tracking data is transmitted via Tag Integration / Smart Pixel — see [Product](https://docs.mapp.com/docs/product) in the Smart Pixel documentation. When a request contains more product-related E-Commerce parameter values than products, Data Streams injects placeholder products to carry those values. Each placeholder product has a `name` of "-", a `quantity` of 0, and a `price` of 0.0. The related parameter values are attached under `parameters`. This also occurs when product-related E-Commerce parameters are sent without any products. Consumers reading the basket should expect these placeholder items. --- ## Field Definitions | Name / Object | Key on Record | Description | Format | Comment | | --- | --- | --- | --- | --- | | Basket Status | `basket.status` | Current status of the shopping basket. See [Basket Status Values](/docs/record-contents-product#basket-status-values) below for the full list of supported values. | `String` | Note that the basket status of the raw data stream contains the additional state `list` (this is not included in the raw data export). | | Basket Item Quantity | `basket.items[X].quantity` | Amount of this item that exists on the basket. | `Integer` | Custom stream contain up to 25 items only. Root Stream: available as a nested array structure Custom Stream: X starts at 1 | | Basket Item Price | `basket.items[X].price` | Price of each unit of this item. | `Double` | - | | Basket Item Product | `basket.items[X].product` | Product information on this item (see product information below). | `Product` | The order of the articles in the list indicates the basket position of this article. | | Basket Item Rank | `basket.items[X].rank` | Contains the item rank (position) in the shopping cart/basket. | `Integer` | | | Basket Item Product List Position | `basket.items[X].listPosition` | Contains the product list position of the item in the basket. | `Integer` | | | Product (Text) Parameters | `basket.parameters.textValues` | Parameters for the basket if available. | `Map<String, TextParameter>` | Note that product parameters are provided in a single file in the RDE. In Data Streams those are separated as Product Parameters with single values relate to the basket and not the Product. | | Product (Numeric) Parameters | `basket.parameters.numericValues` | Parameters for the basket if available. | `Map<String, NumericParameter>` | Note that product parameters are provided in a single file in the RDE. In Data Streams those are separated as Product Parameters with single values relate to the basket and not the Product. | | Product Name | `basket.items[X].product.name` | The name of a product. | `String` | Custom stream contain up to 25 items only. Root Stream: available as a nested array structure Custom Stream: X starts at 1 | | Product URL | `basket.items[X].product.url` | The URL to the product. | `String` | - | | Product (Text) Categories | `basket.items[X].product.categories.textValues` | Categories for the product. | `Map<String, TextCategory>` | Available for known products only (at latest beginning from the next day). | | Product (Numeric) Categories | `basket.items[X].product.categories.numericValues` | Categories for the product. | `Map<String, NumericCategory>` | - | | Product (Text) Parameters | `basket.items[X].product.parameters.textValues` | Parameters for the product. | `Map<String, TextParameter>` | - | | Product (Numeric) Parameters | `basket.items[X].product.parameters.numericValues` | Parameters for the product. | `Map<String, NumericParameter>` | - | --- ## Stream and Export Mapping The same fields, mapped to their availability in the Root Stream, Custom Streams, the current Raw Data Export, and the Classic Raw Data Export. Use the **Name / Object** column to cross-reference rows with [Field Definitions](/docs/record-contents-product#field-definitions) above. | Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export | | --- | --- | --- | --- | --- | --- | --- | | Basket Status | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_status` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullBasket` | `state` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Basket Item Quantity | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_quantity` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullBasket` | `quantity` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Basket Item Price | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_price` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullBasket` | `price` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Basket Item Product | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_product` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullBasket` | `bas_pos` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Basket Item Rank | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_rank` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Basket Item Product List Position | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_listPosition` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Product (Text) Parameters | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_parameters_textValues` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullCustParaProduct_X` | `cust_para_string_y`, `cust_para_generic_y` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Product (Numeric) Parameters | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_parameters_numericValues` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullCustParaProduct_X` | `cust_para_number_y` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Product Name | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_product_name` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullBasket` | `product` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Product URL | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_product_url` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullBasket` | `product` | ![(minus)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/4f4fd72c-b33e-485c-b8e4-fee5dc27e86a.svg) | | Product (Text) Categories | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_product_categories_textValues` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | n/a | n/a | ![(minus)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/4f4fd72c-b33e-485c-b8e4-fee5dc27e86a.svg) | | Product (Numeric) Categories | ![(minus)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/4f4fd72c-b33e-485c-b8e4-fee5dc27e86a.svg) | `basket_items_X_product_categories_numericValues` | ![(minus)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/4f4fd72c-b33e-485c-b8e4-fee5dc27e86a.svg) | n/a | n/a | ![(minus)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/4f4fd72c-b33e-485c-b8e4-fee5dc27e86a.svg) | | Product (Text) Parameters | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_product_parameters_textValues` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullCustParaProduct_X` | `cust_para_string_y`, `cust_para_generic_y` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | | Product (Numeric) Parameters | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `basket_items_X_product_parameters_numericValues` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | `getFullCustParaProduct_X` | `cust_para_number_y` | ![(tick)](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/ee01671e-a518-4536-a724-dc6a266867f2.svg) | --- ## Basket Status Values The `basket.status` field can take one of the following values. The same status is also exposed as a numeric `STATE` code in the Raw Data Export. | API Value | Description | | --- | --- | | `View` | Product viewed on a product detail page. | | `List` | Product viewed in a product list (category, search-result, or similar list view). The position within the list is transported separately in the `LIST_POS` field. | | `Add` | Product added to the shopping basket. | | `Del` | Product removed from the shopping basket. | | `Checkout` | Product is in the checkout step (between basket and order confirmation). | | `Conf` | Order confirmation — the product was purchased. | | `Add-Wl` | Product added to the wishlist. | | `Del-Wl` | Product removed from the wishlist. | | `Loaded-Reco` | A product inside a recommendation slot was visible in the visitor's viewport long enough to count as seen, by default completely visible for one second. | | `Viewable-Reco` | A product inside a recommendation slot was completely visible in the visitor's viewport for at least one second. Only generated when the Recommendation Tracking extension is implemented. | | `Click-Reco` | A product inside a recommendation slot was clicked. Only generated when the Recommendation Tracking extension is implemented. | | `Undefined` | Internal fallback value used when no recognized status was supplied with the request. | > [!NOTE] > Note > > The values above are the API representation used in record contents. When sending tracking data via Tag Integration / Smart Pixel, the same statuses are transmitted as lowercase strings (e.g. `add`, `del-wl`, `loaded-reco`). In the Raw Data Export `getFullBasket` table, the same statuses are represented as a numeric `STATE` code covering values `0`–`7` (see [Contents of Raw Data Tables](https://docs.mapp.com/docs/contents-of-raw-data-tables)) — `Loaded-Reco`, `Viewable-Reco`, `Click-Reco, `and `Undefined` are not represented in the `STATE` mapping. --- ## Related - [Product](https://docs.mapp.com/docs/product) (Smart Pixel) — how to send product tracking data via the Smart Pixel. - [Contents of Raw Data Tables](https://docs.mapp.com/docs/contents-of-raw-data-tables) — where product data appears in the Raw Data Export (see `getFullBasket` and related tables). ## Related - [Contents of Raw Data Tables](/contents-of-raw-data-tables.md) - [Events](/record-contents-action.md)