Analytics built-in

The analytics built-in pushes selected configurator events to a browser data layer.

Configure

{
  id: 'analytics',
  enabled: true,
  required: false,
  options: {
    dataLayerName: 'YOUR_DATA_LAYER',
  },
}

Option	Type	Default	Purpose
dataLayerName	string	dataLayer	Name of the array created or reused on window.

If the named value does not exist, the plugin creates an array. If it already contains an array, the plugin appends to it.

Emitted data-layer events

Data-layer event	Configurator source
icon_visualizer_ready	app:ready
icon_visualizer_route_changed	route:changed
icon_visualizer_wheel_viewed	wheel:viewed
icon_visualizer_rfq_submitted	rfq:submitted

Each push uses this shape:

{
  event: 'icon_visualizer_wheel_viewed',
  iconVisualizer: EVENT_PAYLOAD,
}

Consult the events reference for payload fields. Review RFQ data-handling requirements before forwarding events to a third-party analytics provider.

Build a custom analytics plugin when you need different event names, field selection, or consent behavior.