VERSION HISTORY
// 2023-07-01 - ASSET DEPRECATED. Google stopped supporting Universal Analytics. ★★ Celebrating success of supporting apps with an analytics solution for over 10 years! ★★
// 2021-06-28, 1.8.6 - Made sure UnityWebRequests will be properly disposed to fix Unity 2021+ warnings. Removed deprecated code.
// 2020-11-06, 1.8.5 - Updated instructions for setting up a profile in Google Analytics.
// 2020-09-23, 1.8.4 - Added addDisableAdvertisingPersonalization, deprecated content experiments methods. Fixes for Unity 2020.2. This is the last version to support legacy Unity versions from 3.x to Unity 5.6.6. (Support for Unity 5.6.7 will likely continue.)
// 2020-07-30, 1.8.3 - Minor iOS-related fix.
// 2019-11-20, 1.8.2 - Added custom user agent construction for Android, after default UA change in recent Unity versions.
// 2019-11-16, 1.8.1 - Fixed minor warnings with Unity 2019+. Always use debug tracking when running in Unity Editor, if debug tracking id is given.
// 2019-02-11, 1.8.0 - Use HTTPS by default. Use UnityWebRequest for sending analytics hits on Unity 2018.3+.
// 2018-05-24, 1.7.3 - Update for recent changes to measurement protocol specs: reduced content group limits and check for Enhanced E-Commerce product custom dimension max length. Changed "anonymizeIP" to be enabled by default. Fixed index clamping bugs in Enhanced E-Commerce code.
// 2017-11-07, 1.7.2 - Added support for separate tracking ID used only in development builds. Fixed custom User-Agent related regression bug introduced in 1.7.1.
// 2017-07-22, 1.7.1 - Updated instructions for setting up new profiles in Google Analytics. Added workaround for custom header bug in Unity 2017.
// 2017-04-07, 1.7.0 - Improved detection of Windows version. Added Tizen-specific User-Agent construction (not recognized by GA yet). Adjusted network connectivity test timings a bit. Wrapped GUA classes to Strobotnik.GUA namespace (in Unity 5 or newer). Added new AutoSendHitOnSceneLoad option (disabled, single, additive or always). Renamed internal DEBUG preprocessor directives to GUA_DEBUG. Minor fix for Universal Windows Platform (UWP). Added new method to API: addContentGroup.
// 2016-01-29, 1.6.2 - Support fix for Unity 4.7. Use SceneManager on Unity 5.3+ (fixes warnings).
// 2015-05-21, 1.6.1 - Show visual warning when using example GA tracking property ID in own projects. Minor tweaks to WSA/WP compilation. Use newer/alternative automatic user language determination code on all platforms, mainly to fix iOS/IL2CPP 64-bit issues. Fixed asset store Unity 5 warning.
// 2015-05-08, 1.6.0 - Added support for Unity 5 WebGL platform. Clarified docs to reflect latest changes in measurement protocol specs. Added debug data validation warnings to send*Hit convenience methods. Added sendExceptionsAlsoFromEditor checkbox to make sending of exceptions optional when running in editor. Minor compile fix for Windows Store builds. Added new methods setDataSource and setGeographicalOverride.
// 2014-11-28, 1.5.1 - Small tweak to sendPageViewHit and its documentation. Upgrades for latest additions to measurement protocol: added addDOMInteractiveTime and addContentLoadTime. Verified Unity 4.6 compatibility, and made small changes to add preliminary compatibility with Unity 5 beta.
// 2014-08-29, 1.5.0 - Added option for automatically catching and sending of app errors and exceptions to analytics. Added Tooltips to component fields (for Unity 4.5 or newer). Changed SystemInfo events to be non-interactive and made sending of them an option, and when running on Unity 5 removed sending of deprecated graphicsPixelFillrate and added graphicsMultiThreaded. Moved user language setting to be part of the auto-added hit data and changed auto-initialized language to be in the language code format instead of plain English. Added custom user agent construction and usage for Windows desktop and Linux standalone builds. Added parameter category to start of the short doxygen doc info strings. Added big list of new "Enhanced E-Commerce" methods (if you want to use these, you should apparently replace existing E-Commerce code with new code using methods which belong to this category). Replaced addAnonymizeIP with setAnonymizeIP. Replaced addUserLanguage with setUserLanguage. Added cancelHit. Refined offline cached hit handling to cancel sending of hits with time way too far away from current time. Only for Web player builds: you can give null as the url string to addDocumentReferrer method, which means that the web page document.referrer will be used instead.
// 2014-06-16, 1.4.2 - Fixed offline cache for Windows Store builds. Added use of custom User-Agent on OSX. Changed method of generating anonymous client ID.
// 2014-05-12, 1.4.0 - Added offline caching of hits when not online, and internal way to track internet access status (is GA site reachable). Cache is automatically cleared when online, with throttled sending of hits. Updated API for latest changes in Measurement Protocol, and a few other API changes (see docs).
// 2014-02-18, 1.3.0 - LogError for trying to use default dummy Tracking ID or warning when using the example's ID. Use custom User-Agent on iOS (improve device detection). Fixed reset of sessionHitCountResetPending.
// 2013-12-17, 1.2.0 - Revised setup & integration instructions, with new example for making a custom report. Added new calls to set up link ID or content experiment parameters. Added built-in way to disable analytics for easier user opt-out & updated examples.
// 2013-12-12, 1.1.4 - Minor fix for trying to use Handheld class on Windows 8.
// 2013-09-25, 1.1.3 - Unity 3.5 support, minor tweaks.
// 2013-09-01, 1.1.1 - [First public release for Asset Store!] Session hit limit debug warning. Granularized some of the system info statistics. Different way to generate client ID for Android. Send 1st launch data only when network is reachable.
// 2013-06-28, 1.1.0 - Support for web player running in browser.
// 2013-05-03, 1.0.1 - Common instance, check for Internet reachability. Automatic events with OnLevelWasLoaded.
// 2013-04-26, 1.0.0 - Initial version.
|