A Cookie Information tag lets you integrate Cookie Information and Piwik PRO. The tag maps cookie categories from Cookie Information with consent types in Piwik PRO. This lets you trigger tags based on consents collected through the Cookie Information consent popup. It helps you monitor and optimize your consent rates.
In this article, we’ll show you how to set up the tag and integrate Cookie Information with Piwik PRO.
Before you start
Here are a few things to know before you start:
You need an account in Piwik PRO and Cookie Information.
You need Cookie Information and Piwik PRO codes installed on your website:
To install Cookie Information, follow these guides:
a. Popup implementationTo install Piwik PRO code on your website, follow the guide that fits your tools:
To install Piwik PRO code in your mobile app, follow a dedicated guide:
Read about the benefits of integrating Cookie Information with Piwik PRO in this blog post.
To integrate Cookie Information with Piwik PRO, you'll need to use Piwik PRO Tag Manager as well.
A Cookie Information banner automatically includes details about cookies used by Piwik PRO. No manual addition is necessary. Keep in mind that the cookie details will appear once the cookie scanner completes its task. If you don’t see them immediately, it means the scanner is still at work.
Adjust the settings in Piwik PRO
Here are the key setting you need to adjust Piwik PRO:
1. Turn on: Administration > Sites & apps > Privacy > Ask visitors for consent (on).
2. Turn on: Administration > Sites & apps > Privacy > Ask visitors for consent > Consent settings > Use a custom consent form (on).
Adjust the settings in Cookie Information
Here are the key setting you need to adjust in Cookie Information:
Make sure the shared consent option is turned off.
Go to Consent solutions.
Find the consent solution for the domain where you want to disable shared consent.
4. Navigate to Settings.
5. In Features, turn off Shared consent.
Note: This action disables the shared consent for domain(s) in this consent solution only.
6. Click Save.
7. If you have changed Piwik PRO’s consent duration, update the ppms_privacy_* cookie in our Cookie Information. It means you need to create a new custom cookie. Here’s the instructions.
Note: The default consent duration in Cookie Information and Piwik PRO is 12 months. However, both tools let you adjust this period. If you change Piwik PRO’s consent duration, update the ppms_privacy_* cookie in Cookie Information accordingly. To do this, create a new custom cookie.
Set up a Cookie Information tag
To set up a Cookie Information tag in Piwik PRO, follow these steps:
Go to Piwik PRO.
Go to Menu > Tag Manager.
3. In Tags, click Add a tag.
4. In Add a tag, choose the tag template: Cookie Information.
5. Click Next.
6. Name your tag, e.g. Cookie Information.
7. In Consent mapping, map Cookie categories to Consent types.
8. Click Add.
Note:
You can use the default mapping by clicking ‘Set defaults’, but you can always change it.
You can map multiple consent types to a single cookie category. For example, ‘Statistical’ can be mapped to both ‘Analytics’ and ‘Remarketing’.
You can leave cookie categories and consent types unmapped. However, it’s a good practice to map all of them, just in case you decide to use them in the future.
If you use an unmapped consent type in a tag, it won’t fire.
‘Necessary cookies’ are mapped to ‘No consent is required’ without the ability to change them.
The Piwik PRO tag, responsible for collecting visitor data, requires ‘Analytics’ consent by default. So, if you want to collect such data, you need to map it to the right cookie type. Keep in mind that, by default, this tag will fire and collect anonymous data from visitors who haven’t consented. However, you can always turn off anonymous data collection. You can also change the default ‘Analytics’ consent set for the Piwik PRO tag.
Each time you change the mapping of cookie categories to consent types, you need to click ‘Push for consent’ in Cookie Information > Consent solutions > Settings > Push for consent.
9. In Consent type, make sure the type is set to: No consent is required. This tag is set this way because it only maps consents. We need it to fire for all visitors so that consent information flows between Cookie Information and Piwik PRO.
Note: The Cookie Information tag you’ll set up in Piwik PRO doesn't require consent. This tag is set this way because it only maps consents. We need it to fire for all visitors so that consent information flows between Cookie Information and Piwik PRO.
10. In Advanced tag settings, turn off Respect opt-out and DNT. This tag should fire for every visitor since it only maps their consents.
11. In Tag triggers, select Choose existing trigger.
12. Select the following trigger: All page views.
13. Click OK to save the trigger.
14. Click Add to add the tag.
15. Test your tag in debug mode.
16. When the tag works correctly, click Publish.
17. In Cookie Information > Consent solutions > Settings > Push for consent, click ‘Push for consent‘. If you ever change the mapping of cookie categories to consent types, repeat this step.
18. You can also view consent statistics in Piwik PRO.
Go to Piwik PRO > Analytics > Reports.
19. In Reports, go to Consent.
20. Done!