-
Notifications
You must be signed in to change notification settings - Fork 7
/
readme.txt
589 lines (464 loc) · 21.5 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
=== Analytics Insights - Google Analytics Dashboard for WordPress ===
Contributors: deconf
Donate link: https://deconf.com/donate/
Tags: WordPress analytics, google analytics, google analytics dashboard, google analytics widget, Website Analytics
Requires at least: 3.5
Tested up to: 6.6
Stable tag: 6.3.8
Requires PHP: 5.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
A full-featured and entirely free Google Analytics Dashboard plugin for WordPress. Displays stats to help you to better understand your site content.
== Description ==
Analytics Insights is a free WordPress plugin that enables site tracking using the latest Google Analytics 4 tracking code. It allows you to view key Google Analytics stats in your WordPress Dashboard.
= Google Analytics Reports, Stats and Insights =
Analytics Insights displays the reports you need on your dashboard and on the site's frontend. Audience, acquisition, behavior, engagement and real-time stats are all presented as charts within a dedicated dashboard widget.
In addition to a set of general Google Analytics stats, insights like in-depth Page reports and in-depth Post reports are available.
The Google Analytics tracking code is fully customizable through options and hooks, allowing advanced data collection like custom dimensions and events.
= Google Analytics Real-Time Stats =
Google Analytics reports, in real-time, in your dashboard screen:
- Real-time number of visitors
- Real-time number of visitors per page
- Real-time device category
= Google Analytics Reports and Insights =
The Google Analytics insights and reports you need on your dashboard and on the site's frontend:
- Sessions, organic searches, page views, bounce rate analytics stats
- Locations, pages, referrers, keywords, 404 errors analytics stats
- Traffic channels, social networks, traffic mediums, search engines analytics stats
- Device categories, browsers, operating systems, screen resolutions, mobile brands analytics stats
= Google Analytics Tracking =
Installs the latest Google Analytics tracking code and allows full code customization:
- Google Analytics 4 tracking code
- Accelerated Mobile Pages (AMP) support for Google Analytics
- Cross domain tracking
- Ecommerce support for Google Analytics
- User privacy oriented features and much more
With Analytics Insights you can easily track events like downloads, page scrolling depth, outbound links, emails. In addition, you can track custom event categories, actions, and labels using annotated HTML elements.
Custom dimensions tracking of authors, publication date, categories, tags is also possible with Analytics Insights.
= Google Tag Manager Tracking =
As an alternative to Google Analytics tracking code, you can use Google Tag Manager for tracking:
- Google Tag Manager code
- Data Layer variables: authors, publication date, categories, tags, user type
- Accelerated Mobile Pages (AMP) support for Google Tag Manager
= Accelerated Mobile Pages (AMP) features =
- Google Tag Manager basic tracking
- Google Analytics basic tracking
- Events tracking, custom dimensions tracking, annotated HTML elements tracking
= Analytics Insights on Multisite =
This plugin is fully compatible with multisite network installs, allowing three setup modes:
- Mode 1: network activated using multiple Google Analytics accounts
- Mode 2: network activated using a single Google Analytics account
- Mode 3: network deactivated using multiple Google Analytics accounts
== Installation ==
= Installation from within WordPress =
1. Visit <em>Plugins > Add New</em>.
2. Search for **Analytics Insights**.
3. Install and activate the <em>Analytics Insights - Google Analytics Dashboard for WordPress</em> plugin.
4. Open the plugin configuration page, which is located under the <em>Analytics Insights</em> menu.
5. Authorize the plugin to connect to Google Analytics using the <em>Authorize Plugin</em> button.
6. Go back to the plugin configuration page, which is located under <em>Analytics Insights</em> menu to update/set your settings.
7. Go to <em>Analytics Insights -> Tracking Code</em> to configure/enable/disable tracking.
= Manual installation =
1. Upload the entire `analytics-insights` folder to the `/wp-content/plugins/` directory.
2. Visit <em>Plugins</em>.
3. Activate the <em>Analytics Insights - Google Analytics Dashboard for WordPress</em> plugin.
4. Open the plugin configuration page, which is located under the <em>Analytics Insights</em> menu.
5. Authorize the plugin to connect to Google Analytics using the <em>Authorize Plugin</em> button.
6. Go back to the plugin configuration page, which is located under <em>Analytics Insights</em> menu to update/set your settings.
7. Go to <em>Analytics Insights -> Tracking Code</em> to configure/enable/disable tracking.
== Frequently Asked Questions ==
= Do I have to insert the Google Analytics tracking code manually? =
No, once the plugin is authorized and a default domain is selected the Google Analytics tracking code is automatically inserted in all webpages.
= Why the numbers on Google Analytics 4 don't match those from Universal Analytics =
To put it simply, different technologies and approaches lead to different results.
= Is Google Analytics 4 tracking supported? =
Yes, you can use Google Analytics 4 properties and/or Universal Analytics properties for tracking, both are supported.
= Can I only use a Google Analytics 4 property =
Yes, you don't need to create or have an Universal Analytics property. A Google Analytics 4 property is enough for the plugin to be fully functional.
= How can I suggest a new feature, contribute or report a bug? =
You can submit pull requests, feature requests, and bug reports on [our GitHub repository](https://github.com/deconf/analytics-insights).
= Documentation, Tutorials, and FAQ =
For documentation, tutorials, FAQ and videos check out: [Analytics Insights documentation](https://deconf.com/analytics-insights-google-analytics-dashboard-wordpress/).
== Screenshots ==
1. Google Analytics 4 stats
2. Real-Time Google Analytics stats
3. Analytics reports per Posts/Pages
4. Analytics Insights Geo Map
5. Stats for Top Pages, Top Referrers, and Top Searches
6. Google Analytics traffic Overview
7. Analytics Insights statistics per page on Frontend
8. Cities on the region map
9. Analytics Insights Widget
== Upgrade Notice ==
== Changelog ==
= 6.3.8 (2024.09.21) =
* Bug Fixes:
* PHP warning fix on Google Analytics organic report
= 6.3.7 (2024.07.25) =
* Bug Fixes:
* update refresh intervals for Google Analytics Realtime report
= 6.3.6 (2024.03.15) =
* Bug Fixes:
* fix focus/blur event causing the report to refresh while wasn't on focus
* switch back the Realtime analytics report to 60s refresh intervals
= 6.3.5 (2024.03.11) =
* Bug Fixes:
* avoid JavaScript errors on pages without a title tag
* Enhancements:
* increase HTTP API request timeout
* multiple URI updates
= 6.3.4 (2024.02.05) =
* Bug Fixes:
* fixes PHP 8.3 deprecated warnings
* fixes jQuery deprecated warnings
= 6.3.3 (2024.02.04) =
* Bug Fixes:
* add compatibility for WordPress version lower than 4.0.0
= 6.3.2 (2024.01.27) =
* Bug Fixes:
* fixes PHP 8.x deprecated warnings
* fixes an issue on Location reports when 'None' is selected
* delete crons on uninstall
* add compatibility for WordPress version lower than 5.3.0
* small CSS fixes
= 6.3.1 (2024.01.26) =
* Bug Fixes:
* prevent multiple Google Analytics stats calls at first widget render
* ISO3166 small fixes
* Enhancements:
* on Google Analytics 4 no special access to Realtime stats API is required when using custom Google API projects
* clear expired cache daily using WP Cron
= 6.3 (2024.01.16) =
* Bug Fixes:
* fixed a bug causing the plugin to lose authentication when saving settings
* Security:
* Level: medium; multiple conditions must be met and valid only for websites which are using their own Google API Projects; credits [WPScan Team](https://wpscan.com/)
= 6.2 (2024.01.10) =
* Enhancements:
* refresh Google Analytics API token only once per session
* update the ISO 3166 country list for Google Analytics map charts
* add a search option to Google Analytics Streams drop-down list
* add a search option to countries list under location settings
= 6.1 (2023.12.20) =
* Enhancements:
* catch additional Google Analytics API errors
* Bug Fixes:
* fixes Google Analytics API errors cache prefix
= 6.0.4 (2023.12.02) =
* Bug Fixes:
* fixes a bug which was causing all tokens corresponding to a Gooogle Analytics account to be invalidated when clearing authorization on a website
= 6.0.3.3 (2023.12.01) =
* Bug Fixes:
* fixes a PHP warning when timezone is missing on webstream details
= 6.0.3.2 (2023.11.21) =
* Bug Fixes:
* fixes a PHP error, blocking the total users count for Google Analytics realtime report
* leveraging total count from realtime report to JavaScript
= 6.0.3 (2023.11.21) =
* Bug Fixes:
* fixes the total users count for Google Analytics realtime report
* Enhancements:
* code cleanup and optimization
= 6.0.2 (2023.11.19) =
* Bug Fixes:
* refresh token timeframe fix
= 6.0.1 (2023.11.19) =
* Bug Fixes:
* endpoint fix
= 6.0 (2023.11.18) =
* Bug Fixes:
* fix a bug preventing all Google Analytics properties and datastreams to be retrived
* Enhancements:
* refactoring code and switching to wp_remote_* instead of using Google Analytics 4 PHP library
* removing all Google Analytics 3 stats, since most of them are obsolete after three months
* Upgrade Note:
* we're switching to the new, v2, Google OAuth2 flow, so re-authorizing may be required
= 5.9.5 (2023.10.29) =
* Bug Fixes:
* when there is a single Google Analytics 4 property, Disabled is displayed on drop-down property list instead of the actual property
= 5.9.4 (2023.10.01) =
* Bug Fixes:
* last day on the Analytics area chart is wrong
= 5.9.3 (2023.09.12) =
* Bug Fixes:
* frontend widget displays wrong the same date on analytics chart
= 5.9.2 (2023.09.06) =
* Bug Fixes:
* text fix on Engagement report
* add details about the Google Analytics 4 WebStream used for tracking on Tracking Code screen
= 5.9.1 (2023.08.08) =
* Bug Fixes:
* fix for Disable option on Google Analytics tracking code
* Enhancements:
* replaced Engagement Rate with Organic Search on bottom stats report
= 5.9 (2023.08.07) =
* Enhancements:
* switch the default tracking and reporting type to Google Analytics 4
* remove Universal Analytics (analytics.js) tracking options and code
* remove Google Analytics 3 tracking options and code
* multiple fixes for Google Analytics 4 events tracking
= 5.8.11 (2023.07.17) =
* Bug Fixes:
* fixes the authorization endpoint which was causing issues with refresh tokens
= 5.8.10 (2023.07.04) =
* Enhancements:
* Improvements on error reporting system
= 5.8.9 (2023.06.23) =
* Bug Fixes:
* Multiple JS fixes on Google Analytics item reports
* Enhancements:
* Improvements on error reporting system
= 5.8.8 (2023.05.31) =
* Bug Fixes:
* Prefix PSR classes and namespace to avoid conflicts
* Enhancements:
* Google Analytics library update
= 5.8.7 (2023.04.21) =
* Enhancements:
* Google Analytics tracking improvements on Multisite
= 5.8.6 (2023.04.21) =
* Enhancements:
* revoke the Google Analytics refresh token before uninstall
* error handling improvements
= 5.8.4 (2023.01.02) =
* Enhancements:
* option to force IPv4 or IPv6 using AIWP_FORCE_IP_RESOLVE
* error handling improvements
= 5.8.3 (2022.12.07) =
* Enhancements:
* introducing two additional hooks (aiwp_gtag_output_before and aiwp_gtag_output_after) for Global Site Tag tracking code; props [@jerclarke](https://profiles.wordpress.org/jerclarke/)
* add full Google Analytics 4 support to AMP Standard, AMP Transitional, and AMP Reader pages
= 5.8.2 (2022.12.06) =
* Bug Fixes:
* Fixes a critical bug introduced with some API changes, by replacing pagePathPlusQueryString with pagePath
= 5.8.1 (2022.10.20) =
* Bug Fixes:
* Fixes a bug introduced in 5.8 preventing Google Analytics 4 webstreams retrieval at authorization
= 5.8 (2022.10.18) =
* [Release notes](https://deconf.com/google-analytics-4-support-for-wordpress-amp-pages/)
* Bug Fixes:
* Fixes multiple validation errors for AMP pages
* Google Analytics 4 (GA4) realtime reporting fixes
* Enhancements:
* introducing Google Analytics 4 AMP tracking support (Experimental); you can now use Google Analytics 4 tracking on AMP pages
= 5.7.8 (2022.10.06) =
* Bug Fixes:
* improvements on error reporting; for both Google Analytics EndPoint and Deconf Endpoint
= 5.7.7 (2022.09.27) =
* Bug Fixes:
* permanent fix for precision loses warning in PHP 8.1
= 5.7.6 (2022.09.20) =
* Bug Fixes:
* "Search ..." placeholder missing for admin stats
* solves precision loses warning for PHP 8.1
= 5.7.5 (2022.07.31) =
* Bug Fixes:
* some namespace fixes
* code optimization on Google Analytics 4 properties retrieval
= 5.7.4 (2022.07.30) =
* Bug Fixes:
* fixes on Universal Analytics and Google Analytics 4 properties list, when the number of properties exceeds 200
= 5.7.3 (2022.06.18) =
* Bug Fixes:
* fixes on Google Analytics Client library
= 5.7.2 (2022.06.17) =
* Bug Fixes:
* switch View functionality wasn't working properly for Google Analytics 4 properties
* fixes PHP 5.6 compatibility issues
= 5.7.1 (2022.06.01) =
* Bug Fixes:
* prefix namespaces to avoid autoloading collisions
= 5.6.6 (2022.05.29) =
* Enhancements:
* simplify the Google Analytics API token revoke method
* increase the maximum number of Google Analytics 4 accounts to 200
* make all Google Analytics API calls using quotaUser.
* Bug Fixes:
* fixes Google Analytics 4 total engagement time on bottom stats board
= 5.6.5 (2022.05.03) =
* Enhancements:
* replace text with dashicons on Posts List to save column space
* Bug Fixes:
* small CSS fixes
* Google Analytics 4 tracking code missing when Universal Analytics is missing or is disabled
* fixes a Google charts conflict with Site Kit by Google
= 5.6.4 (2022.04.26) =
* Enhancements:
* API EndPoint v2 upgrade for more stable and reliable requests
* Bug Fixes:
* corrected a bug that was causing fatal errors when using custom Google Cloud Console API projects
* prevent PHP fatal errors by properly storing Google Analytics API errors
= 5.6.3 (2022.04.23) =
* Enhancements:
* token handling improvements between DeConf EndPoint and Google API Client, to avoid random token resets
= 5.6.2 (2022.04.22) =
* Bug Fixes:
* escape single quotes on Google Analytics custom dimensions to prevent JavaScript Errors
* fixes a small bug for GAinWP migration
* fixes a conflict with Site Kit by Google
* Enhancements:
* more accurate errors and error description
* reset CSS style applied during error display on Google Analytics reports widget
* handling improvements on Google Analytics APIs errors
= 5.6 (2022.04.14) =
* [Release notes](https://deconf.com/analytics-insights-for-google-analytics-4/)
* Enhancements:
* switching all reports to Google Analytics Reporting v4 for an easier migration to Google Analytics Data API
* Google Analytics 4 reports are now available
* Global Site Tag is now the default tracking method on new installations
* Tracking only with a Google Analytics 4 property is now possible
* Google Analytics Data API update
* Google Analytics Reporting API update
* Google Analytics 4 real-time reports are now available
* Google Analytics 4 frontend reports UX improvements
* Google Analytics 3 frontend reports UX improvements
* easy migrate from GADWP and GAinWP plugins
* Bug Fixes:
* fix frontend per page Google Analytics reports
* redesign the Real-Time Report for Google Analytics 4
* multiple CSS fixes
* Frontend Reports URI fix
= 5.5.6 (2022.03.31) =
* Bug Fixes:
* Google Analytics 4 events tracking fix
* Security:
* Google Analytics library update
= 5.5.5 (2022.03.05) =
* Bug Fixes:
* update and multiple fixes for Google Analytics Admin service
= 5.5.4 (2022.03.04) =
* Bug Fixes:
* 404 error during Google Analytics 4 web datastreams list request
= 5.5.3 (2022.02.14) =
* Enhancements:
* improvements on detecting default GA4 webstream after install
* Bug Fixes:
* 404 error reports are empty
= 5.5.2 (2022.02.08) =
* Bug Fixes:
* Lock Selection button missing when there are no GA4 properties defined
= 5.5.1 (2022.02.08) =
* Bug Fixes:
* properly encode the access token
= 5.5.0 (2022.02.07) =
* Enhancements:
* Google Analytics library update to v2
* Google Analytics API Endpoint update to v1
* automatically get Google Analytics 4 (GA4) webstreams list
* add Google Analytics 4 (GA4) tracking feature
* dual tracking is now available; use both Google Analytics 4 (GA4) tracking and Universal analytics (UA) tracking at the same time
* Requirements:
* minimum requirements changed to PHP 5.6.0 or higher
* Bug Fixes:
* multiple bugfixes for network mode setup
* fix events tracking in Universal Analytics
= 5.4.7 =
* Bug Fixes:
* multiple bugfixes for network mode setup
* admin page css fixes
* fixing multiple notices and errors for PHP 8
= 5.4.6 =
* Bug Fixes:
* Maps API key missing quotes
* use only minified scripts and follow SCRIPT_DEBUG flag while debugging
* fix invalid links
* geochart overlapping the metrics icons on mobile devices
* Enhancements:
* UX updates for the analytics real-time report
= 5.4.4 =
* Enhancements:
* add AMP Analytics support for gtag.js (Global Site Tag)
* add events support to Global Site Tag tracking on AMP pages; including scroll depth and HTML attributes triggers
* add custom dimensions support to Global Site Tag tracking on AMP pages
= 5.4.3 =
* Bug Fixes:
* fixes javascript error when rendering anonymized charts on frontend analytics widget
* Enhancements:
* readme.txt and assets update
= 5.4.2 =
* Bug Fixes:
* fixes uaid issue for universal analytics
= 5.4.1 =
* Security Fixes:
* sanitizing, escaping, and validating additional data
* Enhancements:
* new translations for multiple languages
* replacing <strong>Cheating huh?<strong> with a more helpful feedback
* Bug Fixes:
* fixes multisite/network mode random token resets
= 5.4 =
* [Release notes](https://deconf.com/analytics-insights-google-analytics-dashboard-wordpress/)
* Enhancements:
* capability to filter and search within displayed tables
* automatically authorize users with Google Analytics, without copy/pasting the access codes
* improvements on UX for reports and stats switching (no more charts reloading)
* removed automatic updates
* settings page optimization
* refactoring code on the GADWP settings page
* removed a duplicate option in Tracking Code
* Bug Fixes:
* CSS fix for on/off buttons on GADWP settings page
= 5.3.2 =
* Bug Fixes:
* fixes for user opt-out feature
* Enhancements:
* use <em>gadwp_useroptout</em> shortcode to easily generate opt-out buttons and links, [more details](https://deconf.com/google-analytics-gdpr-and-user-data-privacy-compliance)
* adding <em>gadwp_gtag_commands</em> and <em>gadwp_gtag_script_path</em> hooks to allow further gtag (Global Site Tag) code customization
* adds opt-out and DNT support for Google Tag Manager
= 5.3.1.1 =
* Bug Fixes:
* avoid universal analytics tracking issues by not clearing the profiles list on automatic token resets
= 5.3.1 =
* Bug Fixes:
* fixing PHP notices on frontend stats when upgrading from a version lower than v4.8.0.1
= 5.3 =
* Enhancements:
* adds full support for Global Site Tag (gtag.js)
* remove Scroll Depth functionality, since this is now available as a trigger on Google Tag Manager
* adds custom dimensions support for AMP pages with Google Tag Manager tracking
* adds support for button submits
* Bug Fixes:
* form submit analytics events were not following the non-interaction settings
= 5.2.3.1 =
* Bug Fixes:
* fixing a small reporting issue on dashboard stats
= 5.2.3 =
* Enhancements:
* add Google Analytics user opt-out support
* add option to exclude Google Analytics tracking for users sending the <em>Do Not Track</em> header
* add System tab to Errors & Debug screen
* check to avoid using a redeemed Google Analytics access code
* Bug Fixes:
* remove a debugging message for analytics reports
* cURL options were overwritten during regular Analytics API calls
= 5.2.2 =
* Enhancements:
* more informative alerts and suggestions on the authorization screen
* disable autocomplete for the access code input field to avoid reuse of the same unique Google Analytics authorization code
* GADWP Endpoint improvements
* Error reporting improvements
* introducing the gadwp_maps_api_key filter
* Bug Fixes:
* use the theme color palette for the frontend stats widget
= 5.2.1 =
* Enhancements:
* avoid submitting empty error reports from Google Analytics API
* Bug Fixes:
* fixes a bug for custom PHP cURL options
= 5.2 =
* Enhancements:
* improvements on Google Analytics API exponential backoff system
* introduces a new authentication method with endpoints for Google Analytics
* multiple updates of plugin's options
* code cleanup
* improvements on error reporting system
* option to report errors to developer
* move the upgrade notice from the Dashboard to Insights Analytics settings page
* enable PHP cURL proxy support using WordPress settings, props by [Joe Hobson](https://github.com/joehobson)
* hide unusable options based on Analytics Insights settings
* Bug Fixes:
* some thrown errors were not displayed on Errors & Debug screen
* analytics icon disappears from post list after quick edit, props by [karex](https://github.com/karex)
* fix for inline SVG links, props by [Andrew Minion](https://github.com/macbookandrew)
* fixes a bug on affiliate events tracking
The full changelog is [available here](https://deconf.com/changelog-analytics-insights/).