Browsing

Understand how ecommerce browsing events work in RudderStack.

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",
    },
  ],
})

Questions? Contact us by email or on Slack