Google Tag Manager: install a tracking code

If you’re using Google Tag Manager on your website, you can add the Piwik PRO tracking code using a dedicated tag. First, you’ll need to add a site or app to Piwik PRO. Next, set up our tag in Google Tag Manager. In this article, we’ll show you how to do it.

Add a site or app in Piwik PRO

To add a site or app in Piwik PRO, follow these steps:

  1. Go to Menu > Administration.
  2. Navigate to Sites & apps.
  3. Click Add a site or app.
  4. Type the site or app name and address, and click Save.
    Site or app address (Administration)

    Note: If you want to track a few domains with the same tracking code, add their addresses.

  5. Set the time zone and currency.
    Time zone and currency (administration)

    Note: We’ll show data in reports in this time zone. We’ll use this currency for goal revenue.

Install a tracking code using Google Tag Manager

Note: You need to have edit permissions or higher for your container in Google Tag Manager to add our tag.

To install the Piwik PRO tracking code with Google Tag Manager, follow these steps:

  1. In Google Tag Manager, choose the container for your site or app.
  2. Go to Tags.
  3. Click New to add a new tag.
  4. Name your tag. Example: Piwik PRO tracking code.
  5. Click Choose a tag type to begin setup…
    Google Tag Manager: add a tag
  6. Click Discover more tags in the Community Template Gallery.
    Google Tag Manager: discover more tags
  7. Click on the search icon and type in Piwik PRO Analytics. Our tag will then appear on in search results.
    Google Tag Manager: Piwik PRO Analytics tag
  8. Click Piwik PRO Analytics.
  9. Click Add to workspace.
    Google Tag Manager: add to workspace
  10. Click Add to confirm your choice.
  11. Now set up the tag. In Instance URL, type in your Piwik PRO account address. Example: https://example.piwik.pro/.
    Google Tag Manager: Piwik PRO instance URL
  12. In Site or app ID, type in your the ID. Where to find it?
    Google Tag Manager: Piwik PRO site or app ID
  13. In Analytics domains, type in your site or app address. You’ll collect data for this site or app.
    Google Tag Manager: Piwik PRO analytics domains

    Note: If you want to track a few domains with the same tracking code, add their addresses. Separate with the enter key. No commas.

  14. In Data collection, you can set the following elements:
    Google Tag Manager: Piwik PRO data collection
    • Set a user ID: If turned on, you’ll recognize visitors by their user ID. A user ID can be a visitor’s email, username or some other unique identifier. We store IDs under the dimension called user ID. You can use this dimension in custom reports, segments and filters. Read more
    • Outlinks and downloads: If turned on, you’ll count outlinks and downloads. Outlinks are links that take the visitor outside your website. Downloads are links to all kind of files on your website. You’ll see collected data under Analytics > Reports > Outlinks or Analytics > Reports > Downloads.
    • Interactions with popups and content: If turned on, you’ll count times when people see and interact with your popup or content. Impressions and interactions are counted for: (1) popups added under Tag Manager > Tags > Add new tag > Custom popup, (2) content added under Tag Manager > Tags > Add new tag > Custom content, (3) any page content you tag in your website’s code. You’ll see collected data under Analytics > Reports > Content performance. Read more
    • Count session time precisely: If turned on, you’ll measure the end of a session more accurately. Session time is the period between opening the first page and closing the last one, but it’s hard to know exactly when a visitor closes the last page. This option will send ping requests to check if a visitor is still on the last page.
    • Recognize a visitor across domains: If turned on, the visitor who goes from one website to the other will be recognized as the same visitor. Sessions that would be treated as separate for each website, will be treated as one session. This option works only for domains that use the same tracking code and are added under Administration > Websites & apps > URLs. We add the pk_vid parameter to the page URL to pass the visitor ID between domains. Read more
    • Recognize a visitor across subdomains: If turned on, the visitor who goes from one subdomain to the other will be recognized as the same visitor. Sessions that would be treated as separate for each subdomain, will be treated as one session. This option works only for subdomains that use the same tracking code. You need to pick a domain where you’ll store a cookie with the visitor ID. Read more
  15. In Privacy, you can set the following elements:
    Google Tag Manager: Piwik PRO privacy
    • Use visitor cookies: If turned off, you won’t set visitor cookies like _pk_id.* and _pk_ses.* that are responsible for recognizing visitors and their sessions.
    • Use secure cookies: If turned on, you’ll receive information from first-party cookies over a secure connection. Only websites with the HTTPS protocol will be able to access these cookies.
    • Remove the visitor cookie at custom time: The visitor cookie (_pk_id.*) is removed after 13 months by default. You can delete it at a different time.
    • Remove the session cookie at custom time: The session cookie (_pk_ses.*) is removed after 30 minutes by default. You can delete it at a different time.
  16. In Other options, you can set the following elements:
    Google Tag Manager: Piwik PRO other options
    • Detect JavaScript errors: If turned on, you’ll record all kinds of JavaScript errors on your website. The errors will be saved as custom events with the error type and the URL of the page where they occurred. You’ll see them under Analytics > Reports > Custom events or if you create a custom report.
    • Track page views manually: If turned on, you can use a virtual page view tag or custom JavaScript code to track page views manually.
    • Don’t fire in debug mode: If turned on, this tag won’t fire in debug mode, but will still fire on your site or app.
  17. In Triggering, click Choose a trigger to make this tag fire…
    Google Tag Manager: add a trigger
  18. Choose All pages.
    Google Tag Manager: a all pages trigger
  19. Click Save.
  20. Click Submit, and then click Publish to push changes to your site or app.
  21. Done! Data will appear in reports in about an hour. Data in the tracker debugger will appear instantly.

    Tip: You can also check manually if the tracking works. Read more

Was this article helpful?

Technical support

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

Back to help center