Skip to main content

Cart Viewed

When to Use​

This event should be triggered when a visitor views their shopping cart, providing insights into cart composition and user shopping behavior.

Cart Page Navigation
When a visitor navigates to the dedicated shopping cart page to review their selected items.

Cart Modal/Drawer
When the shopping cart is displayed in a modal, sidebar, or dropdown overlay showing cart contents.

Checkout Funnel Entry
When the cart is viewed as part of the checkout process or before proceeding to checkout.

Complete Reference​

event object required

name string required

info

Use only static value cart_viewed for `event.name'.

name: "cart_viewed"

value number required

info

Event value in decimal format.

Represent the total value of all products currently in cart.

value: 123.99

currency string required

info

Currency code that specifies the currency in which all monetary values from any object associated with this event are expressed.

Note: This value can be overridden in nested objects if they contain their own value key with a currency specified.

currency: "USD"

exchange_rate number

info

Custom exchange rate for multi-currency. Default has value 1.

Note: This value can be overridden in nested objects if they contain their own value key with a currency specified.

exchange_rate: 1

id string recommended

info

Event ID — required for any actions that require deduplication or uniqueness. Represents the unique identifier of an action ID used in your system.

id: "UNIQUE_ACTION_ID_123"

context object

info

Use only if exists new data. View complete Context Object documentation

url string required-if-applicable

info

Complete URL of the current page including all parameters

SPA Applications: context.url is particularly valuable for Single Page Applications where URL changes don’t automatically trigger page context updates. Manual implementation ensures accurate tracking of page transitions and user navigation within SPA frameworks.

url:"https://shop.example.com/products/laptop?color=silver&storage=512gb&utm_source=google"
warning

URL Parameter Sensitivity: Be mindful of sensitive information in URLs. Query parameters may contain personal identifiers, session tokens, or private information that should be handled according to privacy regulations.

page_type string recommended

info

Type of page (product, home ...)

page_type: "product"

environment string recommended

info

Allowed values: prod, dev

environment: "prod"

products array required

info

An array containing all products currently in the shopping cart. View complete Product Object documentation

products[0] object required

id string required

info

Unique product identifier in your system.

id: "PRODUCT_ID"

parent_id string required

info

Parent product ID for variants or child products (can be same as id if no parent concept exists).

parent_id: "PRODUCT_PARENT_ID"

name string required

info

Product name or title displayed to users.

name: "PRODUCT_NAME"

parent_name string

info

Parent product name for variants or child products

parent_name: "PRODUCT_PARENT_NAME"

price_base number required

info

Original or base price before discounts (decimal format: 299.99)

price_base: 120.99

price number required

info

Current selling price after discounts (decimal format: 249.99)

price: 100.99

tax_included boolean required

info

Whether the price includes taxes (true/false)

tax_included: true

tax_percent number required

info

Tax percentage applied to the product (0-100)

tax_percent: 21

quantity number required

info

Quantity of this product in the context of the event

quantity: 1

category string required

info

Main product category name

category: "PRODUCT_MAIN_CATEGORY_NAME"

sku string

info

Product SKU (Stock Keeping Unit) for inventory tracking

sku: "PRODUCT_SKU"

parent_sku string

info

Parent product SKU for variants or child products

parent_sku: "PRODUCT_PARENT_SKU"

gtin string

info

Global Trade Item Number for product identification

gtin: "PRODUCT_GTIN"

mpn string

info

Manufacturer Part Number assigned by the manufacturer

mpn: "PRODUCT_MPN"

ean string

info

European Article Number for product barcoding

ean: "PRODUCT_EAN"

brand string

info

Product brand or manufacturer name

brand: "PRODUCT_BRAND"

type string

info

Product type: "simple", "variable", "virtual", "bundle", "subscription", "external".

Default: simple.

type: "simple"

stock_status boolean recommended

info

Product availability status (true = in stock, false = out of stock)

stock_status: true

stock_location string

info

Physical location or warehouse where product is stored

stock_location: "WAREHOUSE_NAME"

created_at string recommended

info

Timestamp when product was added to inventory (milliseconds)

created_at: 1754926521690

url string

info

Direct URL to the product page

url: "https://shop.example.com/products/laptop-page"

parent_url string

info

URL to the parent product page (for variants)

parent_url: "https://shop.example.com/products/laptop-page"

image string

info

Main product image URL

image: "https://cdn.example.com/products/laptop-image.jpg"

images array

info

Array of additional product image URLs

images: [
  "https://cdn.example.com/products/laptop-image-1.jpg",
  "https://cdn.example.com/products/laptop-image-2.jpg",
]

categories array

info

Array of category objects with name and id properties

  • name (string, required) - Category name
  • id (string) - Category identifier
categories: [
  {
    name: "PRODUCT_FIRST_CATEGORY_NAME",
    id: "1111"
  },
  {
    name: "PRODUCT_SECOND_CATEGORY_NAME",
    id: "1111"
  }
]

coupons array

info

Array of product-level coupons applied to this product. View complete Coupon Object documentation

coupons[0] (object) - required

name string required

info

Coupon name or code.

name: "FREE SHIPPING"

value number recommended

info

Coupon discount value.

value: 123.99

tax_included boolean recommended

info

Whether coupon value includes taxes

tax_included: true

tax_precent string recommended

info

Tax percentage for the coupon

tax_precent: 21

id string

info

Coupon internal identifier.

id: "COUPON_INTERNAL_ID"

type string

info

Coupon type (e.g., "LOYALTY", "SEASONAL", "FIRST_ORDER")

type: "SHIPPING"

currency string required-if-applicable

info

Currency code. Specifies the currency code when it differs from event.currency.

currency: "USD"

exchange_rate number

info

Custom exchange rate for multi-currency. Default has value 1. Specifies when it differs from event.exchange_rate.

exchange_rate: 1

properties object recommended

info

Custom product attributes for audience segmentation. Use custom properties that match your product catalog and business needs.

  • color (string|array) - Product color(s): "blue" or ["blue", "navy"]
  • size (string) - Product size: "S", "M", "L", "XL"
  • material (string|array) - Product material(s): "cotton" or ["cotton", "polyester"]
  • connectivity (string|array) - Connection types: "wireless" or ["wifi", "bluetooth"]
  • storage (string) - Storage capacity: "256GB", "512GB"
  • dimensions (string) - Physical dimensions: "120x60x75cm"
Product Segmentation

Use the properties object to store custom product attributes, with property names defined by each business as needed, that enable advanced segmentation, personalization, and analytics across your marketing campaigns.

properties: {
  color: "space_gray",
  storage: "256GB", 
  memory: "16GB",
  connectivity: ["wifi", "bluetooth"],
  warranty: "2_years",
  energy_rating: "A++",
  brand_series: "pro_line"
  }

currency string required-if-applicable

info

Currency code. Specifies the currency code when it differs from event.currency.

currency: "USD"

exchange_rate number

info

Custom exchange rate for multi-currency. Default has value 1. Specifies when it differs from event.exchange_rate.

exchange_rate: 1

coupons array

info

An array containing details of the coupons associated with the event. View complete Coupon Object documentation

coupons[0] object required

name string required

info

Coupon name or code.

name: "FREE SHIPPING"

value number recommended

info

Coupon discount value.

value: 123.99

tax_included boolean recommended

info

Whether coupon value includes taxes

tax_included: true

tax_precent string recommended

info

Tax percentage for the coupon

tax_precent: 21

id string

info

Coupon internal identifier.

id: "COUPON_INTERNAL_ID"

type string

info

Coupon type (e.g., "LOYALTY", "SEASONAL", "FIRST_ORDER")

type: "SHIPPING"

currency string required-if-applicable

info

Currency code. Specifies the currency code when it differs from event.currency.

currency: "USD"

exchange_rate number

info

Custom exchange rate for multi-currency. Default has value 1. Specifies when it differs from event.exchange_rate.

exchange_rate: 1

user object recommended

info
View complete User Object documentation

id string recommended

info

Unique customer identifier in your system.

id: "CUSTOMER_INTERNAL_ID"

email string|array recommended

info

Customer email address(es) provided in plaintext or as SHA-256 hashed values.

email: "[email protected]" 
// or
email: ["[email protected]", "[email protected]"]
// or
email: ["3e1ufd1rdnh8l1rfz6xlreyw2yryd4zrf8zsk1pxh2x8wbsp2mw1g93rs5nx68dq"]

phone string|array recommended

info

Customer phone number(s) in E.164 format (plaintext) or as SHA-256 hashed values.

phone: "+40712345678"
// or
phone: ["+40712345678", "+4079876543"]
// or
phone: ["unw5r66oikql4n4tlg2c54bkd2npephsbwwhxuoxreu6ph8uv6k424y9x15opy9y"]

first_name string recommended

info

Customer first name

first_name: "John"

last_name string recommended

info

Customer last name

last_name: "Doe"

country string

info

Country name or ISO country code

country: "Romania"

region string recommended

info

State, province, or region name

region: "Bucuresti"

city string recommended

info

City or locality name

city: "Bucuresti"

street string

info

Street address including number

street: "Strada Principala 1"

postal_code string

info

Postal code or ZIP code

postal_code: "700000"

orders_total_number number recommended

info

Cumulative number of orders placed by this user

orders_total_number: 5

orders_canceled_number number recommended

info

Cumulative number of orders placed and canceled by this user

orders_canceled_number: 0

orders_total_value number recommended

info

Cumulative lifetime user orders value (decimal format: 2500.50)

orders_total_value: 1234.99

orders_refunded_value number recommended

info

Cumulative lifetime user orders value canceled (decimal format: 2500.50)

orders_refunded_value: 250.99

predicted_value number

info

Predicted lifetime value of a customer for your business

predicted_value: 100.99

created_at number recommended

info

Timestamp in milliseconds since Unix epoch representing the first time the user was recorded

created_at: 1754926521690

properties object recommended

info

Custom Customer Properties Examples

User Segmentation

Use the properties object to store custom user attributes, with property names defined by each business as needed, that enable advanced segmentation, personalization, and analytics across your marketing campaigns.

properties: {
  customer_type: "returning",
  membership_level: "platinum",
  preferred_category: ["electronics", "fashion"],
  last_purchase_date: "2024-12-15",
  average_order_value: "350.00",
  payment_method_preference: "card",
  registration_date: "2023-06-15"
}

Object Examples​

These examples demonstrate the complete data object structure for the cart_viewed event. Use the complete example for detailed implementations or the minimal example for quick integrations.

{
  "event": {
    "name": "cart_viewed",
    "value": 1349.97,
    "currency": "USD",
    "exchange_rate": 1,
    "id": "CART_VIEW_789123",
    "properties": {
      "cart_view_source": "cart_page",
      "cart_items_count": 3,
      "cart_unique_products": 3,
      "cart_total_quantity": 4,
      "average_item_value": 449.99,
      "time_since_last_addition_hours": 2.5,
      "shipping_calculated": true,
      "tax_calculated": true,
      "promotions_applied": 2,
      "checkout_eligible": true
    }
  },
  "context": {
    "environment": "prod",
    "data_source": "website",
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15",
    "overide_ip": "203.0.113.89",
    "url": "https://shop.example.com/cart",
    "landing_url": "https://shop.example.com/computers/laptops",
    "referring_url": "https://google.com"
  },
  "products": [
    {
      "id": "GAMING_SETUP_001",
      "parent_id": "GAMING_SETUP_001",
      "sku": "GS-COMPLETE-001",
      "parent_sku": "GS-COMPLETE",
      "gtin": "1112223334445",
      "mpn": "GS-COMPLETE-2024",
      "ean": "1112223334445",
      "name": "Complete Gaming Setup Bundle",
      "parent_name": "Gaming Setup Bundle Series",
      "brand": "GameTech",
      "type": "bundle",
      "price_base": 899.99,
      "price": 799.99,
      "currency": "USD",
      "exchange_rate": 1,
      "tax_included": true,
      "tax_percent": 8.25,
      "quantity": 1,
      "stock_status": true,
      "stock_location": "Gaming Warehouse US",
      "created_at": 1748505040077,
      "url": "https://shop.example.com/gaming-setup-complete-bundle",
      "parent_url": "https://shop.example.com/gaming-setup-bundles",
      "image": "https://cdn.example.com/gaming-setup-bundle-main.jpg",
      "images": [
        "https://cdn.example.com/gaming-setup-bundle-keyboard.jpg",
        "https://cdn.example.com/gaming-setup-bundle-mouse.jpg",
        "https://cdn.example.com/gaming-setup-bundle-headset.jpg"
      ],
      "category": "Electronics > Gaming > Bundles",
      "categories": [
        {
          "name": "Electronics",
          "id": "cat_electronics"
        },
        {
          "name": "Gaming",
          "id": "cat_gaming"
        },
        {
          "name": "Bundles",
          "id": "cat_bundles"
        }
      ],
      "properties": {
        "bundle_items": ["keyboard", "mouse", "headset", "mousepad"],
        "rgb_lighting": "synchronized",
        "connectivity": "wireless_2.4ghz",
        "battery_life": "50_hours_avg",
        "software_included": "gaming_suite_pro",
        "warranty": "2_years_extended"
      }
    },
    {
      "id": "MONITOR_4K_001",
      "parent_id": "MONITOR_4K_001",
      "sku": "MON-4K-27-144",
      "parent_sku": "MON-4K-27",
      "name": "27\" 4K Gaming Monitor 144Hz",
      "parent_name": "27\" 4K Gaming Monitor Series",
      "brand": "DisplayTech",
      "type": "simple",
      "price_base": 449.99,
      "price": 399.99,
      "currency": "USD",
      "exchange_rate": 1,
      "tax_included": true,
      "tax_percent": 8.25,
      "quantity": 1,
      "stock_status": true,
      "category": "Electronics > Monitors > Gaming Monitors",
      "properties": {
        "screen_size": "27_inch",
        "resolution": "3840x2160",
        "refresh_rate": "144Hz",
        "panel_type": "IPS",
        "hdr_support": "HDR10",
        "connectivity": ["hdmi_2.1", "displayport_1.4", "usb_c"]
      }
    },
    {
      "id": "CHAIR_GAMING_PRO",
      "parent_id": "CHAIR_GAMING_PRO",
      "sku": "CHR-GAM-PRO-BLK",
      "name": "Pro Gaming Chair - Black",
      "brand": "ComfortGaming",
      "type": "simple",
      "price": 149.99,
      "currency": "USD",
      "tax_included": true,
      "tax_percent": 8.25,
      "quantity": 2,
      "stock_status": true,
      "category": "Furniture > Gaming > Chairs",
      "properties": {
        "color": "black",
        "material": "premium_leather",
        "weight_capacity": "150kg",
        "adjustable_height": "yes",
        "lumbar_support": "built_in",
        "armrests": "4d_adjustable"
      }
    }
  ],
  "coupons": [
    {
      "name": "GAMING_BUNDLE_20",
      "value": 160.00,
      "currency": "USD",
      "tax_percent": 8.25,
      "tax_included": true,
      "id": "GAMING_BUNDLE_2024",
      "type": "BUNDLE_DISCOUNT"
    },
    {
      "name": "FIRST_ORDER_10",
      "value": 50.00,
      "currency": "USD",
      "tax_percent": 8.25,
      "tax_included": true,
      "id": "FIRST_ORDER_2024",
      "type": "FIRST_TIME_BUYER"
    }
  ],
  "user": {
    "id": "CUST_654321",
    "email": ["[email protected]"],
    "phone": ["+1555999111"],
    "first_name": "Alex",
    "last_name": "Thompson",
    "country": "United States",
    "region": "Texas",
    "city": "Austin",
    "street": "123 Gaming Street, Apt 15",
    "postal_code": "78701",
    "properties": {
      "customer_segment": "gaming_enthusiast",
      "acquisition_channel": "social_media",
      "preferred_categories": ["gaming", "electronics", "tech"],
      "preferred_language": "en",
      "browsing_behavior": "bundle_shopper",
      "cart_session_duration_minutes": 45,
      "previous_cart_abandonment": false,
      "price_sensitivity": "medium",
      "marketing_consent": true
    }
  }
}

Implementation Methods​

These examples show how to send the data objects using different implementation approaches. Choose the method that best fits your technical setup.

// Web tracking implementation
window.reshape = window.reshape || [];

// Send the complete data object
reshape.push({
  "event": {
    "name": "cart_viewed",
    "value": 1349.97,
    "currency": "USD",
    "id": "CART_VIEW_789123"
  },
  "context": {
    "environment": "prod",
    "data_source": "website"
  },
  "products": [
    {
      "id": "GAMING_SETUP_001",
      "sku": "GS-COMPLETE-001",
      "name": "Complete Gaming Setup Bundle",
      "brand": "GameTech",
      "price": 799.99,
      "quantity": 1
    }
  ],
  "user": {
    "id": "CUST_654321",
    "email": ["[email protected]"]
  }
});

Product Properties Examples​

Audience Segmentation

Use the properties object to capture detailed product attributes that enable precise audience segmentation and better targeting in your advertising campaigns.

properties: {
  color: ["black", "white"],
  size: "M",
  material: "cotton",
  fit: "regular",
  season: "summer",
  collection: "2024_spring"
}
Cart Snapshot

The value field should represent the total current cart value (sum of price × quantity for all products) at the moment the cart is viewed, including any applied discounts or coupons.

Implementation Best Practices​

Event Timing​

Cart Page Load

// Trigger when cart page loads
document.addEventListener('DOMContentLoaded', function() {
  if (isCartPage()) {
    const cartData = getCurrentCartData();
    
    reshape.push({
      event: {
        name: "cart_viewed",
        value: cartData.total,
        currency: cartData.currency,
        id: generateCartViewId()
      },
      products: cartData.items,
      coupons: cartData.appliedCoupons
    });
  }
});

Cart Modal Display

// Trigger when cart modal/drawer opens
function showCartModal() {
  // Display cart modal
  openCartModal();
  
  // Track cart view
  const cartData = getCurrentCartData();
  reshape.push({
    event: {
      name: "cart_viewed",
      value: cartData.total,
      currency: cartData.currency,
      id: generateCartViewId()
    },
    products: cartData.items
  });
}

Data Collection Guidelines​

Cart State Accuracy

  • Capture current cart state at the moment of viewing
  • Include all active products with correct quantities
  • Reflect applied discounts, coupons, and promotions

Shopping Behavior Insights

  • Track cart composition for product affinity analysis
  • Monitor cart value distribution across user segments
  • Analyze cart viewing patterns in the purchase funnel

Conversion Optimization

  • Monitor time between cart views and checkout initiation
  • Track cart abandonment patterns after viewing
  • Identify high-value carts for targeted recovery campaigns