A full-featured, mountable analytics dashboard for your Rails app, shamelessly inspired by Plausible Analytics, powered by the Ahoy gem.
Currently requires using PG and a JSONB column for your data.
1. Do the bundle
Drop it in:
$ bundle add ahoy_captain
2. Install it
$ rails g ahoy_captain:install
3. Make sure your events are setup correctly
AhoyCaptain doesn't do any tracking for you; it merely provides a dashboard for your data from the Ahoy gem.
By default, AhoyCaptain assumes you're tracking
action in your
Ahoy::Event properties, and a page view event is named
$view. See this section for more information: https://github.com/ankane/ahoy#events
For a quick sanity check:
AhoyCaptain.event.where(name: AhoyCaptain.config.event[:view_name]).count AhoyCaptain.event.with_routes.count
This can be fully-customized. See the initializer
config/initializers/ahoy_captain.rb for more.
4. Star this repo
No, seriously, I need all the internet clout I can get.
5. Analyze your nightmares
If you have a large dataset (> 1GB) you probably want some indexes.
rails g ahoy_captain:migration
- Top sources
- Top pages, landing pages, and exit pages
- UTM reporting
- Top locations, by countries, regions, and cities
- Top devices, by browser, OS, and device type
- Goal tracking
- Filter by:
- Device type
- UTM tags
- Event Property
- CSV exports
- Date comparison
Coming soon ™️
- Bug fixes and performance improvements
Do your worst; please and thank you in advance! :)
The gem is available as open source under the terms of the MIT License.