Go Back

Piwik PRO Custom Dimensions Tag

August 14, 2018

Custom Dimensions let you assign any custom data to your visitors or actions (like pages, events) and then view the reports of how many visits, conversions, pageviews, etc. there were for each Custom Dimension. It is a newer and lighter version of Custom Variables. It simply allows viewing of additional metrics from the data collected on your site. For example, if your visitors leave information about the job title or company when signing up to your e-commerce store.

In order to use them click on “Create a new tag” in Tag Manager and select Piwik PRO Custom Dimensions from the list of asynchronous tag types.

Piwik PRO Custom Dimensions setup

To create a tag you need to fill in the Index and the Value

You can get index value from the Analytics settings where you defined Dimensions earlier on. To read more about defining your Dimensions please check here.

To access it please click Menu button in the top left corner and choose Analytics settings then click at Custom Dimensions.

Note the Id for each dimension and proceed to Tag Manager (Piwik PRO Custom Dimensions tag setup)

Now all you need to do is insert the ID from the previous step into the Index field, and choose a Variable (or preset value – whichever you prefer) that should be saved as value. Repeat the above step for all of the Dimensions.

Advanced tag settings

Tag Type – These settings are available for all the tags in Piwik PRO Tag Manager. They apply when the GDPR Compliance setting is turned on for a given website. Take a look how to turn it on here.

After turning it on, you need to pick the tag type. It can be either Does Not Require Consent, Analytics, A/B Testing and Personalization, Conversion Tracking, Marketing Automation, Remarketing, User Feedback or Custom Consent type.

Every tag type except the “Does not require consent” will require Visitor consent to fire.

Respect visitor privacy – by default, this option is marked in order to respect your visitors’ privacy preferences either expressed by selecting the “Do not track” option in their web browser and/or explicitly opting-out from being tracked. You may change it according to your preferences.

Do not fire in the Debug Mode – once this is ticked, the tag will not be fired in the debug mode. Why tick this? Sometimes you may have tags that are connected with some display CPC campaigns and you simply do not want to waste money when you’re doing some testing.

Flight dates

This option is available for all the tags in Piwik PRO Tag Manager. You can schedule when your tag will go live. By default, it runs forever and all day, but you can change it according to your preferences.

Tag triggers

To fire your tag, you need to associate it with a trigger. By standard, you can use the Click trigger that is firing whenever a particular click ID is clicked but feel free to experiment with other triggers as well. Learn more about the triggers here.

After you have your Custom Dimension tag properly configured, make sure to save it and then just hit the publish button in order to make it live. All the results will be visible in Analytics according to the scope either in Visits or Actions.

If you’d like to find out the differences between Custom Variables and Custom Dimensions please check this article.