This page is also available in English (Englisch)

Wie mache ich…?

  1. How do I make Piwik faster?
  2. How do I import Google Analytics data in Piwik?
  3. How do I exclude traffic from an IP or a range of IP addresses?
  4. How do I exclude URL query parameters from the URLs tracked, and from Pages reports?
  5. How do I set the time zone for my reports?
  6. How do I specify the currency used in the Goals revenue reports?
  7. How do I specify which websites to load by default in Piwik?
  8. How to specify the date used by default in Piwik reports?
  9. How do I control the categories tree structure in the Page URLs and Page titles reports?
  10. After the top 500 or top 1000 rows, Piwik automatically groups pages, keywords, websites, etc. under the label "Others"; How can I force Piwik to not limit the data?
  11. How do I force the reports to be re-processed from the logs?
  12. How do I force Piwik login to use SSL (https)?
  13. Wie kann man in Piwik Fehlerseiten (404 Seiten) aufzeichnen lassen? Welche URLs lösen einen 404-Fehler aus und welche Seiten verlinken auf diese?
  14. How do I track visits on my intranet?
  15. How do I automatically login my users in Piwik when they go from my CMS to Piwik?
  16. How do I enable users to login into Piwik inside an iframe?
  17. How do I delete all statistics for a given websites, or for all websites?
  18. How do I set some of my website directories or pages to not be tracked?
  19. How do I get reports for a custom date range?
  20. How do I change the default email address "From:" in PDF reports emails?
  21. How do I send Piwik emails using Gmail SMTP server?
  22. On a Windows server using IIS, the pages "Default.aspx" and "default.aspx" are tracked as different pages, but they are the same. How do I force Piwik to record them as the same page?
  23. How do I track my RSS/Atom feed subscribers?
  24. How do I momentarily disable Piwik User Interface and/or Piwik visitor Tracking?
  25. How do I enable "Unique Visitors" metric for Yearly reports and for Custom Date Ranges?
  26. How do I setup Piwik to track multiple websites without revealing the Piwik server URL which appears in the Javascript code in all websites?
  27. How do I enable third party tracking cookies, as well as the existing first party cookies?
  28. How do I customize the Piwik Campaign parameters pk_campaign and pk_kwd?
  29. How do I configure outgoing (forward) proxy in Piwik (eg. squid)?
  30. How do I exclude / ignore my traffic from Piwik?
  31. I forgot my password or username, how do I reset my password?

