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 KeyParameter NameTypeExampleDescription
ootb_session_idOOTB Session IDString"248rhdbuw2her1"Identifier for the user’s browser or app session. (Optional but useful for deduplication/sessionization)
ootb_cart_idOOTB Cart IDString"C-20244030X"Unique identifier assigned to the cart instance.
ootb_total_items_countOOTB Total Items CountNumber3Total number of distinct items in the cart.
ootb_total_cart_valueOOTB Total Cart ValueNumber92.5Aggregate cart value at time of event (includes all items and quantities).
ootb_currencyOOTB CurrencyString"USD"ISO currency code reflecting the store context.
ootb_item_name_0 to _6OOTB Item Name 0 to 6String"Wireless Mouse"Name of the product added to the cart, most granular (sku/variant) name.
ootb_item_image_0 to _6OOTB Item Image 0 to 6String"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 _6OOTB Item Quantity 0 to 6Number2Number of units for each item in the cart.
ootb_item_link_0 to _6OOTB Item Page URL 0 to 6String"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.