Home » Documentation » CAOS » User Manual

CAOS — User Manual

The basic configuration for CAOS is very easy. The basic settings are required for proper functioning of the plugin.

Basic Settings

Configuration of CAOS’ Basic Settings is required for propery functioning of the plugin.

Enter your Google Analytics Tracking ID. Since v3.8.0 CAOS is compatible with both, Google Analytics’ V3 and V4 API.

For development/testing purposes, you can decide whether you want to Track Logged In Administrators. This option should be disabled on production environments!

For GDPR Compliance, decide when you want to allow tracking

Choose your Snippet Type:

  • Google Analytics’ Default tracking code is loaded render blocking, providing the most accurate statistics and is suitable in most situations, but…
  • For peak performance choose the Asynchronous tracking code. This tracking code is loaded non-render blocking, providing the best user experience without sacrificing on Google Analytics’ feature set.
  • Are you a light-weight Google Analytics user i.e. you only care about Pageviews/Events? Enable Minimal Analytics (by Minimal Analytics) to use only the code you need (and nothing more).
    • This also eliminates the Unused JS notice in Google PageSpeed Insights for analytics.js/gtag.js, because the entire library isn’t loaded anymore! Cha-ching!

For some countries (e.g. Germany) it’s required to anonymize IP addresses of your visitors to comply with GDPR laws. Enable this option if your server is located in such a country, or you expect visitors from such countries.

Decide where you want to load the generated tracking code

  • Choose ‘Header’ for best performance. Because the tracking code is loaded before the rest of the page, you’re sure that all visitor data can be registered by Google Analytics,
  • Choose ‘Footer’ (not recommended). This used to be necessary, because in some cases Google Pagespeed would throw an ‘eliminate render-block Javascript in above-the-fold content’-notice. This would cause the snippet to be loaded after everything else,
  • Choose ‘Add manually’ to maximize compatibility. If your theme or another plugin is preventing CAOS from adding the tracking code automatically, choose this option and copy the generated tracking code from the field underneath.

If you haven’t already, remove any other previously installed Google Analytics plugins or manually inserted tracking code from your WordPress installation.

Advanced Settings

The Advanced Settings provide easy to tweak advanced features of Google Analytics.

To tailor CAOS to your needs you can use the Advanced Settings. None of these are required settings and are strictly meant for advanced (WordPress) users.

When Snippet Type is set to Minimal Analytics, this tab is hidden, because none of these settings will have any effect.

Notice: if you have no idea what any of the below options mean, just leave them to their default values as they could seriously alter your Google Analytics reports.

  • CAOS does not offer an Analytics Dashboard for WordPress or Enhanced Commerce tags/events. To implement these features, CAOS is fully compatible with Monster Insights, Analytify, WooCommerce GA Integration and ExactMetrics.
  • Choose to download analytics.js, gtag.js (v4 API) or gtag.js (deprecated). Need help choosing?
  • If you use a CDN you can choose to serve analytics.js/gtag.js from your CDN by providing the base URL (without https:// or https://)
    • When using Stealth Mode the ‘collect’ calls will still be sent through your own domain, because CDN (usually) don’t run PHP.
  • Set a ‘Cookie Expiry Period‘ if you want to let the Google Analytics-cookie expire after a set number of days.
  • Change the Enqueue Order of the script if you notice that other JavaScript’s might be interfering with the execution of your Google Analytics tracking-code. I suggest leaving this to the default (10), to assure the script being triggered before everything else.
  • Disable all Display Features if you want to force disable any remarketing and advertising purposes set in your Google Analytics Dashboard.

Extensions

Enhance the functionality of CAOS and analytics.js to aid in measuring user interaction using Extensions.

CAOS allows developers to easily extend its functionality using extensions. Out-of-the-box CAOS offers a few extensions which can easily be enabled under the Extensions tab:

  • When Stealth Mode is enabled, you can alter Google Analytics’ Plugin Handling to suit your needs. Plugins, e.g. ec.js or linkid.js can be served faster if your server supports CAOS’ experimental mode.
  • Enable Stealth Mode to bypass Ad Blockers and secure Google Analytics’ accuracy.
  • Not sure if you need Stealth Mode? Enable Track Ad Blockers to gain insights into your visitors’ Ad Blocker usage.
    • Enabling this option registers whether a visitor was using an Ad Blocker or not. It does not send information (pageviews, etc.) about visitors using Ad Blockers to Google Analytics. I.e. it’s not the same as Stealth Mode.
When Track Ad Blockers is enabled in CAOS, results can be found in Behavior > Events > Top Events > Event Category: Tracking > Event Action: Ad Blocker.
  • If you want to find out when users click a link to leave your site, you can enable Capture Outbound Links. This does not work when Stealth Mode is enabled.
  • You can set an Adjusted Bounce Rate if you want to filter out e.g. visitors that close their browser window within a set number of seconds. This can be useful if you offer short snippets of information on your blog that don’t trigger a user to continue reading other pages, such as StackOverflow.
  • Improve the accuracy of your In-Page Analytics by enabling Enhanced Link Attribution: automatically differentiate between multiple links to the same URL on a single page by using link element IDs.
  • Allow A/B testing by enabling Google Optimize Integration.