| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104 |
- Module: Google Analytics
- Author: Alexander Hass <https://drupal.org/user/85918>
- Description
- ===========
- Adds the Google Analytics tracking system to your website.
- Requirements
- ============
- * Google Analytics user account
- Installation
- ============
- Copy the 'googleanalytics' module directory in to your Drupal
- sites/all/modules directory as usual.
- Upgrading from 6.x-3.x and 7.x-1.x
- ==================================
- If you upgrade from 6.x-3.x and 7.x-1.x (ga.js) to 7.x-2.x (analytics.js) you
- should verify if you used custom variables. Write down your settings or make a
- screenshot. You need to re-configure the settings to use custom dimensions or
- metrics. There is no automatic upgrade path for custom variables feature. All
- other module settings are upgraded automatically.
- See https://support.google.com/analytics/answer/2795983?hl=en for more details.
- Usage
- =====
- In the settings page enter your Google Analytics account number.
- All pages will now have the required JavaScript added to the
- HTML footer can confirm this by viewing the page source from
- your browser.
- Page specific tracking
- ======================
- The default is set to "Add to every page except the listed pages". By
- default the following pages are listed for exclusion:
- admin
- admin/*
- batch
- node/add*
- node/*/*
- user/*/*
- These defaults are changeable by the website administrator or any other
- user with 'Administer Google Analytics' permission.
- Like the blocks visibility settings in Drupal core, there is a choice for
- "Add if the following PHP code returns TRUE." Sample PHP snippets that can be
- used in this textarea can be found on the handbook page "Overview-approach to
- block visibility" at https://drupal.org/node/64135.
- Custom dimensions and metrics
- =============================
- One example for custom dimensions tracking is the "User roles" tracking.
- 1. In the Google Analytics (https://marketingplatform.google.com/about/analytics/)
- Management Interface you need to setup Dimension #1 with name
- e.g. "User roles". This step is required. Do not miss it, please.
- 2. Enter the below configuration data into the Drupal custom dimensions settings
- form under admin/config/system/googleanalytics. You can also choose another
- index, but keep it always in sync with the index used in step #1.
- Index: 1
- Value: [current-user:role-names]
- More details about custom dimensions and metrics can be found in the Google API
- documentation at https://developers.google.com/analytics/devguides/collection/analyticsjs/custom-dims-mets
- Advanced Settings
- =================
- You can include additional JavaScript snippets in the custom javascript
- code textarea. These can be found on the official Google Analytics pages
- and a few examples at https://drupal.org/node/248699. Support is not
- provided for any customisations you include.
- To speed up page loading you may also cache the Google Analytics "analytics.js"
- file locally.
- Manual JS debugging
- ===================
- For manual debugging of the JS code you are able to create a test node. This
- is the example HTML code for this test node. You need to enable debugging mode
- in your Drupal configuration of Google Analytics settings to see verbose
- messages in your browsers JS console.
- Title: Google Analytics test page
- Body:
- <ul>
- <li><a href="mailto:foo@example.com">Mailto</a></li>
- <li><a href="/files/test.txt">Download file</a></li>
- <li><a class="colorbox" href="#">Open colorbox</a></li>
- <li><a href="https://example.com/">External link</a></li>
- <li><a href="/go/test">Go link</a></li>
- </ul>
- Text format: Full HTML
|
