1. Ensure The Tag Rocket API is enabled (& Republish if required)
  2. Add the following script to BC’s Script Manager:
Name of scriptTag Rocket Piwik Pro
DescriptionPiwik Pro Analytics
Location on pageHead
Select pages where script will be addedAll pages
Script categoryAnalytics
Script typeScript
Script contentsAdd script located here with settings edited as indicated below.

The script has the following settings to enable tracking and to add features.

Setting nameRequiredInstructions
piwikInstanceNameYesIf your admin URL is https://your-instance-name.piwik.pro/ then the instance name is your-instance-name
piwikSiteIdYesMenu->Administration->Sites & apps. Select site, copy ID
piwikGoalContactIdNoIf you create an Analytics->Goal called “Contact”, then set this to its Goal ID to track when people use your contact form.
piwikGoalSubscribeIdNoIf you create an Analytics->Goal called “Account Created”, then set this to its Goal ID to track when people use your contact form.
piwikGoalAccountCreatedIdNoIf you create an Analytics->Goal called “Subscribe”, then set this to its Goal ID to track when people use your contact form.
piwikGoalAddToWishListIdNoIf you create an Analytics->Goal called “Add To Wish List”, then set this to its Goal ID to track when people use your contact form.
piwikCustomDimensionCustomerGroupNameIdNoTo track the groups your customers are in, Go to Analytics->Settings->Custom dimensions, add a session based dimension called “Customer Group Name”, then set this to its Dimension ID.
piwikCustomDimensionPageTypeIdNoTo track the types of pages people visit, Go to Analytics->Settings->Custom dimensions, add an event based dimension called Page Type, then set this to its Dimension ID.

Custom Reports

The Tag Rocket report sends custom events that can be used in custom reports. Here are some examples:

Checkout Flow

This report adds a more detailed report on how users flow through your checkout process. It can help you identify bottlenecks and where abandonments happen. We’ve written a dedicated article on setting up the Checkout Flow report. You can ignore the section on setting up the events because the above script has already done that for you.

Improved Shopping behaviour report

Piwik Pro enhanced shopping behaviour report.

If you have enabled ecommerce reports, which you should do, you will see the Ecommerce tab in Analytics. In that tab is a “Shopping behaviour” report. Let’s make a slightly better version showing when product lists are viewed (e.g. category and brand pages) using the extra data we send.

Click the blue “Customize” button to open up a report editor for a custom report based on the “Shopping behaviour” report.

Click the “Add a step” button between the 1st and 2nd steps. And make a new step 2:

  • Optional: Yes
  • Step name: “Viewed a product list”
  • Event type: “Custom event” where “Custom event category” is “productListView”

Save the new custom report, which you can now find in the custom reports tab.

Product list view report

Let’s go a further step by taking the same data and generating a new custom report that lets you look at what product lists people have looked at. e.g. which categories are popular.

In the “Custom reports” tab, click on the “Add a report” button. Then select “Explorer”.

Report name: “Product list view”.

Nested dimensions: “Custom event action” -> “Custom event name”, both in the Dimension->Custom event section.

In the table section, add columns for “Events” (Metric->Session) and “custom event value” (Dimension->Custom event). Then click on the “custom event value” button and change it to “Sum of custom event value”.

Sort by “Events” “Descending”.

Add a filter dimension where “custom event category” (Dimension->Custom event) is “productListView”.

Save the report, then wait until you have some data.

Piwik Pro product list view report.

It’s valuable to note that Tag Rocket reports list views as a user scrolls down the page. There will be multiple list views on a page if the user scrolls. The product view count is how many products the users saw, which I think is of more value.

You can also click the Category or Brand link to see a sub-report on the Categories or Brands viewed. That way, you can determine which specific Categories and Brands have the most product views.