=== Blunt GA (Google Analytics)=== Contributors: Hube2 Tags: google analytics, ga, event, tracking, event tracking, click to call link tracking, email link tracking, outbound link tracking, file link tracking, document link tracking, download link tracking, link tracking Requires at least: 2.6 Tested up to: 3.6 Stable tag: 3.2.0 Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=hube02%40earthlink%2enet&lc=US&item_name=Donate%20to%20Blunt%20GA%20WordPress%20Plugin&no_note=0&cn=Add%20special%20instructions%20to%20the%20seller%3a&no_shipping=1¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Installs GA on site. Event tracking of outbound, email, click to call and document links. Form Tracking. Conversion Tracking. Cross site Tracking. == Description == **Important Notice: This plugin uses "ga.js" and not the new version of GA "analytics.js" currently in public beta. If your GA account is set up for the new version then you cannot use this plugin. I have added making this plugin compatable with the new version of Google Analytics to my ["To-Do" list](http://wordpress.org/plugins/blunt-ga/other_notes/ "To-Do List").** This plugin installs Google Analytics (GA). It can be used to set up event tracking of document, file, email, click to call and outbound links. Form submission event tracking can be set up. Event tracking can be added to all conversion pages. Cross Site tracking and linking can also be set up. Tracking can be set up to track clicks as either events or as virtual page views. The main features and advantages of this plugin are: * All events can be managed and viewed seperately in Google Analytics * All events can be sent as virtual page views * Outbound Link Tracking * Document Download Tracking * Email Link Tracking * Click-to-Call Link Tracking * Anchor Link (#) Tracking * Form Submission Tracking * Event Tracking includes labels to tell you what page the link or form is located on * Conversion Page Tracking * Cross Site Tracking and Linking * Ability to set up a prefix to add for page views for cross site tracking * Active Support If you need help setting this plugin up for use in Cross Site Tracking or you have any problems setting it up and getting it working, please submit a [Support Request](http://wordpress.org/support/plugin/blunt-ga "Get Help"). [All feedback and questions welcome](http://wordpress.org/support/plugin/blunt-ga "Get Support"). == Installation == **Important: You must disable automatic installation of Google Analytics code in any other plugins that includes the ability to do so AND/OR Remove all other GA code from your site/theme/template files. Trying to run multiple installations of Google Analytics will break your tracking and quite possibly your site.** 1. Upload the Blunt GA plugin to the plugin folder of your site 2. Activate it from the Plugins Page 3. Open the settings page and enter your Google Analytics Account # and set other settings. The link to the settings page is located under Settings in the main wp-admin menu See documentation on settings page for complete instructions on use. == Screenshots == 1. Shows location of link to Blunt GA Settings page 2. Shows General Documentation Section 3. Shows Basic Settings Section 4. Shows Outbound Link Tracking Section 5. Shows Mailto Link Tracking Section 6. Shows Click to Call Link Tracking Section 7. Shows Document/File Link Tracking Section 8. Shows Anchor Link Tracking Section 9. Shows Form Submission Tracking Section 10. Shows Conversion Tracking Section 11. Shows Cross Site Tracking Section 12. Shows Cross Site Linking Section 13. Shows Location of Documentation on Wide Screens == Frequently Asked Questions == = Can I run this plugin together with another Google Analytics plugin? = No, you can't. Installing GA multiple times will break tracking. = Can I run this plugin and have GA code also manually added to the page? = No, you can't. Installing GA multiple times will break tracking. = Why don't I see the Google Analytics installation code when I look at the source code for my site? = The GA code you get from Google to paste into your pages is for the most basic settings. This code must be altereded a bit for things like cross site tracking and linking and some of the other things that this plugin does. You can read about these changes in the Google Developer documentation. The JavaScript code loaded by this plugin contains the normal GA code plus code that allows for automatic alteration to it depending on your settings. This code loads GA in the same way and at the same time as the basic code, you just can't see it in your page source. To see where the code for this plugin is loaded do a search of you page source for blunt.ga.install. == To Do == * Create a setting to have cross linked domain links not open in a new window when outbound links are set to open in a new window * Add Custom Varaibles [Google Doc](https://developers.google.com/analytics/devguides/collection/gajs/gaTrackingCustomVariables) * Disable tracking for logged in users based on user level [Google Doc](https://developers.google.com/analytics/devguides/collection/gajs/#disable) * Add search engine configuration [Google Doc](https://developers.google.com/analytics/devguides/collection/gajs/gaTrackingTraffic) * As part of above, toggle setting for tracking search results page as a search engine * Move to Analytics.js currently in public beta [Google Doc](https://developers.google.com/analytics/devguides/collection/analyticsjs/) Allow either old or new or both GA versions * Add function to allow disabling the addition of GA and tracking to a page * Add ability to select what forms will be tracked vs all or nothing, perhaps by the form ID parameter * Add ability to disable analytics based on visitor IP address * Add event tracking for 404 pages == Changelog == = 3.2.0 = * Added a missing file that caused fatal php error = 3.1.0 = * Corrected a problem with event tracking not properly sending events to GA * Cross Linked Domian links will not open in a new window if outbound links are set to open in a new window. = 3.0.0 = * Added Top Level Domain Extractor Class by Artur Barseghyan. * Added domain setting to basic settings section. * Altered Cross Site Tracking section to remove domain and renamed to Cross Site Prefix. * The above changes correct the [flaw cross site tracking](http://wordpress.org/support/topic/faw-in-cross-domian-tracking?replies=1 "Support Topic") to work correctly as per the current Google Analytics documentation. * Corrected some typos in settings documentation and readme.txt file. * Fixed bug in Cross Site Linking where domains entered were linked even if linking was disabled. * Removed warning about tracking conversions as virtual page views at it was no longer valid. * Corrected a bug in conversion tracking that inserted an incorect label when tracking as a virtual page view. = 2.0.0 = * Modified events tracking for form submissions to follow the same format as all other events for consistancy. The action is now the forms action value and the label is the current page URI. This means that events reported in GA will be different for form submissions than they were in previous version. * Modified event tracking for conversion page tracking to follow the same format as all other events for consistancy. The action of the event is now the conversion page URI and the label is the referring page's URI. * Separated Cross Site Tracking and Cross Site Linking meta boxes on settings rorm & removed the requirement that cross site tracking be enabled in order to use cross site linking. This corrects the flaw in cross site linking so that one site in a cross site tracking/linking scenario can be set up as the main site. * Added ability to use the variables %%sitename%% and %%domain%% as cross site prefix value. * Altered default settings for new installations (outbound, mailto, click to call, document tracking enabled by defualt and altered default category names of all events) * Corrected a minor bug in activate/update * Corrected a bug in anchor tracking in combination with cross site tracking, full URL of page was being added instead of the hash value. * Added less verbose documentation to settings page. * Removed documentation from readme.txt * Modified CSS for settings page. * Added donate button to settings page. = 1.2.4 = * Cleaned up code a bit * Tested on WordPress version 3.6 * Updated Compatibility * Cleaned up readme.txt to removed some typos = 1.2.3 = * Fixed a bug that caused full JavaScript file to be used rather than the minimized version = 1.2.2 = * Added minimized version of JavaScript file, reduced js size by 15K = 1.2.1 = * Fixed a bug that caused update to version 1.2.0 to revert all settings to defaults = 1.2.0 = * Added Click to Call Tracking * Notes added to documentation about Click to Call Tracking * Removed JavaScript Compression = 1.1.0 = * Fixed a bug that caused failure if only anchor tracking was enabled * Added ability to track anchors as conversion pages * Turning on anchor tracking now adds anchor hash to all page views * Notes added to documentation about changes to anchor and conversion tracking = 1.0.0 = * initial release as a WordPress Plugin