clyons-eis / silverstripe-file-analytics
Fire google analytics events on direct file requests
Installs: 84
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 1
Type:silverstripe-module
Requires
- silverstripe/cms: ~3.1
- silverstripe/framework: ~3.1
This package is not auto-updated.
Last update: 2024-12-21 19:15:22 UTC
README
Maintainers
- Craig Lyons
Introduction
This module provides the ability to fire google analytics events when files are directly requested (i.e. PDFs) Client-side approach allows for simple install & negates the need for a separate analytics account (which is required for server-side solutions).
Requirements
- SilverStripe 3.1
- Page must properly include jquery & google analytics (Classic, ga.js)
Installation
For apache, your .htaccess file will need to reroute requests to PDFs so they can hit a server-side FileAnalyticsController The RewriteRule is skipped query string for processed=1; this query string is provided by the JS redirect after tracking the event.
### PDF Tracking ###
RewriteCond %{QUERY_STRING} !processed=1
RewriteRule ^(.*\.pdf)$ file-analytics?seg=$1 [R=302,L,NC]
####################
Limitations
- Because of the client-side redirect, a 301 status cannot be sent, so this will likely prevent PDFs from being indexed by search engines.
- Only Classic Analytics is supported (ga.js). Look for Universal Analytics (analytics.js) in a future version.