Product List View
Product list traits capture visitor interactions with category pages, search results, or promotional collections.
They help track what users are viewing, filtering, or sorting — enabling you to deliver personalized recommendations, targeted offers, or behavioral triggers.
productListViewed
Triggered when a visitor views a product list or category page.
| Trait | Type | Description |
|---|---|---|
list_id |
String | Product list being viewed |
category |
Array | Product categories being viewed |
products |
Array | Products displayed in the product list |
Example:
ppopAPI.sendTraits('productListViewed', { list_id: 'hot_deals_1', category: ['Deals', 'Games'], products: [ { product_id: '507f1f77bcf86cd799439011', sku: '45790-32', name: 'Monopoly: 3rd Edition', price: 19, position: 1, category: 'Games', url: 'https://www.example.com/product/path', image_url: 'https://www.example.com/product/path.jpg' }, { product_id: '505bd76785ebb509fc183733', sku: '46493-32', name: 'Uno Card Game', price: 3, position: 2, category: 'Games' } ] });
productListFiltered
Send this event when a visitor applies filters or sorting to a product list or category page.
| Trait | Type | Description |
|---|---|---|
list_id |
String | Product list being viewed |
category |
Array | Product categories being viewed |
filters |
Array | Product filters that the visitor is using |
filters.type |
String | ID of the filter type (e.g., department, price) |
filters.value |
String | Selected filter value |
sorts |
Array | Sorting applied to the product list |
sorts.type |
String | ID of the sort type (e.g., price, rating) |
sorts.value |
String | Sort direction (ascending or descending) |
products |
Array | Products displayed in the filtered or sorted list |
Example:
ppopAPI.sendTraits('productListFiltered', { list_id: 'todays_deals_may_11_2019', filters: [ { type: 'department', value: 'beauty' }, { type: 'price', value: 'under-$25' } ], sorts: [ { type: 'price', value: 'desc' } ], products: [ { product_id: '507f1f77bcf86cd798439011', sku: '45360-32', name: 'Special Facial Soap', price: 12.60, position: 1, category: 'Beauty', url: 'https://www.example.com/product/path', image_url: 'https://www.example.com/product/path.jpg' }, { product_id: '505bd76785ebb509fc283733', sku: '46573-32', name: 'Fancy Hairbrush', price: 7.60, position: 2, category: 'Beauty' } ] });
Continue Learning
Explore all Product Traits and how they connect to user behavior: Product Traits