readme.txt 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257
  1. === Google Analytics Dashboard for WP by ExactMetrics (formerly GADWP) ===
  2. Contributors: chriscct7, smub
  3. Donate link: http://www.wpbeginner.com/wpbeginner-needs-your-help/
  4. Tags: analytics,google analytics,google analytics dashboard,google analytics plugin,google analytics widget,gtag
  5. Requires at least: 3.5
  6. Tested up to: 4.9
  7. Stable tag: 5.3.5
  8. Requires PHP: 5.2.4
  9. License: GPLv2 or later
  10. License URI: http://www.gnu.org/licenses/gpl-2.0.html
  11. Connects Google Analytics with your WordPress site. Displays stats to help you understand your users and site content on a whole new level!
  12. == Description ==
  13. This Google Analytics for WordPress plugin enables you to track your site using the latest Google Analytics tracking code and allows you to view key Google Analytics stats in your WordPress install.
  14. In addition to a set of general Google Analytics stats, in-depth Page reports and in-depth Post reports allow further segmentation of your analytics data, providing performance details for each post or page from your website.
  15. The Google Analytics tracking code is fully customizable through options and hooks, allowing advanced data collection like custom dimensions and events.
  16. = Google Analytics Real-Time Stats =
  17. Google Analytics reports, in real-time, in your dashboard screen:
  18. - Real-time number of visitors
  19. - Real-time acquisition channels
  20. - Real-time traffic sources details
  21. = Google Analytics Reports =
  22. The Google Analytics reports you need, on your dashboard, in your All Posts and All Pages screens, and on site's frontend:
  23. - Sessions, organic searches, page views, bounce rate analytics stats
  24. - Locations, pages, referrers, keywords, 404 errors analytics stats
  25. - Traffic channels, social networks, traffic mediums, search engines analytics stats
  26. - Device categories, browsers, operating systems, screen resolutions, mobile brands analytics stats
  27. In addition, you can control who can view specific Google Analytics reports by setting permissions based on user roles.
  28. = Google Analytics Tracking =
  29. Installs the latest Google Analytics tracking code and allows full code customization:
  30. - Universal Google Analytics (analytics.js) tracking code
  31. - Global Site Tag (gtag.js) tracking code
  32. - Enhanced link attribution
  33. - Remarketing, demographics and interests tracking
  34. - Page Speed sampling rate control
  35. - User sampling rate control
  36. - Cross domain tracking
  37. - Exclude user roles from tracking
  38. - Accelerated Mobile Pages (AMP) support for Google Analytics
  39. - Ecommerce support for Google Analytics
  40. User privacy oriented features:
  41. - IP address anonymization
  42. - option to follow Do Not Track (DNT) sent by browsers
  43. - support for user tracking opt-out
  44. Google Analytics Dashboard for WP enables you to easily track events like:
  45. - Downloads
  46. - Emails
  47. - Outbound links
  48. - Affiliate links
  49. - Fragment identifiers
  50. - Telephone
  51. - Page Scrolling Depth
  52. - Custom event categories, actions and labels using annotated HTML elements
  53. With Google Analytics Dashboard for WP you can use custom dimensions to track:
  54. - Authors
  55. - Publication year
  56. - Publication month
  57. - Categories
  58. - Tags
  59. - User engagement
  60. Actions and filters are available for further Google Analytics tracking code customization.
  61. = Google Tag Manager Tracking =
  62. As an alternative to Google Analytics tracking code, you can use Google Tag Manager for tracking:
  63. - Google Tag Manager code
  64. - Data Layer variables: authors, publication year, publication month, categories, tags, user type
  65. - Exclude user roles from tracking
  66. - Accelerated Mobile Pages (AMP) support for Google Tag Manager
  67. = Accelerated Mobile Pages (AMP) features =
  68. - Google Tag Manager basic tracking
  69. - Google Analytics basic tracking
  70. - Automatically removes <em>amp/</em> from Google Analytics tracking page URL
  71. - Scrolling depth tracking
  72. - Custom dimensions tracking
  73. - User sampling rate control
  74. - Form submit tracking
  75. - File downloads tracking
  76. - Affiliate links tracking
  77. - Hashmarks, outbound links, telephones and e-mails tracking
  78. - Custom event categories, actions and labels using annotated HTML elements
  79. = Google Analytics Dashboard for WP on Multisite =
  80. This plugin is fully compatible with multisite network installs, allowing three setup modes:
  81. - Mode 1: network activated using multiple Google Analytics accounts
  82. - Mode 2: network activated using a single Google Analytics account
  83. - Mode 3: network deactivated using multiple Google Analytics accounts
  84. > <strong>Google Analytics Dashboard for WP on GitHub</strong><br>
  85. > You can submit feature requests or bugs on [the Google Analytics Dashboard for WP by ExactMetrics Github repository](https://github.com/awesomemotive/Google-Analytics-Dashboard-for-WP).
  86. == Installation ==
  87. 1. Upload the full google-analytics-dashboard-for-wp directory into your wp-content/plugins directory.
  88. 2. In WordPress select Plugins from your sidebar menu and activate the Google Analytics Dashboard for WP plugin.
  89. 3. Open the plugin configuration page, which is located under Google Analytics menu.
  90. 4. Authorize the plugin to connect to Google Analytics using the Authorize Plugin button.
  91. 5. Go back to the plugin configuration page, which is located under Google Analytics menu to update/set your settings.
  92. 6. Go to Google Analytics -> Tracking Code to configure/enable/disable tracking.
  93. == Frequently Asked Questions ==
  94. = Do I have to insert the Google Analytics tracking code manually? =
  95. No, once the plugin is authorized and a default domain is selected the Google Analytics tracking code is automatically inserted in all webpages.
  96. = Some settings are missing in the video tutorial =
  97. We are constantly improving Google Analytics Dashboard for WP, sometimes the video tutorial may be a little outdated.
  98. = How can I suggest a new feature, contribute or report a bug? =
  99. You can submit pull requests, feature requests and bug reports on [our GitHub repository](https://github.com/awesomemotive/Google-Analytics-Dashboard-for-WP).
  100. = Documentation, Tutorials and FAQ =
  101. For documentation, tutorials, FAQ and videos check out: [Google Analytics Dashboard for WP by ExactMetrics documentation](https://exactmetrics.com/).
  102. == Screenshots ==
  103. 1. Google Analytics Dashboard for WP Blue Color
  104. 2. Google Analytics Dashboard for WP Real-Time
  105. 3. Google Analytics Dashboard for WP reports per Posts/Pages
  106. 4. Google Analytics Dashboard for WP Geo Map
  107. 5. Google Analytics Dashboard for WP Top Pages, Top Referrers and Top Searches
  108. 6. Google Analytics Dashboard for WP Traffic Overview
  109. 7. Google Analytics Dashboard for WP statistics per page on Frontend
  110. 8. Google Analytics Dashboard for WP cities on region map
  111. 9. Google Analytics Dashboard for WP Widget
  112. == Localization ==
  113. You can translate Google Analytics Dashboard for WP on [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/google-analytics-dashboard-for-wp).
  114. == License ==
  115. Google Analytics Dashboard for WP it's released under the GPLv2, you can use it free of charge on your personal or commercial website.
  116. == Upgrade Notice ==
  117. == Changelog ==
  118. [GADWP v5.3 release notes](https://exactmetrics.com/adding-gtag-js-to-your-site/)
  119. = 5.3.5 =
  120. * Bug Fixes:
  121. * Re-tagging release to fix a deployment issue.
  122. = 5.3.4 =
  123. * Enhancements:
  124. * Adds more robust settings to control various ExactMetrics configuration warnings.
  125. * Adds the ability to opt-into usage tracking.
  126. = 5.3.3 =
  127. * Bug Fixes:
  128. * Updated endpoint for GA auth to use updated system.
  129. * Fixed a bug where the opt-out and exclude DNT options were listed twice.
  130. = 5.3.2 =
  131. * Bug Fixes:
  132. * fixes for user opt-out feature
  133. * Enhancements:
  134. * use <em>gadwp_useroptout</em> shortcode to easily generate opt-out buttons and links, [more details](https://exactmetrics.com/google-analytics-gdpr-and-user-data-privacy-compliance)
  135. * adding <em>gadwp_gtag_commands</em> and <em>gadwp_gtag_script_path</em> hooks to allow further gtag (Global Site Tag) code customization
  136. * adds opt-out and DNT support for Google Tag Manager
  137. = 5.3.1.1 =
  138. * Bug Fixes:
  139. * avoid tracking issues by not clearing the profiles list on automatic token resets
  140. = 5.3.1 =
  141. * Bug Fixes:
  142. * frontend_item_reports PHP notice when upgrading from a version lower than v4.8.0.1
  143. = 5.3 =
  144. * Enhancements:
  145. * adds full support for Global Site Tag (gtag.js)
  146. * remove Scroll Depth functionality, since this is now available as a trigger on Google Tag Manager
  147. * adds custom dimensions support for AMP pages with Google Tag Manager tracking
  148. * adds support for button submits
  149. * Bug Fixes:
  150. * form submit events were not following the non-interaction settings
  151. = 5.2.3.1 =
  152. * Bug Fixes:
  153. * fixing a small reporting issue
  154. = 5.2.3 =
  155. * Enhancements:
  156. * add Google Analytics user opt-out support
  157. * add option to exclude tracking for users sending the <em>Do Not Track</em> header
  158. * add System tab to Errors & Debug screen
  159. * check to avoid using a redeemed access code
  160. * Bug Fixes:
  161. * remove a debugging message
  162. * cURL options were overwritten during regular API calls
  163. = 5.2.2 =
  164. * Enhancements:
  165. * more informative alerts and suggestions on the authorization screen
  166. * disable autocomplete for the access code input field to avoid reuse of the same unique authorization code
  167. * GADWP Endpoint improvements
  168. * Error reporting improvements
  169. * introducing the gadwp_maps_api_key filter
  170. * Bug Fixes:
  171. * use the theme color palette for the frontend widget
  172. = 5.2.1 =
  173. * Enhancements:
  174. * avoid submitting empty error reports
  175. * Bug Fixes:
  176. * fixes a bug for custom PHP cURL options
  177. = 5.2 =
  178. * Enhancements:
  179. * improvements on exponential backoff system
  180. * introduces a new authentication method with endpoints
  181. * multiple updates of plugin's options
  182. * code cleanup
  183. * improvements on error reporting system
  184. * option to report errors to developer
  185. * move the upgrade notice from the Dashboard to plugin's settings page
  186. * enable PHP cURL proxy support using WordPress settings, props by [Joe Hobson](https://github.com/joehobson)
  187. * hide unusable options based on plugin's settings
  188. * Bug Fixes:
  189. * some thrown errors were not displayed on Errors & Debug screen
  190. * analytics icon disappears from post list after quick edit, props by [karex](https://github.com/karex)
  191. * fix for inline SVG links, props by [Andrew Minion](https://github.com/macbookandrew)
  192. * fixes a bug on affiliate events tracking
  193. The full changelog is [available here](https://exactmetrics.com/changelog-google-analytics-dashboard-for-wp/).