The browsing lifecycle events are associated with the key activities that a customer might perform while browsing through your website or mobile app.

Products Searched

This event is triggered whenever a visitor searches for a particular product on your app/website. The following properties are supported by this event:

Property NameTypeDescription of the Property
queryString / ObjectContains the query that has been searched by the user

An example of the Products Searched event is as shown:

rudderanalytics.track("Products Searched", {
query: "HDMI cable",
})

Product List Viewed

This event is triggered whenever a visitor views a list or category of products on your website or app. The following properties are supported by this event:

Property NameTypeDescription of the Property
list_idStringContains the name of the product list being viewed
categoryStringContains the category of the product being viewed
productsArrayContains the array of products displayed in the product list
products.$.product_idStringContains the product ID displayed on the list
products.$.skuStringContains the SKU (Stock Keeping Unit) of the product being viewed
products.$.categoryStringContains the category of the product being viewed
products.$.nameStringContains the name of the product being viewed
products.$.brandStringContains the name of the brand associated with the product
products.$.variantStringContains the name of the variant of the product
products.$.priceNumberContains the price of the product being viewed (in USD)
products.$.quantityNumberContains the quantity of the product
products.$.couponStringContains the coupon code associated with a product
products.$.positionNumberContains the position of the product in the product list
products.$.urlStringContains the URL of the product page
products.$.image_urlStringContains the image URL of the product

An example of the Product List Viewed event is as shown:

rudderanalytics.track('Product List Viewed', {
list_id: 'list1',
category: 'What's New',
products: [
{
product_id: '223344ffdds3ff3',
sku: '12345',
name: 'Just Another Game',
price: 22,
position: 2,
category: 'Games and Entertainment',
url: 'https://www.myecommercewebsite.com/product',
image_url: 'https://www.myecommercewebsite.com/product/path.jpg'
},
{
product_id: '343344ff5567ff3',
sku: '12346',
name: 'Wrestling Trump Cards',
price: 4,
position: 21,
category: 'Card Games'
}
]
});

Product List Filtered

This event is triggered whenever a visitor filters a list or category of products on your website or app. The following properties are supported by this event:

Property NameTypeDescription of the Property
list_idStringContains the name of the product list being viewed
categoryStringContains the name of the product category being viewed
filtersArrayContain the product filters that the customer has applied
filters.$.typeStringContains the ID of the filter type that the customer is using
filters.$.valueStringContains the ID of the selection chosen by the customer
sortsArrayRepresents the product sorting used by the customer
sorts.$.typeStringContains the ID of the sort type used by the customer
sorts.$.valueStringContains the ID of the selection-type the customer is using
productsArrayContains the products displayed in the product list
products.$.product_idStringContains the product ID displayed in the product list
products.$.skuStringContains the SKU of the viewed product
products.$.categoryStringContains the product category viewed by the customer
products.$.nameStringContains the name of the product being viewed by the user
products.$.brandStringIndicates the brand name associated with the product
products.$.variantStringContains the name of the product variant
products.$.priceNumberContains the price of the product being viewed (in USD)
products.$.quantityNumberIndicates the quantity of a product
products.$.couponStringContains the coupon code associated with a product
products.$.positionNumberIndicates the position of the product in the product list
products.$.urlStringContains the URL of the product page
products.$.image_urlStringContains the image URL of the product

An example of the Product List Filtered event is as shown:

rudderanalytics.track("Product List Filtered", {
list_id: "dealoftheday",
filters: [
{
type: "department",
value: "health",
},
{
type: "price",
value: "under-$75",
},
],
sorts: [
{
type: "price",
value: "asc",
},
],
products: [
{
product_id: "5034221345ffcd672315011",
sku: "12345",
name: "Whey Protein",
price: 55.45,
position: 1,
category: "health",
url: "https://www.myecommercewebsite.com/product/product1123",
image_url: "https://www.example.com/product/1123.jpg",
},
{
product_id: "121244455323232326677232",
sku: "345667",
name: "Boost",
price: 47.85,
position: 12,
category: "health",
},
],
})

Contact us

For queries on any of the sections covered in this guide, you can contact us or start a conversation in our Slack community.

Contents