SharePoint integration

When you want to track SharePoint users in your company, you need to integrate Piwik PRO with SharePoint and set up tracking. Integration is necessary because Piwik PRO needs to load the tracking code on SharePoint pages, but it can’t do it like on a regular website. After that Piwik PRO is ready to collect and report data.

Integrate with SharePoint

To integrate with SharePoint, follow these steps:

1. Contact us at support@piwik.pro.
2. You’ll need an admin account to SharePoint or team up with a colleague who has an admin account.
3. Pick the model of integration:
   • WSP: using WSP file extension.
   • APP: using APP file extension.
4. We’ll prepare and send you an installation package with instructions.
5. You’ll need to follow the instructions, and we’ll assist you in the process.
6. You’ll need to turn SharePoint reports on in Analytics — we’ll describe it later in this article. SharePoint reports is an additional section dedicated to analyze SharePoint data.
7. Based on your tracking plan, we’ll help you set up tracking.
8. After the integration is ready, you’ll see the collected data in Piwik PRO.
9. After this integration, if you ever need to track another site collection, look at the instructions at the end of this article.

All versions of Piwik PRO can be connected to various versions of SharePoint. Here’s a table that briefly explains which ones can be integrated.

Turn SharePoint reports on

To turn SharePoint reports on in Analytics, follow these steps:

1. Go to Menu > Administration.
2. Select a website you want to work with.
3. Navigate to Settings.
4. In Integrations, toggle SharePoint reports.
   

   

5. After doing that, you will see the SharePoint section in Analytics. Reports in this section will fill up with data as soon as you integrate with SharePoint and set up tracking.
   

   

Set up tracking for a site collection

If you need to set up tracking by yourself at some point, these guidelines will help you out. Before you begin, we’ll explain some basics.

A site collection is SharePoint’s name for something similar to a website. It’s a group of sites that have the same owner and share administrative settings. When you track SharePoint with Piwik PRO, you first switch on site collection tracking in SharePoint. The tracked site collection will then appear as a website in Piwik PRO. As the last step, you’ll need to import a container dedicated to SharePoint tracking to this website.

To turn tracking on for a site collection in SharePoint, follow these steps:

1. Log in to SharePoint.
2. Navigate to the site collection that you want to work with.
3. Click on the settings wheel in the menu bar.
4. Choose Piwik PRO settings.
   

   

5. In Site collection settings, mark Enable tracking.
   

   

   Note: It may take up to 30 minutes for tracking to start off because SharePoint’s search crawl needs to notice changes in settings. Also you may need to empty a browser cache because it stores tracker settings for 1 hour, or you can wait for it to refresh.

6. To check if tracking for a site collection is active, look for User information under Piwik PRO Settings. This section will only appear if tracking has started.
   

   

7. Also you can check the tracking status on SharePoint’s administration site: <your SharePoint URL>/sites/PiwikAdmin > Site contents > Piwik PRO site directory.
   

   

   Note: Active means that Piwik PRO tracks the site collection.

8. The tracked site collection will be automatically added as a new website to Piwik PRO.

Create a container for SharePoint tracking

In most cases, you’ll have a container for SharePoint tracking on your account. We set it up for you as a website called “Piwik PRO Container Snapshot Source” during the first integration with SharePoint. But it may happen that you can’t find it, and you’ll need to create it by yourself.

To create a container for SharePoint tracking, follow these steps:

1. Contact us at suppor@piwik.pro to get the file with container settings.
2. Log in to Piwik PRO.
3. Go to Menu > Administration.
4. Navigate to Websites & apps.
5. Click Add new website or app.
6. Enter the following details:
   • Name: Piwik PRO Container Snapshot Source
   • URLs: https://example
7. Click OK.
8. Go to Menu > Tag Manager.
9. Navigate to Settings.
10. In Import settings from file, click Add file.
11. Upload the file you received from us.
12. Click Publish.

Import a container for SharePoint tracking

For each site collection that you start tracking, you’ll need to import a container dedicated for SharePoint tracking. 

To import a container for SharePoint tracking, follow these steps:

1. Log in to Piwik PRO.
2. Choose the website (a site collection) that you want to set up.
3. Go to Menu > Tag Manager.
4. Navigate to Settings.
5. In Import settings from another website, choose Piwik PRO Container Snapshot Source.
   

   

6. Click Import.
7. Click Publish.
8. Now tracking for your site collection is all set, and you can see reporting under Analytics > SharePoint.