Configure Piwik PRO Server-side Tracking

What events can you track server-side with Piwik PRO?

You can measure a wide range of events, including:

• E-commerce: add_to_cart, remove_from_cart, view_item, purchase
• Page views: pageview, appview
• Search: search queries
• External link clicks: outbound link tracking
• File downloads
• Custom events: e.g. video plays, custom interactions (categorize these for Piwik PRO dashboard visibility)

Prerequisites

• A TAGGRS account and server-side GTM container
• Piwik PRO account and site/app ID
• GA4 Client configured in your GTM server container

Option 1: Quick setup using TAGGRS templates

1. Open the

   TAGGRS Template Gallery and select the Piwik PRO server-side tag template.

2. Piwik Pro server-side tags are already included, so now you just need to configure required variables:

   Piwik PRO account name
site/app ID
‍

3. Publish your server container to activate server-side tracking.

This approach is fastest and helps avoid manual configuration errors.

Option 2: Manual configuration for full control

Create a new tag in your GTM server container

Create a new tag by going to tags and then clicking new. Give the tag a name.

Configure the tag

Click tag configuration, go to Discover more tag types in the Community Template Gallery and add the Piwik Pro tag.

Add account name

1. Go to your Piwik Pro account and copy your account name.

   Log in here

2. Paste it into your GTM server container.

Configure tag settings

1. Enter your account name and site/app ID (find these in your Piwik PRO dashboard under “Sites & Apps”).
2. Paste it into Google Tag Manager.
3. Select the event type (e.g. pageview, ecommerce, custom).
4. 

   With anonymous tracking, you can choose to remove your IP address, for example. Under event type, select the type of event you want to measure. Leave the rest of the settings at default.
   For custom events, define the event category and action.

Add a trigger

1. Set the trigger to fire on relevant GA4 events or other server-side triggers.
2. If you are using Consent Mode, add a consent type, as Piwik Pro is not a Google product. Add analytics_storage as a trigger for analytics. If you are not using Consent Mode, add pageview as a trigger. This is the last step of the page_view Piwik PRO tag.

(For e-commerce and some custom events)

Add transformations:
Create a Lookup Table variable to map GA4 event names to Piwik PRO event types (e.g., add_to_cart → add-to-cart).

Add an Augment Event Transformation to ensure data is formatted for Piwik PRO.

Test and verify:
Use GTM Preview mode to confirm events are processed and sent correctly to Piwik PRO

Now, the pageview tag has been created. It's time to set up tags for the rest of the events.

Standard Ecommerce Events

Create a new tag, again choose Piwik PRO tag as configuration, and enter the following:

Account Name
Site or App ID
Event Type = Ecommerce

You can leave the rest default or customize it to your liking.

Note that consent mode has been added to the trigger; remove the consent state part if you don't want it. However, you still need to add transformations to ensure that the data is processed correctly. Go to Step Set the transformations to do that.

Custom Ecommerce Events

Create a new tag, select Piwik PRO tag as configuration, and enter:

Account Name
Site or App ID
Event Type = Custom
Custom Event Category = ecommerce
Custom Event Action = {{Event Name}}

As for the Standard Ecommerce Events: Consent Mode has been added to the trigger; remove the consent state part if you don't want it. However, you still need to add transformations to ensure that the data is processed correctly. Follow the next step to do that.

Set the transformations

1. Create a Lookup Table variable that converts GA4 event names to the corresponding Piwik Pro event types. For example, add_to_cart in GA4 becomes add-to-cart in Piwik Pro.
2. Add the transformation by creating a new Augment Event Transformation. This transformation ensures that the GA4 data is modified to the correct Piwik Pro format before it is forwarded.

Test and verify

After the transformations are set up and added to the appropriate tag, use the preview mode in Google Tag Manager to test that the events are processed correctly and sent to Piwik PRO.

Anonymize IP addresses via TAGGRS (Optional)

TAGGRS' GDPR Tool allows you to easily anonymize IP addresses / User agents. Find the feature in the Dashboard and activate it to comply with GDPR and protect user privacy.

Useful resources