Google Tag Manager (server-side) integration

Integration for: Google Tag Manager (server-side)

When you use server-side Google Tag Manager to collect data for Google Analytics, you can use our integration to send that data to Piwik PRO. The integration uses a dedicated tag in Google Tag Manager. The tag sends tracked events from Google Tag Manager to Piwik PRO in real time.

To integrate, you’ll have to add a site or app in Piwik PRO, and then set up our dedicated tag in Google Tag Manager.

Before you start

Here are some things to know before you integrate with Google Tag Manager:

• This integration works best with Universal Analytics (GA3) because it has a similar data model to Piwik PRO. Some concepts of server-side tagging differ from regular web-based ones. Read more.
• Needed permission in Piwik PRO: owner.
• Needed permission in Google Tag Manager: administrator.

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.
   

   

   Note: If you want to track a few domains, add their addresses.

5. Set the time zone and currency.
   

   

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

Integrate with Google Tag Manager (server-side)

To integrate with server-side Google Tag Manager, follow these steps:

1. Download our dedicated tag.

   Note: Our dedicated tag will soon be available in Google’s Tag Manager Template Gallery.

2. Log in to Google Tag Manager.
3. Open your server-side container.
4. Go to Templates.
5. In Tag Templates, click New.
   

   

6. Click a three-dot icon in the top right corner and select Import.
   

   

7. Upload the template you’ve downloaded in Step 1.
8. Click Save.
9. Navigate to Tags.
10. Click New.
11. Click Choose a tag type to begin setup…
    

    

12. Choose Piwik PRO server-side from the list.
    

    

13. In Account address, enter your Piwik PRO account address (Example: example.piwik.pro).
    

    

14. In Site or app ID, add the ID of the site or app in Piwik PRO where you want to send data. (Where to find it?).
    

    

15. In Data collection, you can set the following parameters:
    • Use default tracking paths: By default, all events will be sent to the default “ppms.php” endpoint. Turn this option off to set your own path.
    • Anonymize data: If turned on, you won’t collect personal data like the visitor’s IP address and location data (only country data will be available).
    • Send custom dimensions: If turned on, you’ll send a custom dimension with each event sent to Piwik PRO.

    

16. If you turned on Send custom dimensions, you can now map them.
    

    

17. Click Add a custom dimension.
18. In Source Custom Dimension ID, add the ID from Google Analytics.
19. In Piwik PRO Analytics Custom Dimension ID, add the ID from Piwik PRO.
    

    

20. In Triggering, click Choose a trigger to make this tag fire.
    

    

21. Choose the following trigger: All Pageviews or All Events. This is when the tracked event for Google Analytics will be sent to Piwik PRO.
    

    

22. Click Save.
23. Click Submit.
24. Click Publish. 
25. Done! Now data will be sent to Piwik PRO in real time. In Piwik PRO reports, data will appear in about an hour. Data in the tracker debugger will appear instantly.