About site or app settings

For each site or app, you can change settings for data collection, privacy and reports. In this article, we’ll go over each of these settings.

To change site or app settings, follow these steps:

Available from version 16.0.0. For versions below 16.0.0, see this section.

1. Go to Menu > Administration.
2. Navigate to Sites & apps.
3. On the left, pick the site or app you want to set up.
4. Navigate to Data collection.
   

   

   In Data collection, you can change the following settings:

   Basic info

   • Site or app address: Your site or app address. If you’re collecting data from a few domains with the same tracking code, add all addresses here.
   • Time zone: We’ll show data in reports in this time zone.
   • Currency: We’ll use this currency for goal revenue. 

   Page scrolling

   • Available from 16.17.0 Measure scroll depth: If turned on, you’ll monitor how far visitors are scrolling on your pages. Scroll data is sent as custom events. For reporting, you’ll need to set up a custom report. Note: If you’re tracking page scrolls with your own custom events, we recommend removing them, otherwise scroll events will be tracked twice.

   Internal search engine

   • Keywords from your internal search engine: To collect search data, add parameters used by your search engine. You’ll see keywords and categories under Analytics > Reports > Internal search. Note: Some internal search engines don’t use parameters. In such cases, we can’t collect search data.
   • Remove keyword parameters from page URLs: When turned on, we’ll collect keyword data from your internal search engine, and then remove parameters from links. 

   Page URLs

   • Remove parameters from page URLs: Without parameters, you’ll see cleaner page URLs in reports. But if parameters hold some important information like keyword, referrer, campaign name, you’d better keep them. Note: The added parameters are case-sensitive.
   •  Keep anchors in page URLs: When turned on, you’ll see page URLs with anchors in reports. This can help you analyze how visitors use anchor links on your site. Tip: Anchors help users get to a specific point on the page without scrolling. Example: #details is an anchor in this link example.com/pricing#details

   Campaigns

   • Campaign parameters: You can collect campaign data based on listed parameters. Here you can change those parameters.
   • Start a new session when the campaign changes: When a campaign changes during the session, we’ll begin a new session for this visitor. This will help you collect data for all campaigns: the first one and the changed ones.

   Filters

   • Don’t collect data from these IP addresses: You can stop collecting data from added IP addresses. Use wildcards like 1.2.3.* or 1.2.*.* to deny traffic from a group of IP addresses
   • Don’t collect data from known crawlers: If turned on, we won’t collect data from known crawlers. We don’t collect any data from bots by default.
   • Add crawlers: We’ll block added crawlers along with known crawlers. Use a user agent name or full user agent string to define crawlers.
   • Collect data only from known sites: If turned on, you’ll collect data only from sites with web addresses added under Site or app address. This can protect your data from spam coming from unknown web addresses.

   SPA

   • Available from 16.19.0 Track page views in a single-page application: If turned on, we’ll record each browser history state change on a page and report it as a page view in reports. Note: If you notice that a page view is recorded twice on a page load, turn on this setting: Tag Manager > Piwik PRO tag (tracking code) > Other options > Track page views manually. Tip: For more advanced setups, we recommend using our tracking libraries.

   Session limits

   • Available from 17.6.0 Max session duration: Max value: 12h 0m 0s.
   • Available from 17.6.0 Max events in a session: Min value: 1. Max value: 65535.
   • Available from 17.6.0 If session limits are exceeded: (1) Close the session and exlude the next matching events or (2) Create a new session. 

   Note: The session that goes over the limit is closed. The next matching events start a new session or are excluded and don’t reach the reporting engine.

   Other options

   • Delay loading the next page: This tiny delay happens when a visitor clicks on a button or submits a form. It gives tags time to fire on the next page.
   • Start a new session when the referrer changes: If turned on, when a referrer changes during the session, we’ll begin a new session for this visitor. This will help you collect data for all referrers: the first one and the changed ones.
