Skip to content

grahambird/pes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 

Repository files navigation

pes.js

Page Engagement Score

Measure engagement with your website and send page scores to Google Analytics as events.

Requires

JQuery

What it does

  • On load, it scans the page for elements with the data-pes-value attribute
  • It then generates a maximum potential score from those elements
  • As the user interacts with the page, the amount of engagement is tracked
  • If the user clicks the same element twice, the score does not increase
  • When the user leaves the page, it sends a calculated score out of 100 to Google Analytics

How to use

  1. Include pes.js in your page via a <script> tag.
  2. Add a data-pes-value data attribute to any element you want to measure.

The score is always out of 100, no matter how many elements you add. You can give different elements different weights by increasing or decreasing the score in the data attribute.

Example HTML

<a href="#" data-pes-value="10">Something trivial</a>

<a href="#" data-pes-value="200">Something really important</a>

GDPR?

It collects no personal data.

Finding the data in Google Analytics

Go to the Events reports. Choose Page Engagement Score from the event categories. Switch to the Event label Dimension to see the pages being tracked and their average score (under the Avg. Value column).

Customisation

A few things can be changed in the pes.js file:

  • the name of the data attribute that tracks the scores
  • the Google Analytics event category name
  • the Google Analytics event action name

Debug mode

Enable pes.debug = true to see the score live and send the event to Google Analytics without leaving the page.

Limitations

  • It only tracks DOM elements via the onclick event.
  • There is no support for tracking clicks on embedded content like videos.

Contributions

Improvements welcome!

About

Page Engagement Score

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published