Product List Viewed

Description

This client-side event fires on the Shopify storefront’s category pages.

Instrumentation

This event is implemented with our javascript analytics library. The tracking code is managed in the storefront theme.

Event Properties

Property	Type	Description
list_id	String	Product list being viewed
category	String	Product category being viewed
products	Array<Product>	Products displayed in the product list
products.$.product_id	String	Product id displayed on the list
products.$.sku	String	Sku of the product being viewed
products.$.category	String	Product category being viewed
products.$.name	String	Name of the product being viewed
products.$.brand	String	Brand associated with the product
products.$.variant	String	Variant of the product (e.g. Black)
products.$.price	Number	Price ($) of the product being viewed
products.$.position	Number	Position in the product list (ex. 3)
products.$.url	String	URL of the product page
products.$.image_url	String	Image url of the product

Example:

analytics.track('Product List Viewed', {
  list_id: 'great_deals_1',
  category: 'Deals',
  products: [
    {
      product_id: '507f1f77bcf26cd799439011',
      sku: '45791-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: '505bd76785ebb709fc183733',
      sku: '46492-32',
      name: 'Uno Card Game',
      price: 3,
      position: 2,
      category: 'Games'
    }
  ]
});