5. Navigate to Privacy.
   

   

   In Privacy, you can change the following settings:

   Consent

   • Ask visitors for consent (on): If turned on, you’ll display a consent form on your site. You can also set up the following elements:
     • When visitors don’t consent:
       • Collect data using a 30-minute cookie:  You’ll use a 30-minute cookie to collect session data. You won’t recognize new and returning visitors, but you’ll get data on the visitor’s country. Visitors’ IP addresses will be fully masked.
       • Collect data without using cookies: You won’t create or store any cookies on visitors’ browsers. Nothing will be stored on visitors’ devices. You won’t recognize new and returning visitors, but you’ll get data on the visitor’s country. Visitors’ IP addresses will be fully masked.
       • Don’t collect data: The tracking code won’t be fired for visitors.
     • Ask for consent in countries under the GDPR and UK GDPR: If turned on, we’ll show the form only to visitors from countries under the GDPR and UK GDPR. We’ll use visitors’ IP addresses to recognize countries.
     • Consent is valid for: The cookie storing consent preferences will expire after this time, and your form will ask a visitor for consent again.
     • Share consent between subdomains: You can add subdomains to share consent between them. Enter a full URL or use a wildcard like *.example.com.
     • Use a custom consent form: This consent form overrides those from Consent Manager. You can add it via the JavaScript API. Read more
   • Ask visitors for consent (off): If turned off, you’ll collect data without consent. For this setting, you can turn two options on or off: a session ID and visitor cookies. If you turn both off, each event will be treated as a new session and you won’t recognize visitors.
     • Use a session ID: If turned off, you won’t use a session ID that recognizes a session based on a visitor’s device or browser settings. Each session has a unique session ID, which can only identify individual sessions and never identifies visitors.
     • Use visitor cookies: If turned off, you won’t set visitor cookies like _pk_id.* and _pk_ses.* that are responsible for recognizing visitors and their sessions.
   • Comply with CNIL guidelines: If turned on, we’ll hide the session log report (Analytics > Reports > Session log) and the tracker debugger (Analytics > Settings > Tracker debugger). We’ll also show a warning message when a user tries to create API keys. The session log report will also be hidden on meta sites/apps that contain a site with this setting turned on. Read more
   • Available from 16.11.0 Don’t collect visitor’s device data: If turned on, you won’t read screen resolution and browser plugins from a visitor’s device without consent. Accessing visitor’s device is not compliant with the German Data Protection Act (TTDSG) and similar privacy laws.

   IP addresses

   • Available from 17.6.0 Collect visitors’ IP addresses: When you collect visitors’ IP addresses, you can know their location, like their country or city. But if you decide to turn off this feature, you won’t have access to such data. Also, a session ID that relies on IP addresses will be less accurate.
   • Mask IP addresses: If turned on, we’ll remove the selected number of bytes from the address before saving it to the database. Nobody will ever see the full address. IP masking helps keep visitor data private.
   • Collect from unmasked IP addresses (All location data, City, Region, or Continent): We’ll take this data from unmasked IP addresses before we mask them. You’ll always see masked IP addresses in reports.
6. Navigate to Reports.
   

   

   In Reports, you can change the following settings:

   • Show ecommerce reports: If turned on, you’ll see these reports under Analytics > Ecommerce. Before you collect any ecommerce data, you need to set up tracking. Read more
   • Show SharePoint reports: If turned on, you’ll see these reports under Analytics > SharePoint. Before you collect any SharePoint data, you need to set up the integration. Read more

Settings in versions below 16.0.0

Here’s a list of site or app settings for versions below 16.0.0. You can find these settings by going to Administration > Websites & apps.

• URL: Your site or app address. If you’re collecting data from a few domains with the same tracking code, add all addresses here.
• Time zone: We’ll show data in reports in this time zone.
• Currency: We’ll use this currency for goal revenue.
• Page redirect delay: A millisecond delay before a page is redirected to another page after a visitor clicks on a button or submits a from. Used to give tags time to fire.
• Ask visitors for consent:
  • If turned on, you’ll display a consent form on your site. You can edit the form by going to Consent Manager. In this mode, you can set other options for collecting data. Read more
  • If turned off, you’ll collect data without consent. In this mode, you can turn on or off two options: use cookies and use device fingerprinting.
• Comply with CNIL guidelines: When turned on, we’ll hide the session log report (Analytics > Reports > Session log) and tracker debugger (Analytics > Settings > Tracker debugger). We’ll also show a warning message when a user tries to create API keys. Read more about CNIL guidelines.
• Whitelist page URLs: When enabled, the tracker will block tracking request sent from different domains than added to: General settings > URLs. Use this option to protect your reporting from spam. Note: Before enabling this option, add all domains you want to track to General settings> URLs. Otherwise, data from domains that you have not added will not be collected.
• Keep page URL fragments when tracking: Let’s you keep URLs with fragments like #bottom. When turned off, the URL will look like this clearbank.com instead of clearbank.com#bottom.
• Internal search engine tracking: Allows to track queries that people type in the search engine on your website. You might need to add query parameters to the list to make it work properly.
• Ecommerce tracking: Allows to track ecommerce data and show it in reports.
• Exclude IP addresses: Lets you exclude tracking data from a given IP address, for example the IP in your office. To exclude, you can use the wildcard, for example 54.217.*.* or 54.217.240.*.
• Exclude URL parameters: Lets you exclude parameters from the URL, making your reports look cleaner. For example, instead of the URL that looks like this clearbank.com/?_stg_debug you’ll see the URL that looks like this clearbank.com. Note: Regex (regular expression) is supported. The added parameters are case-insensitive.
• Exclude browsers: Lets you add the user-agent string used by the browser that you want to exclude from tracking.