Installation & Maintenance Configuration Analytics Features Analytics features (Premium) Videos Installation & Maintenance Piwik RequirementsRequired Configuration to Run PiwikRecommended ConfigurationMySQL User requirementsRecommended Web Hosts Piwik Installation & OptimizationGet Piwik Up and RunningOptimize & Secure PiwikMaintain Piwik Installing PiwikGetting StartedStart the InstallationThe 5-minute Piwik InstallationThe Welcome ScreenSystem CheckMySQL Database SetupSuper UserSet up Your First WebsiteInstall the JavaScript Tracking TagCongratulations!Configuring PiwikMedium and High-Traffic Websites: Setup an automated task (cron) to process reports Piwik IntegrationIntegrate Piwik with your CMS, Ecommerce Software, and MoreExport your data: Analytics Widgets Analytics API: fetch your data, integrate users, websites and more Customize Piwik Optimize and Scale PiwikWhat infrastructure do I need to run Piwik?Configure Piwik for speedGet Professional SupportMove your Piwik to the Cloud Managing your database’s sizeDeleting old unprocessed dataDeleting old reportsManually triggering a data purgeViewing reports about how your Piwik database size is used Update PiwikThe One-Click Piwik UpdateStep 1: Set Write Permissions on the Piwik folder with FTPClick on the Alert Box in PiwikRead the Message and Click Update AutomaticallyWatch the magic!Treat YourselfThe Manual Three-Step Update1) Back up your Configuration File2) Replace the Piwik files with the latest version3) Update PiwikDatabase Upgrade for High Traffic Piwik ServersNeed help to update your Piwik to the latest version?Troubleshooting Configuration Data Limits – No Limits Manage WebsitesAdd a WebsiteUpdate and Delete WebsitesTrack Subdomains & Multiple Domain NamesAll Websites DashboardThe All Websites Dashboard in Email ReportsEmbedding the All Websites Dashboard in your appCommon Questions Manage UsersCreate UsersManage User Access to WebsitesManage Super UsersAdvanced User Management Manage Email ReportsCreate and schedule a reportDownloading and sending your custom reports by emailSending Scheduled reports on Time Geo Locate your visitorsEnabling Accurate Visitors Geolocation in Piwik AnalyticsReports: Continent, Country, Region, City & ProviderMaintaining GeoIP DatabasesDetails & Resources How to Set up Auto-Archiving of Your ReportsLinux/Unix: How to Set up a Crontab to Automatically Archive the Reports.Windows: How to Set up Auto-Archiving Using Windows SchedulerCPanel: How to Set up the Cron Script Using CPanelWeb Cron When Your Web Host Does Not Support Cron TasksImportant Tips for Medium to High Traffic WebsitesDisable browser triggers for Piwik archiving and limit Piwik reports to updating every hourIncrease PHP Memory LimitMore High Traffic Server Tips!More Information About Piwik ArchivingHelp for core:archive command Piwik Analytics API Tracking APIJavascript client for Tracking APITracking API ClientsTracking API ReferenceUse case: Tracking data using the php clientImage Tracker codePiwik Tracking API (Advanced users)More information How to use Log Analytics toolRequirementsDifferences using Log Analytics VS using Javascript clientHow to: run the Log File analysis script with default optionsHow to: import more data including bots, static files, and HTTP errors trackingHow to: exclude some particular log linesFrequently Asked Questions Configure Privacy Settings in PiwikStep 1) Automatically Anonymize Visitor IPsStep 2) Delete Old Visitors LogsStep 3) Include a Web Analytics Opt-Out Feature on Your Site (Using an iFrame)Step 4) Respect DoNotTrack preferenceStep 5) Create a Privacy Policy page on your website(s)Step 6) Optional Privacy Preferences How to configure Piwik for securityTips that will help you keep your Piwik secureList of best practices for the professional Piwik administrator How to configure Piwik for speed Include & Customize Piwik for your Projectconfig/config.ini.php: The Piwik Config Filebootstrap.php: Execute Custom Code Before Piwik RunsLoad Piwik PHP classes and Call the API in PHPphp.ini and .htaccess notesUse a custom plugin, or build your own Embedding Piwik Reports in Other Websites or AppsChange User PermissionsEmbed a Piwik report in a HTML pageEmbed the Piwik dashboard in a HTML pageEmbed the full Piwik app anywhereEmbed a static image graph of your analytics dataCustomising the widgetsMaking Piwik reports data publicly available Analytics Features A Tour of PiwikPiwik OverviewSelect a Date RangeA Look at a Piwik ReportDashboard & WidgetsCreating and customizing a new DashboardGraphs (Data Visualization)Inline helpFlattening reportsDetailed historical report about any data pointApplying Custom Segments to filter VisitorsVideos Showing the Power of Piwik! Track Goals and Measure ConversionsWhat is a Goal in Piwik?Examples of Useful GoalsCreate a GoalGoal Overview ReportGoal Detailed ReportReport Analysis: What are the Top Converting Segments?Conversion Funnel Analysis Ecommerce AnalyticsEnable Ecommerce TrackingUsing a Piwik plugin for your Ecommerce SoftwareEcommerce Analytics reportsEcommerce Activity OverviewBest Products & Best CategoriesEcommerce Activity logSales by Marketing channelSales by country, city, regionPurchased products historical performanceEcommerce Metrics in Standard ReportsEcommerce trackingTracking Ecommerce Orders & Items Purchased (required)Tracking Add to Cart & Items Added to the Cart (optional)Tracking Product Page Views & Category Page Views (optional)Advanced Ecommerce Statistics API Row Evolution – View and compare historical dataAccessing the Row Evolution ReportNavigating the Row Evolution ReportComparing multiple row evolutionsRecording your insights Segmentation – Compare segments of visitorsCreating a segment in PiwikSwitching between segmentsRemoving segmentsUsing segments in e-mail reportsUseful segments you can createCustom segment: CustomersCustom segment: Returning customersCustom segment: Bounced visitsCustom segment: Mobile visitorsCustom segment: CommentersCustom segment: Visits from the region your business is located inCustom segment: Everyone who doesn’t bounceDetermining what to segmentFiguring out how to segment based on your objectivesFiguring out how to segment based on your dataSegments API Reference Event TrackingAnatomy of EventsViewing Events ReportsTracking EventsJavascript trackEvent()Tracking Events with HTTP APIRequesting Events report dataOther interactions Content TrackingViewing Content Tracking reportsContent Name reportContent Piece reportRequesting Content Tracking report dataTracking ContentTracking Content with HTTP API Site Search Tracking and ReportingEnable Site Search Tracking for your WebsiteTracking Site Search KeywordsTrack Site Search using URL Parameters (default)Track Site Search using the Javascript trackSiteSearch() functionTrack Site Search using the Tracking API (advanced users only)Tracking No Result Search KeywordsSite Search Analytics ReportsView the Detailed Searches for each VisitorNumber of searches and keywords over timeUnderstand How Site Search is Used to Find other Pages on your Site Visitors Maps – World, region, cityWorld Map showing Visits on forum.piwik.org by CountryVisitor Map showing Visits by RegionMap showing visits by CityHow to change the metric being plotted on the Map?World Map WidgetTroubleshooting Real Time Visitor World MapExample of the World map showing VisitorsDiscover the power of the Visitors Map!Visitor Maps WidgetAbout the maps Real Time AnalyticsThe Real Time Live! WidgetVisitor LogVisitor ProfileReal Time Analytics APIAbout Visitors’ Privacy The Visitor ProfileLaunching the Visitor ProfileVisitor Profile reportFeature OverviewAdvanced UsesDeveloper APISummary Site speed and Page speedOverall Website SpeedIndividual Page Generation SpeedMaking sure your website stays fastTracking page speed with each visit Transitions – Analyze the previous and following actions of your visitors for each pageHow to Open the Transitions Report for a Page?Understanding the Page Transitions ReportUsing & Interacting with the Transitions ReportConclusionResources Page Overlay – Visitors Click MapHow to Open Page Overlay for a Page?Understanding the User InterfaceConclusionPage Overlay Troubleshooting1. It doesn’t work at all2. Some links don’t have the bubbles3. I get the error “The Page Overlay session couldn’t be launched yet”4. I have multiple domains and it doesn’t show all data5. I have a high traffic website and it takes a long time until the bubbles appear Custom Variables AnalyticsWhat is a Custom Variable?When not to use Custom Variables?Tracking a Custom VariableCustom Variable ReportingCustom Variables in the Visitor LogUsage of your Custom Variables slotsData Limits for Custom VariablesReferences Custom DimensionsWhat is a Custom Dimension?Installing Custom DimensionsCreating Custom DimensionsTracking a Custom DimensionCustom Dimension ReportingManaging Custom DimensionsUsing extractions to set a custom dimension valueDeactivating a DimensionSegmenting a Custom Dimension by Action typeData Limits for Custom DimensionsLearn more User IDAbout User IDImplementing User IDWhat is a User ID string?How do I generate a User ID?User ID with the JavaScript clientUser ID with another Tracker API clientUser ID with direct Tracker API accessUser ID reportBenefits of User IDHow requests with a User ID are trackedResources Annotating your dataWhy would I want to create annotations?Creating and editing annotationsThe Annotations API Tracking Campaigns – Analytics PiwikAnalytics Campaign TrackingTracking Campaigns using URL ParametersCampaign URL GeneratorGoals & Ecommerce Campaign AttributionAttribution data is saved in a first party cookieFAQ: Tracking campaignsTracking more than two campaign dimensionsTracking Paid Search Ads URL Builder – Marketing Campaign Tracking Help resourcesUser guidesGlossaryFrequently Asked QuestionsDeveloper guidesUser TrainingCustom developmentFree supportEnterprise support subscriptions Analytics features (Premium) FunnelsViewing Funnel ReportsManaging your FunnelsConfiguring a funnelValidating a funnelActivating a FunnelFAQ Session RecordingsViewing Session RecordingsSession Recording ReportApplying segmentsReplaying a recorded sessionPlaying a recorded session from the Visitor LogManaging your Session RecordingsCreating and editing a session recordingAdvanced optionsTracking session recordingsFAQ Media AnalyticsViewing Media Analytics ReportsOverviewReal-time reportsDetailed Video and Audio reportsAudience Log & Audience MapTracking Videos & AudioFAQ HeatmapsViewing HeatmapsClick MapMouse Move / Hover MapScroll MapAbove the foldApplying segmentsDevicesManaging your HeatmapsCreating and editing a HeatmapAdvanced optionsTracking heatmapsFAQ A/B TestingViewing Experiment ReportsManaging your ExperimentsCreating an experimentAdjusting an experiment to your needsStarting your experimentFinishing your experimentArchiving your experimentEmbedding / Tracking an experimentFAQ Form AnalyticsViewing Form ReportsOverviewReal-time ReportsForm ReportsForm SummaryPage URL reportField reportsDrop Off FieldsDifferent VisualizationsRow evolutionEntry fieldsField timingsField sizeMost used fieldsMost correctedUnneeded fieldsApplying segmentsManaging your FormsCreating and editing a formMatching your formsRestricting the tracking to certain pagesDefining form conversionsTracking your online and web formsFAQ Roll-Up ReportingWhen to use a Roll-Up siteManaging Roll-UpsViewing reports of Roll-UpsVisitor log and real time reportsRoll-Up site’s visitor log shows users across websitesReal time widget showing users across the Roll-Up websites Search Engine Keywords PerformanceViewing Search Keywords ReportsCombined KeywordsKeywords for Google Search, Google Images and Google VideosKeywords for Bing and Yahoo! SearchKeywords position in search engine over timeViewing Search Bots Crawl Overview reportsHow to import Google Search keywords in PiwikHow to set up Google Search Console and verify your websiteHow to set up Google OAuth Client configHow to import Bing and Yahoo! search keywords into Piwik?FAQ Users FlowViewing the Users Flow visualizationViewing the most popular paths and visitor engagementApplying segments Login with SAML AuthenticationInstallationRequirementsInstallationConfigurationSAML plugin settingsStatus SettingsIdentity Provider SettingsOption settingsAttribute Mapping SettingsAccess Synchronization settingsManaging Access for Multiple Piwik InstancesUsing a custom access attribute formatAdvanced SettingsDebuggingHow does SAML plugin for Piwik work?SP-initiated SSO authentication processIdP-initiated SSO authentication processSP-initiated Single Logout authentication process (SLO enabled)IdP-initiated Single Logout authentication process (SLO enabled)Security Considerations Videos [Video] Welcome to Piwik Analytics [Video] How to Install Piwik Analytics Video [Video] Learn all about Piwik’s Analytics Features [Video] How to Configure Settings in Piwik Analytics [Video] Learn about your Visitors [Video] Referrers Reports [Video] Actions Reports [Video] Tracking Goals [Video] Email and SMS Reports