​
Event Overview

The Category viewed event helps understand the broad interests of your users by tracking which collections or categories they are browsing.

​
Use Cases

  • Category browsing behavior analysis
  • Browse abandonment campaigns
  • Filter and sort preference tracking
  • Personalized category recommendations

​
Event Attributes

FieldTypeDescription
category_idstringUnique category identifier
category_namestringDisplay name of category
category_urlstringDirect link to category page
category_image_urlstringCategory banner/thumbnail URL
category_pathstringFull breadcrumb path
total_productsintegerTotal products in category
page_numberintegerCurrent page number
products_displayedintegerProducts shown on page
filters_appliedstringHuman-readable filters text
sort_bystringSort option used
top_product_namestringFeatured product name
top_product_pricenumberFeatured product price
top_product_urlstringFeatured product URL
top_product_image_urlstringFeatured product image
price_range_minnumberLowest price in results
price_range_maxnumberHighest price in results
currencystringCurrency code

​
Payload Example

{
  "attributes": {
    "category_id": "CAT-WINTER",
    "category_name": "Winter Wear",
    "category_url": "https://example.com/collections/winter-wear",
    "category_image_url": "https://example.com/images/winter-banner.jpg",
    "category_path": "Home > Clothing > Winter Wear",
    "total_products": 150,
    "page_number": 1,
    "products_displayed": 24,
    "filters_applied": "Size: L, Color: Blue",
    "sort_by": "price-low-to-high",
    "top_product_name": "Woolen Scarf",
    "top_product_price": 25.00,
    "top_product_url": "https://example.com/products/woolen-scarf",
    "top_product_image_url": "https://example.com/images/scarf.jpg",
    "price_range_min": 10.00,
    "price_range_max": 500.00,
    "currency": "USD"
  }
}