Items in Cart

An event that describes the current state of items in shopping cart.

Event Key

ootb_items_in_cart

This event should be sent periodically or during key interactions (e.g., session refresh, product page visit, scroll) to capture the current state of the user’s cart. This is useful for recovering carts or understanding intent, even if the user never checks out.

Event KeyEvent NameType
ootb_items_in_cartItems in CartSimple event

Event Structure

The mandatory properties (tenant, timestamp, event, and customer) are required for all events and documented in detail on the Mandatory Properties page. Below is the JSON structure for the context-specific properties of the Items in Cart event:

[
  {
    "context": {
        "ootb_session_id": "248rhdbuw2her1",
        "ootb_cart_id": "C-20244030X",
        "ootb_total_items_count": 3,
        "ootb_total_cart_value": 92.5,
        "ootb_currency": "USD",

        "ootb_item_name_0": "Wireless Mouse",
        "ootb_item_image_0": "https://example.com/images/wireless_mouse.jpg",
        "ootb_item_quantity_0": 1,
        "ootb_item_link_0": "https://example.com/product/wireless-mouse",

        "ootb_item_name_1": "Gaming Keyboard",
        "ootb_item_image_1": "https://example.com/images/gaming_keyboard.jpg",
        "ootb_item_quantity_1": 1,
        "ootb_item_link_1": "https://example.com/product/gaming-keyboard",

        "ootb_item_name_2": "USB-C Charging Cable",
        "ootb_item_image_2": "https://example.com/images/usb_c_cable.jpg",
        "ootb_item_quantity_2": 2,
        "ootb_item_link_2": "https://example.com/product/usb-c-cable"
    }
  }
]

Parameters

Parameter Key

Parameter Name

Type

Example

Description

ootb_session_id

OOTB Session ID

String

"248rhdbuw2her1"

Identifier for the user’s browser or app session. (Optional but useful for deduplication/sessionization)

ootb_cart_id

OOTB Cart ID

String

"C-20244030X"

Unique identifier assigned to the cart instance.

ootb_total_items_count

OOTB Total Items Count

Number

3

Total number of distinct items in the cart.

ootb_total_cart_value

OOTB Total Cart Value

Number

92.5

Aggregate cart value at time of event (includes all items and quantities).

ootb_currency

OOTB Currency

String

"USD"

ISO currency code reflecting the store context.

ootb_item_name_0 to _6

OOTB Item Name 0 to 6

String

"Wireless Mouse"

Name of the product added to the cart, most granular (sku/variant) name.

ootb_item_image_0 to _6

OOTB Item Image 0 to 6

String

"https://example.com/images/ wireless_mouse.jpg"

URL to the product or variant image. Used in remarketing emails, abandoned cart visuals, etc.

ootb_item_quantity_0 to _6

OOTB Item Quantity 0 to 6

Number

2

Number of units for each item in the cart.

ootb_item_link_0 to _6

OOTB Item Page URL 0 to 6

String

"https://example.com/product/ wireless-mouse"

Deep link to the product/variant page. Supports recovery and personalization campaigns.

Explanation

  • event: Set to ootb_items_in_cart to indicate a snapshot of the user’s shopping cart.
  • context:
    • ootb_session_id: Identifier for the user’s browser or app session.
    • ootb_cart_id, ootb_total_items_count, ootb_total_cart_value, ootb_currency: Core cart identifiers and metrics including total count and value.
    • ootb_item_name_0 to _6, ootb_item_image_0 to _6, ootb_item_quantity_0 to _6, ootb_item_link_0 to _6: Specific details for up to 7 items in the cart, allowing for precise product recommendations and personalization.