Browsing

Understand how ecommerce browsing events work in RudderStack.

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

Products Searched

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

Property NameTypeDescription of the Property
queryString / ObjectQuery searched by the user

Here is an example of the Products Searched event:

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

Product List Viewed

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

Property NameTypeDescription of the Property
list_idStringName of the product list being viewed
categoryStringCategory of the product being viewed
productsArrayArray of products displayed in the product list
products.$.product_idStringProduct ID displayed on the list
products.$.skuStringSKU (Stock Keeping Unit) of the product being viewed
products.$.categoryStringCategory of the product being viewed
products.$.nameStringName of the product being viewed
products.$.brandStringName of the brand associated with the product
products.$.variantStringName of the variant of the product
products.$.priceNumberPrice of the product being viewed (in USD)
products.$.quantityNumberQuantity of the product
products.$.couponStringCoupon code associated with a product
products.$.positionNumberPosition of the product in the product list
products.$.urlStringURL of the product page
products.$.image_urlStringImage URL of the product

Here is an example of the Product List Viewed event:

rudderanalytics.track("Product List Viewed", {
  list_id: "list1",
  category: "What's New",
  products: [
    {
      product_id: "017c6f5d5cf86a4b22432066",
      sku: "8732-98",
      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: "89ac6f5d5cf86a4b64eac145",
      sku: "1267-01",
      name: "Wrestling Trump Cards",
      price: 4,
      position: 21,
      category: "Card Games"
    }
  ]
});

Product List Filtered

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

Property NameTypeDescription of the Property
list_idStringName of the product list being viewed
categoryStringName of the product category being viewed
filtersArrayProduct filters that the customer has applied
filters.$.typeStringID of the filter type that the customer is using
filters.$.valueStringID of the selection chosen by the customer
sortsArrayProduct sorting used by the customer
sorts.$.typeStringID of the sort type used by the customer
sorts.$.valueStringID of the selection-type the customer is using
productsArrayProducts displayed in the product list
products.$.product_idStringProduct ID displayed in the product list
products.$.skuStringSKU of the viewed product
products.$.categoryStringProduct category viewed by the customer
products.$.nameStringName of the product being viewed by the user
products.$.brandStringBrand name associated with the product
products.$.variantStringName of the product variant
products.$.priceNumberPrice of the product being viewed (in USD)
products.$.quantityNumberQuantity of a product
products.$.couponStringCoupon code associated with a product
products.$.positionNumberPosition of the product in the product list
products.$.urlStringURL of the product page
products.$.image_urlStringImage 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: "5556ed1b1cf49eb378a32009",
      sku: "4594-58",
      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: "9281bb1e0af05af308a32009",
      sku: "0966-22",
      name: "Boost",
      price: 47.85,
      position: 12,
      category: "health",
    },
  ],
})

Questions? Contact us by email or on Slack