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 in the Smart Pixel documentation.
Field Definitions
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Basket Status |
| Current status of the shopping basket. See Basket Status Values below for the full list of supported values. |
| Note that the basket status of the raw data stream contains the additional state |
Basket Item Quantity |
| Amount of this item that exists on the basket. |
| 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 |
| Price of each unit of this item. |
| - |
Basket Item Product |
| Product information on this item (see product information below). |
| The order of the articles in the list indicates the basket position of this article. |
Basket Item Rank |
| Contains the item rank (position) in the shopping cart/basket. |
|
|
Basket Item Product List Position |
| Contains the product list position of the item in the basket. |
|
|
Product (Text) Parameters |
| Parameters for the basket if available. |
| 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 |
| Parameters for the basket if available. |
| 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 |
| The name of a product. |
| Custom stream contain up to 25 items only. Root Stream: available as a nested array structure Custom Stream: X starts at 1 |
Product URL |
| The URL to the product. |
| - |
Product (Text) Categories |
| Categories for the product. |
| Available for known products only (at latest beginning from the next day). |
Product (Numeric) Categories |
| Categories for the product. |
| - |
Product (Text) Parameters |
| Parameters for the product. |
| - |
Product (Numeric) Parameters |
| Parameters for the product. |
| - |
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 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 |
|
|
| |||
Basket Item Quantity |
|
|
| |||
Basket Item Price |
|
|
| |||
Basket Item Product |
|
|
| |||
Basket Item Rank |
|
|
| |||
Basket Item Product List Position |
|
|
| |||
Product (Text) Parameters |
|
|
| |||
Product (Numeric) Parameters |
|
|
| |||
Product Name |
|
|
| |||
Product URL |
|
|
| |||
Product (Text) Categories |
| n/a | n/a | |||
Product (Numeric) Categories |
| n/a | n/a | |||
Product (Text) Parameters |
|
|
| |||
Product (Numeric) Parameters |
|
|
|
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 |
|---|---|
| Product viewed on a product detail page. |
| Product viewed in a product list (category, search-result, or similar list view). The position within the list is transported separately in the |
| Product added to the shopping basket. |
| Product removed from the shopping basket. |
| Product is in the checkout step (between basket and order confirmation). |
| Order confirmation — the product was purchased. |
| Product added to the wishlist. |
| Product removed from the wishlist. |
| A product inside a recommendation slot was rendered. Only generated when the Recommendation Tracking extension is implemented. |
| A product inside a recommendation slot was clicked. Only generated when the Recommendation Tracking extension is implemented. |
| Internal fallback value used when no recognized status was supplied with the request. |
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,display-reco). In the Raw Data ExportgetFullBaskettable, the same statuses are represented as a numericSTATEcode covering values0–7(see Contents of Raw Data Tables) —Display-Reco,Click-Reco, andUndefinedare not represented in theSTATEmapping.
Related
Product (Smart Pixel) — how to send product tracking data via the Smart Pixel.
Contents of Raw Data Tables — where product data appears in the Raw Data Export (see
getFullBasketand related tables).