=== Content Engagement ===
Contributors: nositesleft
Donate link: http://nositesleft.com/
Tags: analytics
Requires at least: 3.0.1
Tested up to: 3.9.1
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Helps you understand how visitors are using your site by collecting and sending content engagement data to Google Analytics.

== Description ==

Content Engagement is a plugin that will collect data on how users are engaging with your content and send it to your Google Analytics account. Once Analytics has processed that data you can use it to learn about how users are interacting with your site.

All of the data that the plugin collects and sends to Google Analytics is categorized in the "Content Engagement" category. Under that category the plugin collects and sends data about the following. The plugin will cause the visitors browser to send data to Google Analytics anytime a user moves between pages, leaves the site or refreshed their browser.

= What Does The Plugin Collect =

1. Scrolled
2. Read Entire Page
3. Time On Page
4. Visitor Type
5. Scroll Depth

= Scrolled =

Used to determine if a visitor scrolled at all. Once a visitor scrolls their browser at least 100px it's considered that they've scrolled. This is sent to Google Analytics as either a yes or no value.

= Read Entire Page =

Used to determine if a visitor read the entire page by sensing if the user scrolled all the way to the end. This is sent to Google Analytics as either a yes or no value.

= Time On Page =

Used to measure how long visitors spend on each page. The time is bucketed into six different buckets. The buckets are as follows.

* 0-1
* 1-2
* 2-3
* 3-4
* 4-5
* > 5

By limiting the time on page to six buckets we're able to use pie charts in our widgets.

= Visitor Type =

Used to classify visitors as either readers or scanners. Readers are considered visitors that read the entire page and also spent at least 60 seconds on it. All other visitors are classified as scanners.

= Scroll Depth =

Used to measure how far down the page visitors scroll. Scroll depths are rounded to 15% increments.

== Installation ==

Installation of the plugin only requires the simple step of inputing your Google Analytics tracking ID. Instructions and the setup page can be found under Settings => Content Engagement on your WordPress site.

== Frequently Asked Questions ==

= How long does it take data to show up? =

You'll be able to see the events coming into Analytics using the Real Time reporting features as soon as the plugin is installed. For the data to show up in the other areas of Analytics totally depends on how long it takes Google to process the data once it's received.

= How can I used the data the plugin has collected? =

Once the data is in Google Analytics you can use it to build widgets and reports. I'm still working on guides and tutorials so in the mean time please feel free to email me at mike@nositesleft.com and I'll do my best to help you get the data you need from the plugin.

= I've got suggestions. Where should I send them? =

Great! Either leave a note on the support forum here or email me at mike@nositesleft.com and let's have a conversation.

== Changelog ==

= 1.0.0 =
Initial Release

= 1.1.0 =
Added ability to get data back from Google Analytics
Fixed a bug with scroll depth being reported wrong