Antworten

  1. How do I make Piwik faster?

    By default, Piwik reports are processed when you request them in the User Interface. Please see How to setup auto archiving of your reports every night? to automate the generation of Piwik reports. See also How long does the Piwik archiving process? for expected speed for high traffic websites.

  2. How do I import Google Analytics data in Piwik?

    It is possible to migrate your Google Analytics data in Piwik and access your historical reports. Check out this blog post about google2piwik.

  3. How do I exclude traffic from an IP or a range of IP addresses?

    To exclude all traffic from a given IP or IP range, log in Piwik as the Super User. Click on Settings > Websites. Below the list of websites, you will find the option to specify "Global list of Excluded IPs". You can define a given IP address, or IP ranges (132.4.3.* or 143.2.*.* for example) to be excluded from being tracked on all websites.

    Each Piwik admin user can also specify the list of IPs or IP ranges to exclude for specific websites.

  4. How do I exclude URL query parameters from the URLs tracked, and from Pages reports?

    It is commong that websites use URLs query parameters or session ID parameters that are not relevant to data analysis (unique ID, meaningless parameter). You can easily ignore a number of parameters from the URLs, and prevent them from appearing in the "Actions > Pages" report. Login as the Super User, go to Settings > Manage Websites > Global list of Query URL parameters to exclude field. Each Piwik admin user can also exclude query parameters for specific websites, by entering them in the Excluded Parameters list for this website, in Settings > Websites.

  5. How do I set the time zone for my reports?

    By default, websites use the UTC time zone. You can specify the time zone to use for each website in the Websites admin panel. Note that changing the website's timezone will only affect data going forward.

  6. How do I specify the currency used in the Goals revenue reports?

    By default, Piwik reports revenues in $ US dollars. Piwik Super User can specify the currency to use for the Goals reports, for each website, in the Websites admin panel.

  7. How do I specify which websites to load by default in Piwik?

    Each user can specify which websites should be loaded in Piwik. Alternatively, users can choose to load the "All websites" dashboard, which gives an overview of the status and evolution of all websites available to the user.

  8. How to specify the date used by default in Piwik reports?

    By default, Piwik will load reports for "yesterday". Each Piwik user can specify, in their "User settings" admin panel, the date to load by default in Piwik reports: "Today", "Current week", "Current month", or "Last 7 days", "Last 30 days", "Yesterday", etc.

  9. How do I control the categories tree structure in the Page URLs and Page titles reports?

    By default, Piwik will report your Page URLs and Page titles in 'categories', automatically constructed based on the slash character / as a delimiter.
    For example, a Page with a URL "http://example.org/about/contact" will be reported under the category "about" in the Page URLs report. When you click on it it will open the pages inside this category, and show the stats for the subpage "contact". This feature is very useful because it helps visualize which sections of your website have the most traffic, rather than having all your page URL at the same level.

    This grouping feature is also very useful with Page Titles. You can use it for tracking custom flash events ("game / clickStart", "game / registerNewUser"), video events ("videos/ bestOf2011 / start", "videos/ bestOf2011 / pause"), simply organize your pages into a easier to analyse structure, etc.

    In the Piwik Javascript tracking code, you can specify custom page titles by calling piwikTracker.setDocumentTitle() (Learn more about the JS Tracking API). For example, to track a custom page view when a user clicked on a button in your web app, you could write piwikTracker.setDocumentTitle("ajax/click view button");
    piwikTracker.trackPageView();

    You can also customize the delimiter to use for splitting your page URLs and Page titles into categories (or disable the feature by setting the delimiter to a character not in use in your Page titles). Edit your config/config.ini.php file, and set the following:
    [General]
    action_title_category_delimiter = ::

    You can then define your custom page names as follows: piwikTracker.setDocumentTitle("Products :: Gardening :: Seeds id=123"); and your pages and categories will be grouped according to the :: delimiter.

  10. After the top 500 or top 1000 rows, Piwik automatically groups pages, keywords, websites, etc. under the label "Others"; How can I force Piwik to not limit the data?

    For performance reasons, Piwik will by default only archive the first top 500 pages, top 1000 keywords, top 1000 websites, Custom Variables, etc. Piwik will then sum all the remaining pages, keywords, etc. under the label "Others".
    If you wish to archive all the data, or simply archive more than the current rows limit, you can override these values in the configuration file config/config.ini.php. For example, to limit all table to 5000 entries, add the following in config/config.ini.php:
    [General]
    ; maximum number of rows for any of the Referers tables (keywords, search engines, campaigns, etc.), and Custom variables names
    datatable_archiving_maximum_rows_referers = 5000
    ; maximum number of rows for any of the Referers subtable (search engines by keyword, keyword by campaign, etc.), and Custom variables values
    datatable_archiving_maximum_rows_subtable_referers = 5000
    ; maximum number of rows for any of the Actions tables (pages, downloads, outlinks)
    datatable_archiving_maximum_rows_actions = 5000
    ; maximum number of rows for pages in categories (sub pages, when clicking on the + for a page category)
    datatable_archiving_maximum_rows_subtable_actions = 5000

  11. How do I force the reports to be re-processed from the logs?

    In some very rare cases, it might be useful to force Piwik to re-process the reports from the original logs. By default, reports will only be processed once (preferably with an automatic cronjob setup to run every hour) and then archived in the database. When you visit the Piwik UI for a previous day (or week, month, etc), all you see is pre-processed data read directly from these archive tables.

    It is possible to force Piwik to re-process your reports:

    • To reprocess reports for a specific day, or specific period, you can delete the two Mysql tables piwik_archive_* for the specific month containing the dates to re-process. To delete the tables, you can use a tool such as phpMyAdmin which is usually provided by your web host.
    • To reprocess archiving for all reports for all dates, delete all piwik_archive_* tables in the Piwik Mysql Database. The next time you visit the Piwik UI, it will automatically detect that the archives are missing, re-create the tables, and re-trigger the archiving.
    • Alternatively, you can edit your config/config.ini.php file, and set [Debug]
      always_archive_data_day=1       to force archiving of the daily reports, and/or [Debug]
      always_archive_data_period=1       to force archiving for all period reports (week, month, year). If you then visit the Piwik UI for a given date, reports will be re-processed. When you are done, do not forget to set these values back to 0
      [Debug]
      always_archive_data_day=0
      always_archive_data_period=0

    Note: reprocessing reports using the logs requires that the feature 'Delete old logs' has not been used on your Piwik server.

  12. How do I force Piwik login to use SSL (https)?

    If you want to secure logins so that passwords are not sent in the clear, you can manually set a config file setting. Your Piwik server needs to be configured so that requests to https://yourserver.com/piwik/index.php work as expected.

    In your config/config.ini.php file, add the following under the [General] section:
    [General]
    force_ssl_login=1

    This will force all Piwik logins and passwords to be sent over https/SSL.

  13. Wie kann man in Piwik Fehlerseiten (404 Seiten) aufzeichnen lassen? Welche URLs lösen einen 404-Fehler aus und welche Seiten verlinken auf diese?

    Pages regularly appear and disappear on websites, other websites might link to wrong URLs on your website, etc.
    You can track with Piwik which URLs are leading to a 404, and which referer pages link to 404 on your website.

    • Setup a custom 404 page: you can easily do this if you use a CMS (for example, in wordpress, all 404 pages are loading a custom 404 template). If you don't use a CMS, you can usually specify a 404 custom page in your webserver configuration file.
    • Add the Piwik tracking code in this custom 404 page. In the Javascript tracking code, add the following: piwikTracker.setDocumentTitle('404/URL = '+String(document.location.pathname+document.location.search).replace(/\//g,"%2f") + '/From = ' + String(document.referrer).replace(/\//g,"%2f"));
      after the line var piwikTracker = Piwik.getTracker(...) and before the line piwikTracker.trackPageView();
    • In your Piwik report, in Actions > Pages Titles, you will now have a new entry for the 404 pages. It will also list the full URL of the 404 pages, as well as all referers leading to this page. Enjoy!

  14. How do I track visits on my intranet?

    Piwik can track visits on your intranet website as long as Piwik itself is hosted in your intranet.

    To make sure that all unique visitors are tracked correctly in your intranet, please edit your config/config.ini.php and add the following:
    [Tracker]
    trust_visitors_cookies = 1
    This will ensure that even if all visitors have the same IP, browser configuration, OS, etc. they will be counted as unique visitors based on the first party cookies. If not set, you will see a lower number of visits.

  15. How do I automatically login my users in Piwik when they go from my CMS to Piwik?

    Some Piwik users automatically provide their CMS customers with Piwik statistics. If you want to provide a one-click automatic login to Piwik for your users, you can use the 'logme' mechanism, and pass their login & the md5 string of their password in the URL parameters:
    /pathpiwik/index.php?module=Login&action=logme&login=your_login&password=your_MD5_password
    This will log the user (create a cookie in their browser) and redirect to the index.php on succesful login. We advise to do this authentication over HTTPS. Note that this authentication method doesn't work for the Super User.
    You can also specify the URL to redirect after a successful login, if different from the default Piwik dashboard page:
    /pathpiwik/index.php?module=Login&action=logme&login=your_login&password=your_MD5_pwd&url=http://piwik.mycompany.com/subpath/

    You can also specify an idSite (website ID) to load by default after the redirect:
    /pathpiwik/index.php?module=Login&action=logme&login=your_login&password=your_MD5_pwd&idSite=145

  16. How do I enable users to login into Piwik inside an iframe?

    By default, the Piwik login screen will not load in iframe, as a security measure to prevent clickjacking. You can manually enable Piwik login screen to work from inside an iframe by adding the following config file setting in your config/config.ini.php:

    [General]
    enable_framed_logins = 1

    Instead of loading the login screen in an iframe, you might want to use the logme() method to automatically log your users in Piwik remotely.

  17. How do I delete all statistics for a given websites, or for all websites?

    It is possible to keep all the websites information (names, defined goals, etc.) and only delete the stored analytics data. There is currently no tool available to delete all data automatically, but you can manually delete all data for a specific website in Mysql.
    Connect to your Mysql database storing your Piwik data with your favorite client (for example phpMyadmin) and do the following:

    • Remove completely the tables with a name starting with piwik_archive_* DROP TABLE piwik_archive_numeric_2011_01, piwik_archive_numeric_XX; They will automatically be re-created from the Visitor logs when Piwik processes your reports.
    • Execute the following query: DELETE FROM piwik_log_visit WHERE idsite = X with X replaced by the website ID you wish to reset.

  18. How do I set some of my website directories or pages to not be tracked?

    If you wish to set some specific pages or directories to not be tracked by Piwik, we recommend that you modify the Piwik Javascript Tracking code, and replace tracker.trackPageView(); by if (!window.location.pathname.match(/^/(admin|login)//))
    {
    tracker.trackPageView();
    }

    In this example, all URLs except the ones containing "/admin/" or "/login/" will be tracked by Piwik.

  19. How do I get reports for a custom date range?

    Piwik reports on days, weeks, months and years, and you can also specify a Custom Date Range in the Calendar.
    Click on the calendar, then on "Date Range". Now select on the left calendar the starting date for the range, and in the right calendar the end date of the range. Piwik will process in real time the reports for the requested date range.

    In the Analytics API, you can also get reports for a custom date range. For example, to request any report for the range "Feb 15th - Feb 25th", you would use the parameters: &period=range&date=2011-02-15,2011-02-25

  20. How do I change the default email address "From:" in PDF reports emails?

    You can edit the default noreply@yourdomain.com email address that will appear in the PDF reports emails by editing the configuration file config/config.ini.php, and adding under the [General] section, the following line:
    noreply_email_address = "info@example.org"

    All reports by email will now be sent from "info@example.org"

  21. How do I send Piwik emails using Gmail SMTP server?

    You can configure Piwik to use GMAIL as the mailserver. To do so, login as Super User, go to Settings > General Settings, and configure the form as follows:

    • Use SMTP server for e-mail: YES
    • SMTP server address: smtp.gmail.com
    • Authentication method for SMTP: Login
    • SMTP username: your gmail username
    • SMTP password: your gmail password
    • SMTP encryption: SSL

    All Piwik emails (Scheduled PDF Reports, Password reset confirmation, etc.) will now be sent using Gmail servers.

  22. On a Windows server using IIS, the pages "Default.aspx" and "default.aspx" are tracked as different pages, but they are the same. How do I force Piwik to record them as the same page?

    In your Piwik Javascript Tracking tag, add the following line:
    piwikTracker.setCustomUrl(location.href.toLowerCase());
    just before the line:
    piwikTracker.trackPageView();

    All your pages will now be tracked as lowercase, eg. "Default.aspx" or "DEFAULT.aspx" will be tracked as "default.aspx".

  23. How do I track my RSS/Atom feed subscribers?

    In the Piwik dashboard, you can add the 'Feedburner' widget. Feedburner is a service that publishes your RSS/Atom feeds, and tracks statistics about how many users are registered to the feed, how many view each article, and how many clicks there are on each entry. You must register on feedburner.com and publish your feed (there is a step-by-step instruction). Once you have published your feed, click on "Publicize" > "Awareness API" - activate this option, and then put your feed's name in the Piwik Feedburner widget. You should now see your feed usage statistics in the Piwik dashboard!
    The Widget will give you a few metrics:

    • Reach: Reach is the total number of people who have taken action — viewed or clicked — on the content in your feed.
    • Circulation: Circulation is an approximate measure of the number of users who requested your feed. This is the "Readership count".
    • Hits: Hits are a raw measure of request traffic for your feed. This metric includes automated bots requests, visitors viewing the feed but not subscribing, etc.

  24. How do I momentarily disable Piwik User Interface and/or Piwik visitor Tracking?

    Before a Database upgrade on a high traffic Piwik server, it is highly recommended to:

    • disable Piwik Tracking: in the config/config.ini.php, add the following [Tracker]
      record_statistics = 0
      This will cause all Piwik Tracking requests to return quickly the 1*1 gif beacon, without connecting to the Database or doing any processing.
    • disable the Piwik User Interface: you can also disable the User Interface, which will display a maintenance message instead of the standard Piwik UI. If you run the Piwik Database Upgrade script using the shell/console command, we highly recommend to turn Piwik off while the upgrade is in process. Disabling the Piwik User Interface will prevent other users from accessing Piwik while the Database upgrade is in process.
      To do so, add the following in the config file:[General]
      maintenance_mode = 1
      When maintenance_mode is on, the API is also disabled. For example, the XML message returned is:

      <?xml version="1.0" encoding="utf-8" ?>
<result><error message="Piwik is in scheduled maintenance. Please come back later." /></result>

    When the Piwik update is finished, do not forget to re-enable Visit Tracking and/or the User Interface.

  25. How do I enable "Unique Visitors" metric for Yearly reports and for Custom Date Ranges?

    By default Piwik will not process the number of Unique Visitors for Years and Custom Date Ranges for performance reasons. The query to process the number of unique visitors is quite costly and takes seconds or even minutes to run on a High traffic Piwik server.
    You can decide to enable the metric by adding the following in your config/config.ini.php [General]
    enable_processing_unique_visitors_year_and_range = 1

    Note: processing the Unique Visitors metrics is using the Piwik logs. This requires that the feature "Delete old logs" is not used on your Piwik server.

  26. How do I setup Piwik to track multiple websites without revealing the Piwik server URL which appears in the Javascript code in all websites?

    By default, the Piwik Javascript code on all tracked websites contains the Piwik server URL. This is fine for most users, but someone (eg. a competitor) could run a script that would look at thousands or millions of websites and search for your Piwik server URL in the source code of these websites. This person could then find out all websites tracked in your Piwik instance.
    In some cases you might want to hide this Piwik URL completely while still tracking all websites in your Piwik instance. It is possible to do by modifying your Piwik Javascript code, and point it to a "proxy piwik.php script" instead of your Piwik server URL. This piwik.php script has to be uploaded on each of the websites tracked, and will automatically "forward" all requests to your secret Piwik server.

    Note: when you use this technique, the feature to exclude visits via the ignore cookie will not work.

  27. How do I enable third party tracking cookies, as well as the existing first party cookies?

    In some cases, it might be interesting to enable third party cookies, so that a same visitor will get the same ID across all your domains and subdomains. Piwik doesn't report cross sites visits at this stage, so you will benefit from using third party cookies only if you run manual queries against Piwik database. To enable 3rd party cookies, edit your config/config.ini.php and add the following lines:
    [Tracker]
    use_third_party_id_cookie = 1
    When this is enabled, Piwik tracker will serve a third party cookie containing an id visitor (16 chars ID). This ID will be the same for this visitor across all websites, and is stored in the database field "idvisitor".

  28. How do I customize the Piwik Campaign parameters pk_campaign and pk_kwd?

    By default, tracking campaigns in Piwik involves adding the required parameter pk_campaign (and optional parameter pk_kwd) to the URLs pointing to your website. Piwik also supports Google Analytics campaign parameters (utm_*).

    It is also possible to customize these parameter names. For example, we would like to use the parameters names "campaign" (instead of pk_campaign) and "keyword" (instead of pk_kwd). To do so, there are two required steps:

    • 1) Customize the parameters in the Javascript. In the Javascript snippet on all your pages, add the following before the trackPageView() call:piwikTracker.setCampaignNameKey('campaign');
      piwikTracker.setCampaignKeywordKey('keyword');
      Note that these two functions also accept an array of strings, if you wanted to handle more than one parameter.
    • 2) Set the parameters in the config file. In your config/config.ini.php, add the following: [Tracker]
      campaign_var_name="campaign"
      campaign_keyword_var_name="keyword"
      Note that you can specify a comma separated list of campaign parameters, if for example, if you wanted to handle more than one parameter.

  29. How do I configure outgoing (forward) proxy in Piwik (eg. squid)?

    It is possible to configure a forward outgoing proxy in Piwik, so that all outbound Internet connections (eg. to check for new versions of Piwik, for SEO plugin, Feedburner plugin, etc.) go through the proxy. Check the FAQ Configure Outgoing proxy for more details.

  30. How do I exclude / ignore my traffic from Piwik?

    There are 2 ways to tell Piwik to exclude and ignore your traffic:

    • Set the 'ignore cookie': Login in Piwik, click on Settings, and then click on the Ignore cookie link to set the cookie in your browser
    • If you use a static IP, or to ignore all traffic from a given IP or IP range, check this faq.

  31. I forgot my password or username, how do I reset my password?

    To reset your password in Piwik, go to Piwik: below the login screen you will find a link "Lost your password?". After clicking the link, enter your Piwik username or Email address, and a link to reset your password will be sent to your email address.
    Note: for security reasons, it is not possible to recover passwords, but only change them. We highly recommend to use a strong password and to enable automatic SSL for login screen in your Piwik server.

Entries (RSS)