Here will soon be the User Guide for Event Tracking with Piwik Analytics. Stay tuned!

Viewing Events Reports

Go to Piwik. In the menu click Actions and then Events.

Requesting Events report data

You may use the Events API to request all data for Events, including any report combining Event Categories, Event names and Event actions (see &secondaryDimension= parameter)

Tracking Events

Javascript trackEvent()

To track an event, use the Javascript function trackEvent:

trackEvent(category, action, [name], [value])

It will log an event with an event category (Videos, Music, Games…), an event action (Play, Pause, Duration, Add Playlist, Downloaded, Clicked…), and an optional event name and optional numeric value.

For example to track a click on the Play button of the Documentary Thrive you may write in your Piwik JavaScript Tracking Code in your pages:

_paq.push(['trackEvent', 'Documentary', 'Play', 'Thrive']);

To track the progress of playing a particular movie, for example when 20% of the movie has been played already:

_paq.push(['trackEvent', 'Documentary', 'Play-20%', 'Thrive']);

You may also track numeric values for your event. Event value is often used to track ratings and scores of particular items, such as tracking a rating of 9.5 out of 10 for Thrive:

_paq.push(['trackEvent', 'Documentary', 'Rating', 'Thrive', 9.5]);

Piwik reports for events will include the Total Event value, the Average event value as well as the Minimum and Maximum value, for each Event Category and each Event Name and each Event Action.

See also the JavaScript Tracking Guide for Events.

Tracking Events with HTTP API

Use Event Tracking from any application or server, with the Tracking API. View the Event Tracking HTTP API here.