Piwik PRO custom event tag

The Piwik PRO custom event tag lets you track an event on your website. For example, you can track a button click, page-scroll depth, newsletter signup, or another event. 

Each custom event consists of four elements: event category, action, and optionally name and value. After setting up the tag, these elements appear in the custom event report.

To create and set up the Piwik PRO custom event tag, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Tags.
  3. Click + Create new tag.
  4. Name the tag and select the Piwik PRO custom event tag.
  5. Add CategoryAction, and optionally Name and Value that you want see in reports for this event.
  6. Piwik PRO custom event setup.

    Note: You can track a previously created custom dimension by picking the index number of the dimension and providing its value. For more, read Create a custom dimension.

  7. In Advanced tag settings, set the tag type. By default, it’s set to be displayed to visitors who consent to Analytics, but you can change it to a different type.
  8. By default, the Respect visitor privacy is turned on. Leave it as is, if you want to respect visitors who set a do-not-track option in their browser.
  9. In Flight dates, set time during which you want to run the tag.
  10. In Tag triggers, click + New trigger or + Existing trigger to set up a trigger for your tag.
  11. Adjust trigger conditions.
  12. When you’re done, click Save for the trigger and click Save for the tag.
  13. Test your tag in debug mode.
  14. When you’re happy how the tag works, click Publish.

After some time, data will be collected and you will be able to see the event in the custom event reports (Menu > Analytics (new) > Reports > Custom events).

A custom event report in Piwik PRO.

Analytics (classic): Menu > Analytics > Actions > Events

Tip: Read our guide Analytics for Advanced in which we explain how the event tracking works and share plenty of useful examples.

Was this article helpful?

Technical Support

If you have any questions, drop us a line at support_SPC@piwik_SPC.pro.

We’re happy to help!