Integration for: Confluence Server and Data Center only
When you want to collect data about Confluence users with Piwik PRO, you can use our integration. The integration takes a few steps and lets you choose what data you’ll collect. In this article, we’ll guide you through the whole setup.

To integrate with Confluence, follow these steps:
Needed permissions:
- Confluence: admin
- Piwik PRO: owner or manage
- Download the file with our plugin.
Note: This integration is not yet listed on the Atlassian marketplace. We work on adding it there.
- Log in to Confluence.
- Go to Menu > Manage apps.
- Add the downloaded file or paste the link to the file with our plugin.
- Click Upload.
- All done! Our plugin is installed.
- Go to Menu > Confluence administration.
- You’ll see Piwik PRO integration and Piwik PRO space mapping on the list. They both help you integrate with Piwik PRO.
- On the left, click Piwik PRO integration.
- Click Edit.
- In Settings, add the following information:
- Account address: Example:
example.piwik.pro
orpiwik.example.com
. - Client ID: Enter the client ID from Piwik PRO’s API keys. Where to find it?
- Client secret: Enter the client secret from Piwik PRO’s API keys. Where to find it?
- Account address: Example:
- In Data collection, you can set the following elements:
- User ID: An email address will be set as a user ID in Piwik PRO. If an email address is not available, a Confluence user ID will be set instead.
- Anonymize a user ID: A user ID will be masked. You won’t see an email address or a Confluence user ID in collected data.
- Full name: A full user’s name will be sent as a custom variable.
- Email address: A user’s email address will be sent as a custom variable.
- Department: A user’s department will be sent as a custom variable.
- Position: A user’s position will be sent as a custom variable.
- Office location: A user’s office location will be sent as a custom variable.
- Track new spaces automatically: Each new space added in Confluence will be automatically added and tracked as a site in Piwik PRO. You’ll see it in Piwik PRO > Administration > Sites & apps.
- Click Save.
- On the left, click Piwik PRO space mapping.
- Here you can map spaces from Confluence to sites in Piwik PRO.
- Optionally, click Load all sites from Piwik PRO. This will load all sites from your Piwik PRO account and check if they are correctly assigned to spaces on Confluence.
- You can quickly check if data is collected correctly by going to Piwik PRO > Menu > Analytics > Settings > Tracker debugger.
Note: Data in the tracker debugger appears instantly. Data in reports appears in about 30 minutes.
Confluence events
This integration lets you collect data specific to Confluence spaces. Some data is tracked as custom events. Here’s a full list of them.
Event category | Event action | Event name | Description |
---|---|---|---|
Page | Page created | {{Page URL}} | A new page was created in Confluence. |
Page | Page removed | {{Page URL}} | A page was removed in Confluence. |
Page | Page updated | {{Page URL}} | A page was updated in Confluence. |
Comment | Comment created | {{Page URL}} | A comment was added to a page in Confluence. |
Comment | Comment removed | {{Page URL}} | A comment was removed from a page in Confluence. |
Comment | Comment updated | {{Page URL}} | A comment was changed in Confluence. |
Blogpost | Blogpost created | {{Page URL}} | A blogpost was published in Confluence. |
Blogpost | Blogpost removed | {{Page URL}} | A blogpost was removed in Confluence. |
Blogpost | Blogpost updated | {{Page URL}} | A blogpost was updated in Confluence. |
Attachment | Attachment created | {{Page URL}} | A file was attached to a Confluence page. |
Attachment | Attachment removed | {{Page URL}} | A file was removed from a Confluence page. |
Watch | Watch added | {{Page URL}} | A user started watching a page in Confluence. |
Watch | Watch removed | {{Page URL}} | A user stopped watching a page in Confluence. |
Favorite | Favorite added | {{Page URL}} | A user favorited a page in Confluence. |
Favorite | Favorite removed | {{Page URL}} | A user removed a page from their favorites in Confluence. |
Like | Like added | {{Page URL}} | A user liked a page in Confluence. |
Like | Like removed | {{Page URL}} | A user unliked a page in Confluence. |
Confluence variables
This integration lets you collect data specific to Confluence spaces. Some data is tracked as custom variables. Here’s a full list of them.
Variable name | Description | Notes |
---|---|---|
User ID | An ID of each Confluence user. It can be an email address or a semi-anonymous string of characters. | It needs to be turned on in Confluence > Menu > Confluence administration > Piwik PRO integration > Data collection. |
Full name | A full name of the Confluence user. | |
Email address | A user’s email address. | |
Department | A user’s department. | |
Position | A user’s position. | |
Office location | A user’s office location. |