=== Google Analytics for WordPress by MonsterInsights ===
Contributors: chriscct7, smub
Donate link: http://www.wpbeginner.com/wpbeginner-needs-your-help/
Tags: analytics, analytics dashboard, google analytics, google analytics dashboard, google analytics widget, universal google analytics, statistics, tracking, stats, google, yoast, google analytics by yoast, ga, monster insights, monsterinsights, universal analytics, web stats, ecommerce, ecommerce tracking
Requires at least: 3.9
Tested up to: 4.8.1
Stable tag: 6.2.4
License: GPL v3
The best Google Analytics plugin for WordPress. See how visitors find and use your website, so you can keep them coming back.
== Description ==
= Google Analytics Plugin for WordPress =
We believe that you shouldn't have to hire a developer to add Google Analytics to your website. That's why we built MonsterInsights, a complete Google Analytics for WordPress plugin that's EASY and POWERFUL.
MonsterInsights allow you to connect your WordPress website with Google Analytics, so you can see how visitors find and use your website, so you can keep them coming back. Simply put, we show you the stats that matter.
With almost 15 million downloads, MonsterInsights is the most popular Google Analytics plugin for WordPress.
At MonsterInsights, user experience is our #1 priority. That's why we make it extremely easy for you to connect and view your Google Analytics reports from inside your WordPress dashboard. Our tracking settings and workflows make MonsterInsights the most beginner friendly google analytics plugin in the market.
> MonsterInsights Pro
> This plugin is the lite version of the MonsterInsights Pro plugin that comes with all the analytics features you will ever need including ads tracking, ecommerce tracking, custom dimensions tracking, popular post tracing, events tracking, and tons more. Click here to purchase the best Google Analytics plugin for WordPress now!
We took the pain out of connecting with Google Analytics and made it easy. Here's why over 1 million smart business owners, designers, and developers love MonsterInsights, and you will too!
https://www.youtube.com/watch?v=nHZBUDceRt0
= Quick & Easy Google Analytics Setup =
Easily setup Google Analytics on your site without touching any code. If you can point-and-click, then you can use MonsterInsights.
Google Analytics for WordPress plugin by MonsterInsights allows you to track your blog visitors easily and always stays up to date with the newest features in Google Analytics.
>It just works. Really easy way to insert Google Analytics tracking code and keep it there when switching themes. No need to copy/paste code anywhere. This is the best way to handle Google Analytics in WordPress.
> Steven Gliebe
= Google Analytics Dashboard + Real Time Stats =
MonsterInsights makes analytics easy. You can see your site’s performance at a glance with our Google Analytics Dashboard right inside your WordPress admin area.
With Google Analytics, there's no need to wait till the next day to find out about traffic spikes or potential problems. You can get real time stats, so you can unlock the maximum potential revenue for each customer.
>Works everytime! This plugin has worked with every version of WordPress I’ve ever used. Very reliable.
>Vineeta
= Universal Tracking + Page Level Analytics =
MonsterInsights uses universal tracking, so you can track your users across devices and platforms. With demographics and interest reports, you also get a better understanding of your audience.
The page level analytics show you exactly which pages and sections on your website are the most popular.
You can also see how the users are finding your website, so you can better focus your marketing efforts.
>Analytics for PROs! This plugin brings it all, great features and helpful info to easily see what you are doing.
> Frank van der Sluijs
= eCommerce and Ads Tracking =
MonsterInsights Ecommerce addon helps you add Google Analytics Ecommerce tracking to your WordPress WooCommerce and Easy Digital Downloads store.
You can add eCommerce tracking with literally 1 click, and start tracking popular products, average order value, ecommerce conversion rate, and more.
With our Ads tracking addon, publishers can easily track the performance of their Google Adsense inside their Google Analytics dashboard.
= Custom Dimensions, Events Tracking, and More =
MonsterInsights allow you to take full advantage of all the powerful Google Analytics features such as custom dimensions, file download tracking, outbound link tracking, events tracking, performance tracking, and more.
>I like how simple it is for client users and how I can turn on the advanced features for myself to get all the details right.
> Skip Shean
= Full MonsterInsights Feature List =
* Quick and Easy Setup - Easily setup Google Analytics for WordPress with just a few clicks (no coding needed)
* Real Time Stats - See real time stats inside your Google Analytics dashboard.
* Universal Tracking - Get better insights with Google Analytics' universal tracking.
* Google Analytics Dashboard - See the stats that matter from right inside your WordPress dashboard.
* Ecommerce Tracking - Add Google Analytics tracking for WooCommerce and Easy Digital Downloads store.
* Ads Tracking - Track your Google Adsense ads with Google Analytics.
* File Download Tracking - Enable file download stats with just a click.
* Link Tracking - Track your outbound link clicks with Google Analytics.
* Events Tracking - Track custom button and banner clicks with Google Analytics.
* Custom Dimensions Tracking - Enable Google analytics custom dimensions tracking for WordPress.
* Author Tracking - See who's the most popular author with Author tracking.
* Popular Post Tracking - See which blog post and section is the most popular.
* Custom Post Type Tracking - Track the performance of your custom post types.
* Referral Tracking - See how visitors are finding your website to better focus your marketing efforts.
* Performance Tracking - Control the performance rate and sample rate for your Google Analytics report.
* Enhanced Link Attribution - Get better analytics with enhanced link attribution.
* Google Analytics Tools - Helpful tools for Google analytics.
* Want us to add something else? Suggest a feature and we'll get it added!
>Simple, yet powerful. Amazing piece of plugin, does exactly what expected and even more.
> Matt Jaworski
= Popular Google Analytics Tutorials =
* How to setup Google Analytics with WordPress
* How to Login to Google Analytics
* How to Start a WordPress Blog (step by step)
= Note for Beginners =
Like all WordPress plugins, Google Analytics by MonsterInsights is only available for self-hosted WordPress sites. This means you will need to switch from WordPress.com to WordPress.org if you want to use this plugin on your WordPress site.
For more details, see this infographic on self hosted WordPress.org vs free WordPress.com
= Credits =
This plugin is created by Chris Christoff and Syed Balkhi with sponsorship from WPBeginner.
= What's Next =
If you like this plugin, then consider checking out our other projects:
* OptinMonster - Get More Email Subscribers
* Soliloquy - Best WordPress Slider Plugin
* Envira Gallery - Best WordPress Gallery Plugin
* WPForms - Best WordPress Contact Form Plugin
This plugin would not be possible without the help and support of WPBeginner, the largest WordPress resource site. You can learn from our free WordPress Tutorials like how to install WordPress, choose the best WordPress hosting, WordPress glossary, and more.
You can also learn about other best WordPress plugins.
== Installation ==
1. Install Google Analytics for WordPress by MonsterInsights either via the WordPress.org plugin repository or by uploading the files to your server. (See instructions on how to install a WordPress plugin)
2. Activate Google Analytics for WordPress by MonsterInsights.
3. Navigate to the Insights tab in your WordPress admin menu and configure the plugin.
4. Want more features? Purchase MonsterInsights Pro!
== Changelog ==
= 6.2.4: October 6, 2017 =
* Tweak: Adjusted how the optin tracking is sent to us.
= 6.2.3: September 9, 2017 =
* Tweak: Added a notice for new users of MonsterInsights about when the reports will begin populating.
= 6.2.2: August 16, 2017 =
* Tweak: Adjusted order of setup/config notices
* Fix: Fixed an issue with the sanitation of number fields. Solves an issue with the Google Optimize extension.
= 6.2.1: August 9, 2017 =
* New: MonsterInsights now has the ability to automatically update itself and it's addons. You can set MonsterInsights to automatically update minor versions only or all new versions inside the MonsterInsights settings panel in Tracking -> Permissions.
* Tweak: Introduce scrollbars on GA auth screen for users with many Google accounts
* Tweak: Added notice to users still on deprecated GA.js tracking and PHP-based events tracking.
* Fix: Issue with notices having multiple icons has been resolved.
* Fix: Facebook Instant Articles can now properly handle the Automattic Facebook plugin transformation changes (requires FB IA addon version 1.0.1 or newer)
* Fix: Conflict with wp_head output for some themes.
* Fix: Correct level for Forms and Google Optimize addons.
* Fix: License key errors will no longer show to lite users.
= 6.2.0: June 6, 2017 =
* New: Form Tracking addon
* New: Google Optimize addon
* New: Facebook Instant Articles addon
* New: Telephone link tracking
* New: Functions for supporting enhanced eCommerce tracking in the eCommerce addon
* New: Measurement protocol functions
* New: Tweaks for the settings pages to get ready for a speed improvement release upcoming along with some coming soon addons.
* Tweaks: Spelling corrections.
* Fix: Internet Explorer tracking fix.
* Fix: Issue with initialization of settings on certain installs.
= 6.1.11: May 31, 2017 =
* Tweak: Renamed the tools tab for settings import/export
* Bugfix: Issue with saving of manual UA codes
* Bugfix: Fixed a couple display issues in the admin
* Bugfix: Issue for undefined index when the settings array hasn't been initialized.
= 6.1.10, May 18, 2017 =
* New: Performance improvement in tracking.
= 6.1.9, May 15, 2017 =
* New: Plugin has been tested for compatibility with WordPress 4.8-beta1. We'll continue to test through the beta and release candidates, but MonsterInsights is 4.8 ready as-is.
* Tweak: Deleting lite plugin will no longer delete license key of installed pro version.
* Bugfix: Import/export settings page has been fixed so that on sites with a ton of plugins installed that make lots of admin bar items, the admin bar will have relative positioning now to allow it to be scrollable.
* Bugfix: Users with more than 1 property for the same domain name can now use any of the views for those properties.
* Bugfix: For Pro users, sometimes all available addons for your license level didn't show, requiring you to download them from our site. This has been corrected.
= 6.1.8, May 11, 2017 =
* New: Functions needed to support future features including enhanced eCommerce
* Bugfix: Compatibility with Firefox for link tracking.
* Bugfix: Issue saving certain fields.
= 6.1.7, April 10, 2017 =
* New: Changes needed to support new addons, including the Google AMP addon, available as of today.
* Tweak: Comments for frontend are minification-safe.
* Tweak: GA notice is now hidden when debug mode is on.
* Tweak: All settings now use the Settings API framework, including all addons.
= 6.1.6, March 29, 2017 =
* New: Select2 filter for the Google oAuth list of profiles, to make it easier to find your Google property by fully supporting search by URL.
* Tweak: Inbound-as-external now is prioritized before downloads in tracking preference order.
= 6.1.5, March 24, 2017 =
* New: Added some functions to prepare for upcoming new addon (Google AMP) and updates (eCommerce, Performance, Dimensions).
* Tweak: JS events tracking for click events.
= 6.1.4, March 23, 2017 =
* Tweak: JS events tracking for click events.
* Bugfix: Edge case where JS events tracking won't turn on if the main tracking setting was disabled (such as faulty import).
= 6.1.1 - 6.1.3 (depending on which version of MI you have), March 22, 2017 =
* Bugfix: (pro users) Issue with JS events throwing an error for array on non-set settings.
= 6.1.0, March 22, 2017 =
* New: Campaign URL building tool with shortlink capability.
* New: Settings import/export tool.
* New: Experimental (beta) hash tracking for single-page style themes. Note, as the description for the setting says, this feature is a beta feature, and can be tweaked or removed in upcoming versions.
* New: Manual default subsite UA's can now be set from the network settings panel for MonsterInsights.
* New: Optout of GA tracking is now enabled per Google standard. See https://github.com/awesomemotive/google-analytics-for-wordpress/issues/488 for more information.
* Tweak: Notices about JS conflicts now include the JS error when possible.
* Tweak: Some tweaking to when the "Connection error with Google" error is displayed during oAuth.
* Tweak: Notice now shown when too early to display statistics from Google.
* Tweak: Inbound as outbound links may now have a period in them.
* Tweak: Removed duplicate option checking on frontend.
* Tweak: oAuth dialog now only programically closes when the select profile view is shown or when a new one is opened.
* Tweak: Mailto links are now handled as an externally opening link, allowing to bypass issues with the Safari browser not following standards.
* Tweak: WP-Admin Login page tracking has been removed.
* Tweak: More countries now shown in the country map in the overview report.
* Tweak: License key field is no longer shown on lite installs.
* Tweak: Frontend JS file has been refactored to make it more unit testable.
* Bugfix: Download events now correctly include data in all cases not just some.
* Bugfix: A syntax error involving the manual UA code input has been resolved that could have affected some users under a rare circumstance.
= 6.0.16, March 7, 2017 =
* Fixed: Issues related to link tracking.
= 6.0.15, March 7, 2017 =
* Fixed: Issue with translation string numbering in the disabled user group frontend template.
* Fixed: Resolved issue that caused issue with lightbox-style redirects.
* Fixed: Issue where admin pages had JS issues from mis-ordered JS files.
= 6.0.14, March 1, 2017 =
* Tweak: Allow for invalid license to be removed if debug turned on.
* Fixed: Issues with internal links being tracked as internal-as-outbound
* Fixed: Issues with tracking of downloads
* Fixed: Issue where optin tracking would opt-out on settings panel save
= 6.0.13, February 28, 2017 =
* Tweak: Better detection of issues with authentication due to an outdate WP version.
* Fixed: Issue where JS tracking inadvertantly turned on debug mode due to a bad string to boolean conversion.
= 6.0.12, February 27, 2017 =
* New: The JS events tracking has been moved to a new JS file instead of inline. This will offer the same performance as inlining under HTTP/2, but with the benefit of better cache bursting.
* New: Expanded admin adblock detection.
* Tweak: Select2 is now bundled as Select300 in MonsterInsights. We're pulling down the latest copy of Selct2 and then on-the-fly renaming it. This should end any conflicts between our select2 boxes and other plugins/themes.
* Tweak: We've implemented better error detection on the authentication flow. Some users may have previously seen "No profile errors", due to issues with their server setup will now see more accurate errors.
* Tweak: For servers that use PHP Object caching, the cache will now be flushed during the uninstall routines. This should solve a very rare uninstall error.
* Fixed: A "Invalid UA code" error was displayed whenever someone used oAuth2 and then saved the settings panel, despite having a valid UA code.
* Fixed: An issue with the lazyloading of the Google Client for frontend use has been fixed.
= 6.0.11, February 24, 2017 =
* Notice: Version numbers 6.0.5 - 6.0.10 were not used, as we're synching the version numbers of the Lite and Pro versions of our plugin. You didn't miss any updates.
* Notice: As of this release, we no longer backport changes to the old `yst_ga` option. If you need to access MonsterInsights's settings programically, please use our helper functions. Do not directly access a option.
* New: Redesigned authentication dropdown that shows the site urls to make it easier to find a profile when the users have many accounts.
* New: Tracking is now enabled for the WordPress admin login page (wp-login.php).
* Tweak: The Google class in the admin now only checks for blocking when the reauth is attempted. Expect to save a ton of external calls in the admin, and maybe a performance boost.
* Tweak: The GA client object is now lazyloaded on the frontend, so it's loaded only when something (like another plugin) attempts to use it. In plain English, this will make a alot of sites load times significantly improve.
* Tweak: The analytics.js output has been tweaked to be slightly more asthetically pleasing (its aligned correctly). We realize no one probably cares but we look at this code for every user we support, so it help us.
* Tweak: The config expired notice has been updated to reflect that it can also be shown if the server is blocking MonsterInsights's ability to connect to Google Analytics.
* Tweak: The cron jobs for opt-in tracking and statistics have been combined into a single cron.
* Tweak: Various performance improvements in the frontend output class.
* Tweak: A notice is now shown when MonsterInsights rejects a manual UA code from being saved for being an invalid format.
* Fixed: Issue where the plugin TweetShare would prevent users from being able to see their properties in the authentication dropdown.
* Fixed: Issue where the manual UA code might not be ported as we were backporting changes to the monsterinsights_settings option to the yst_ga option for backwards compatibility. This lead to a situation where the new settings would override the old ones before the routine to fix the manual UA code issue had run.
* Fixed: Issue where a fatal error from a reference to a class called "Yoast_Frontend_GA" which our plugin doesn't have or use, would be shown caused by the previous Yoast usage of object caching via an autoloader. This is solved by doing a 1 time object cache flush on upgrade.
* Fixed: Issue where if you had more than 1000 profiles on your Google account, not all would be shown.
* Fixed: App analytics properties are now excluded from the dropdown of properties you can authenticate to.
* Fixed: The readme suggested a filter to use for filtering the UA to use, but the filter name was typo'd. This has been fixed.
* Fixed: Issue where the tracking cron would add a new unique cron each day.
* Fixed: We implemented a routine to cleanup those extra crons as well as the old yoast one we no longer use.
* Fixed: Issue where the .org theme Schema would prevent users from being able to see their properties in the authentication dropdown.
* Fixed: Issue where JS based events tracking might not correctly track a mailto: link.
= 6.0.4, February 20, 2017 =
* Tweak: monsterinsights_delete_options now checks to ensure an array is passed in
* Tweak: The reporting class now has many more object property checks.
* Fixed: In install if WP version not supported or if MI Pro was active, the plugin attempted to call a property of the plugin object which didn't exist.
* Fixed: In the deactivate/uninstall routines, MI attempted to use a method of a class object which might not exist, as it might not be the active instance. Better instance handling has been added as well as many more exists checks have been added througought the plugin.
* Fixed: Conflicting loads when both MI Pro and Lite are installed. Note, you should only have Pro installed if you want to use it. That being said, we've done extensive testing to ensure we've handled all of the edge cases surrounding this. This could also lead to issues where it would be impossible to remove Lite and/or Pro from a site if both were installed.
* Fixed: Conflicts with the Pinnacle theme, which loads it's CSS file (with overrides to literally all select2 inputs not just the ones it adds) across the entire admin. This lead to an issue where in the Google Auth, a user might not have been able to see (or could appear with wacky styling) the dropdown of profiles to select. If you cannot see this dropdown after authenticating, let us know as its most likely a simple plugin or theme conflict on CSS styling.
* Fixed: The notices to deactivate/uninstall MI Lite/Pro when the other one were installed had an errant extra quotation mark, and they're now more specific about the action to take.
* Fixed: For some users, the setting for user role exclusion was not working. This has been corrected.
* Fixed: A redirect issue that was looping for some users. The code that does this, while working for most, doesn't for some. We've removed it until a full investigation can be completed.
= 6.0.3, February 20, 2017 =
* Fixed: Path for fontawesome font files was incorrect
* Fixed: Notice in the install routine for the $version variable not being set.
= 6.0.2, February 19, 2017 =
* Fixed: Upgrade routine could drop manual UA codes in certain cases. If you upgraded to 6.0.0 or 6.0.1 and it lost the manual UA code, installing this update will automatically restore the UA code entered as long as you haven't used the oAuth or re-entered the manual UA code.
= 6.0.1, February 19, 2017 =
* Fixed: Typo that caused an issue with PHP 7 installs.
= 6.0.0, February 18, 2017 =
* New: Completely overhauled design, from top to bottom. The plugin has been completely rewritten.
* New: **no more advertisements** in the settings pages. We hated them too.
* New: Javascript based event tracking
* New: ga.js is now officially deprecated. New users cannot use it anymore, and existing users can only switch to analytics.js (but not back). Please note, all new features will be developed exclusively for analytics.js. Google has deprecated it, and now we're deprecating our support for it.
* New: License key system now uses the MonsterInsights License management system
* New: Ability to pick which roles can access the dashboard/reports & settings/addons/tools page using our UI. There's also a new custom capability for this (a meta capability)
* New: Support for Google Analytics Master accounts. When you oAuth into MonsterInsights now, the UA view is now locked to what you picked using the brand new oAuth procedure.
* New: Revamped dashboard
* New: Completely new settings system, with a completely new settings page, and a completely new settings API. Also some new hooks and tabs in preparation for the many addons we'll be releasing over the next few months.
* New: No more conflicts between the base plugins
* New: Completely overhauled translation experience. The lite version translations are now fully managed through translations.wordpress.org.
* New: Opt-in to anonymous data so we can better improve MonsterInsights
* New: Significantly better addons page
* New: Single license key to manage all MonsterInsights extensions.
* New: Automatic detection of blocked asset files (from things like un-whitelisted uBlock Origin) with step by step directions on how to easily correct.
* Tweak: Completely overhauled the ga.js and analytics.js outputs to fix outstanding bugs.
* Tweak: Better debugging + disabled + preview tracking modes, that more clearly indicate what's going on
* Tweak: Completely overhauled PHP regex tracking to solve nearly a dozen outstanding bugs including issues where non-link elements starting with the letter "a" such as tags would get parsed as links causing issues. Also solves issues related to single versus double quote usage for existing onclick handles, non-semicolon terminating onclick handles and various other parsing issues.
* Tweak: Many previously untranslatable strings are now translatable.
* Tweak: Minified in-plugin images.
* Tweak: Minified admin css and js
* Tweak: Uses latest version of Google PHP API now.
* Tweak: The system for creating reports and getting Google Analytics reports have changed. If you've hardcoded into Yoast functions previously not designed for frontend output this could cause problems. We'll introduce an API intended for this type of use after we update to use the v4 reporting API.
* Fix: Fixed an issue with HostEurope and other hosts modifying the default PHP arg seperator.
* Fix: Prevents an issue where users with a plugin like Airplane Mode active will get a better error message than "code invalid" on the GA token auth screen (and also fixes how that detection is done in other parts of the plugin).
* Removed: unused track_full_url setting
= 5.5.3, October 3rd, 2016 =
* New: Announces MI 6.0 beta.
* Fix: Compatibility with PHP compatibility scanner's bug
= 5.5.2, July 7, 2016 =
* Tweak: Updates license manager to have more reliable update information including better compatibility with Yoast SEO products.
* Fix: Compatibility with upcoming Shiny Updates v2 in WP core
= 5.5.0, May 1, 2016 =
* New: Added new System Info tab for faster support.
* Fix: Issue with changelog missing some deployed versions.
= 5.4.9, April 15, 2016 =
* New: Font based dashboard icon
* Tweak: The "MonsterInsights" menu item name has been renamed to just "Insights"
* Fix: Issue with eCommerce addon (also requires user to update eCommerce addon)
* Fix: Issue with 2 dashboard links
* Fix: A bug in pre-existing code caused the menu of the plugin to skyrocket unintentionally. This has been corrected.
= 5.4.8, April 14, 2016 =
* New: Google Analytics by Yoast is now MonsterInsights.
* Fix: Compatibility issue with WordPress 4.5
== Upgrade Notice ==
= 6.0.0 =
This is a major release. Please back up your site before upgrading.
== Frequently Asked Questions ==
For all frequently asked questions, and their answers, check the [MonsterInsights Knowledge base](https://www.monsterinsights.com/docs/).
== Screenshots ==
1. Reporting area
2. Google Authentication wizard
3. Settings page
4. Custom Dimensions (a Pro feature)
5. eCommerce Tracking (a Pro feature)