Piwik PRO tag

Tag Manager

After adding a new website or app to Piwik PRO, you will see the Piwik PRO tag in Tag Manager. This tag is responsible for collecting data from your website or app and you can’t delete it. You can adjust the tag to track specific data, but be careful with any changes you make because they may affect the whole tracking.

To make changes in the Piwik PRO tag, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Tags.
  3. On the left, click Piwik PRO.
  4. In Piwik PRO setup, adjust elements that you need.
    Piwik PRO tag in Tag Manager

    Here’s a list of elements that can be adjusted in Piwik PRO setup:

    • Enable link tracking: It’s turned on by default. It tracks downloads and outlinks in Analytics.
    • Enable content tracking: It’s turned off by default. When you turn it on, Piwik PRO will track pop-ups set in a custom pop-up tag, contextual ads set in a custom content tag, and all other elements defined as content.
    • Enable cross-domain tracking: It’s turned off by default. This option lets you link different domains tracked under one website so that sessions across them are treated as a single session. The tracker will pass a visitor ID between domains using the added parameter pk_vid in the URL. For more, read this article.
    • Count session time precisely: This option lets you measure the exact time spent by the visitor on each page. By default, the time spent on a page is counted as the difference between the moment a visitor started viewing one page and the moment when a visitor started viewing another page. Because of how the mechanism works, Piwik PRO will not count the time spent on the last page. With this option, you can turn on a heartbeat which will be sending a ping every 15 seconds (or other selected number) to tell Piwik PRO that the visitor is still on that page. This way it will count the time spent on that page. Just keep in mind that setting the ping number below 15 seconds may slow down the website.
    • Set user ID: This option lets you add your own identifier for a visitor. For more, read how to set up a user ID.
    • Set cookie domain: It’s turned off by default. It’s used to define across which domains the user should be tracked in cross-domain tracking.
    • Disable cookies: It’s turned off by default. You can use it to disable cookies. We are not recommending to turn it on as it may influence tracking. For more, read how to disable cookies for vistiors.
    • Set secure cookie: Sets a secure-cookie flag on all first-party cookies. Use it only for websites with an HTTPS protocol so that all tracking cookies are sent over a secure connection. Please don’t use it for sites with other protocols.
    • Set visitor cookie timeout: Sets the timeout for a _pk_id.* cookie. It is used to store a few details about the visitor, such as a unique visitor ID.
    • Set referral cookie timeout: No longer supported.
    • Set session cookie timeout: Sets timeout for a _pk_ses.* cookie. It’s a short-lived cookie used to store session data.
    • Track JavaScript errors: Lets you track uncaught JavaScript errors.
    • Don’t track page views: Lets you to disable the _paq.trackPageView tracking method used in the Piwik PRO tracking code. Instead, you can track page views using a custom tag. 
  5. In Piwik PRO setup details, you’ll find fixed elements such as a domain and website ID.
    Piwik PRO tag in Tag Manager
  6. In Custom variables, you can set a custom variable to collect additional data from your website or app.
    Piwik PRO tag in Tag Manager

    Tip: Read about custom variables in Analytics.

  7. In Custom dimensions, you can start tracking a dimension added under Menu > Analytics (new)Settings > Custom dimensions.
    Piwik PRO tag in Tag Manager

    Tip: Read how to create a custom dimension.

  8. In Advanced tag settings, choose Consent type. Set it up if you use Consent Manager. The tag will fire only when selected consent is given by a visitor.
  9. Respect visitor privacy is turned on by default. Leave it as is, if you want to respect visitors who set a Do-Not-Track option in their browser or opted out from tracking.
  10. Enable document.write is turned off by default. Toggle this option, if your tag needs document.write.
  11. In Flight dates, set the date and time when the tag is fired.
  12. In Tag triggers, click Add new trigger or Choose existing trigger to set up a trigger for your tag.
  13. Adjust trigger conditions.
  14. When you’re done, click OK for the trigger.
  15. Click Save for the tag.
  16. Test your tag in debug mode.
  17. When you’re happy how the tag works, click Publish.
Was this article helpful?

Technical support

If you still have some questions, visit our community.
There’s always someone ready to help!

Related articles

Back to help center