Your license includes access to two tools:
- Piwik PRO Analytics Suite
- Cookie Information Consent Management Platform (CMP)
Both tools work together: Cookie Information collects user consent, and Piwik PRO collects analytics data based on that consent.
In this article, we’ll walk you through setting up Cookie Information and Piwik PRO from scratch.
If you’re using the trial onboarding
If you created your account through a Cookie Information trial, you may see an in-app setup wizard.
Follow the steps in the wizard to:
- choose the popup language
- copy the script
- add the script to your website
Once the consent popup is installed, continue with this guide to connect Cookie Information with Piwik PRO.
Before you start
Here are a few important things to know before you start:
- Piwik PRO collects analytics data and Cookie Information collects user consent on your website. Connecting them ensures you collect data only after consent.
- When you create your account for the first time, you’ll get a trial account where a few steps might be different than those on your paid account. The trial lasts 30 days.
- To set up Piwik PRO and Cookie Information for the first time, you’ll need to:
- Create a consent popup
- Install Cookie Information on your website
- Install Piwik PRO
- Connect both tools
- You need access to:
- Your website code
- Cookie Information
- Piwik PRO
Set up Cookie Information for the first time
In this section, you’ll set up Cookie Information and install the consent popup on your website.
Set up your domain and install the consent popup
- Log in to your Cookie Information account.
- In Domain address, enter the domain name where you want to use Cookie Information CMP. You can add more domains later if your setup needs them.
- Select Domain type. Read more
- In Default language, choose the language for your popup. You can add more languages later.
- Copy the Cookie Information installation script:
<script id="CookieConsent"
src="https://policy.app.cookieinformation.com/uc.js"
data-culture="EN" data-gcm-version="2.0" type="text/javascript"></script>Note:
- The
data-culturevalue sets the language of the consent popup. This example will be displayed in English. Set the data-culture attribute to a different language code to change the language. Make sure that the languages set in the script’sdata-cultureattribute match the languages set up in the platform. - To avoid problems, don’t change the consent popup script, except for the
data-cultureattribute. - If the
data-culturevalue in the script doesn’t match the language set in Cookie Information, the consent banner may not appear. Make sure these language settings match. If you still have problems, see our troubleshooting guide.
Supported data-culture values
Use the code that matches your language. For example:
- EN — English
- DE — German
- FR — French
See the table below for all supported languages.
| Data culture | Language | Data culture | Language |
|---|---|---|---|
| AR | Arabic | LT | Lithuanian |
| BG | Bulgarian | LV | Latvian |
| CA | Catalan, Valencian | MS | Malay |
| CS | Czech | NB | Norwegian Bokmål |
| DA | Danish | NN | Norwegian Nynorsk |
| DE | German | NO | Norwegian |
| EL | Modern Greek | NL | Dutch, Flemish |
| EN | English | PL | Polish |
| ES | Spanish, Castilian | PT | Portuguese |
| ET | Estonian | RO | Romanian |
| FI | Finnish | RU | Russian |
| FR | French | SK | Slovak |
| HE | Modern Hebrew | SL | Slovene |
| HI | Hindi | SQ | Albanian |
| HR | Croatian | SR | Serbian |
| HU | Hungarian | SV | Swedish |
| ID | Indonesian | TH | Thai |
| IS | Icelandic | TR | Turkish |
| IT | Italian | TW | Taiwanese |
| JA | Japanese | UK | Ukrainian |
| KO | Korean | VI | Vietnamese |
| KL | Greenlandic | ZH | Chinese |
- Add the script as high as possible in the <head> section of your website.
Note:
- If you place them incorrectly, the setup won’t work.
- If the setup is correct, the consent popup will appear on your site within 10 minutes.
Optional: Use a different installation method. If you prefer a different installation method, follow one of our installation guides.
- To confirm the installation, click I’ve added the script.
- Your consent popup is now ready.
Note: Make sure Shared consent is turned off in Cookie management > Consent sharing and cookie control.
- Done. You’ve created your first consent solution and installed your Cookie Information script to display the consent popup.
Tip: If you want to change more settings or customize the banner appearance, see our guides.
Install Piwik PRO
In this section, you’ll install the Piwik PRO container on your website. The container collects data about how people use your site. For other ways to install it, see our installation guides.
Note: To use the default integration between Piwik PRO and Cookie Information, you need a tag manager.
To install Piwik PRO, follow these steps:
- Log in to your Piwik PRO account.
- Go to Menu > Administration.
- In Sites & apps, click Add a site or app.
- Enter your site or app name and address.
Note: You can add multiple domains to one site or app and track them using a single container code. Data from all domains will appear in the same reports.
If you want separate reports for each website, create a separate site or app for each one. Read more about sites and apps in Piwik PRO help center.
- In Data collection, set the time zone and currency.
Note: We’ll show data in reports in this time zone. We’ll use this currency for the goal revenue.
- Navigate to Installation.
- In Sites, click Install manually.
- Click Copy to clipboard.
- Paste the code right after the opening <body> tag on every page of your website or app.
Note: Because the tools serve different purposes, install each script in a different location:
- Cookie Information → <head>
- Piwik PRO → <body>
Make sure each script is placed in the correct section of your website.
See our Piwik PRO help center for guides on customizing your setup and setting up tags and reports.
- Done. The Piwik PRO container is installed on your website.
Connect Piwik PRO with Cookie Information
To connect Piwik PRO with Cookie Information, follow these steps:
- In Piwik PRO, go to Administration.
- In Sites & apps, pick the site or app you created in step 4 of the Install Piwik PRO section.
- Navigate to Privacy.
- In Consent, turn on Ask visitors for consent.
- In Consent settings, click View.
- Turn on Use a custom consent form.
Note: If you created your Piwik PRO account through the Piwik PRO website, you can skip the next steps and your integration is ready.
- Now you’ll need to set up a Cookie Information tag in Piwik PRO. Go to Menu > Tag Manager.
- In Tags, click Add a tag.
- In Add a tag, choose the tag template: Cookie Information.
- Click Next.
- Name your tag, for instance, Cookie Information.
- In Consent mapping, map Cookie categories to Consent types.
- 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 Reset consent in Cookie Information > Settings > Ask for consent again.
- This option will reset consent for all domains in this consent solution. The consent popup will be shown again to all visitors. Use this only if you’ve made changes that require new consent from returning users, like updates to cookie purposes, legal basis, or vendors. This is a one-time action.
- In Consent type, make sure the type is set to: No consent is required.
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.
- In Advanced tag settings, turn off Respect opt-out and DNT. This tag should fire for every visitor since it only maps their consents.
- In Tag triggers, select Choose existing trigger.
- Select the following trigger: All page views.
- Click OK to save the trigger.
- Click Add to add the tag.
- Test your tag in debug mode.
- When the tag works correctly, click Publish.
- All set! Your Piwik PRO and Cookie Information setup is ready.
