All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
You will see a lower unique visitor count after updating. This release contains a fix for the unique visitor count and anonymisation that was broken since 3.2.0. The recorded visits were still anonymous, but Ackee tracked the visit path of each visitor. Data that Ackee normally removes. Data tracked since 3.2.0 are all counted as unique, even if they were not.
- Unique visitor count and anonymisation (#304)
- Docker support for linux/arm64 and linux/arm/v7 (#298)
- Switch to official Node.js Docker image
- Updated dependencies, including mongoose (thanks @suda, #291)
- "Float cannot represent non numeric value: NaN" when visiting a new installation of Ackee
⚠️ Contains breaking changes in the GraphQL API
This release contains a refactored front-end that takes advantage of the GraphQL API that has been a part of Ackee since version 2. Better caching and instant domain, event and permanent token updates. And: An active visitor counter that updated periodically without reloading the UI.
- Views and duration details: Click on a chart bar on the overview and insights page to see more details
- Percentage changes of average views and duration in the facts panel
- Active visitors counter updates periodically without reloading the UI
- Tooltips for text in lists (#266)
DomainStatistics
andEventStatistics
(GraphQL API) now contain a unique id fieldView
,Duration
andEventChartEntry
(GraphQL API) now contain their date in avalue
field in the format: YYYY, YYYY-MM or YYYY-MM-DD. The format depends on the chosen interval.DomainStatistics
andEventStatistics
(GraphQL API) now contain a unique id in theid
field. The previous data has been renamed tovalue
, because it was never unique and therefore shouldn't be namedid
.averageViews
andaverageDuration
(GraphQL API) are now types and don't contain the values directly
- Updated dependencies, including
ackee-tracker
in v5.1.0 which ignores updateRecord request when the website is in the background (#202)
- Ackee now requires Node.js 14 in the
package.json
even when Node.js 14 was already required - Tests are testing with Node.js 14 and 15
- Unable to set Access-Control-Allow-Credentials Header on Platforms-As-A-Service Deployments (#223)
- Missing breaking change notice in the changelog of version 3.0.0 for those using a wildcard
Access-Control-Allow-Origin
header
- Unknown sizes id when a size is zero (#217)
- Prevent unknown id errors like in #217 for other record properties
- Updated ackee-tracker which re-added
ignoreOwnVisits
for those using a wildcardAccess-Control-Allow-Origin
header
- Temporary workaround for missing browser sizes (#217)
- UI showing the wrong version
- Server serving an outdated version of ackee-tracker
Events, browser navigation and better referrers 🎉
Ackee can now track events like newsletter subscriptions, buttons clicks, checkout sums and more. It's the most requested feature and I'm happy that it's finally a part of Ackee.
You can now use the back and forward buttons to navigate between pages.
You can now specify a source
parameter in URLs (e.g. https://example.com?source=Newsletter
). Ackee will use the parameter instead of the referrer when available. This allows you the track links from newsletters and other platforms more precisely.
Ackee previously had to compile all source files before the server was ready. v3 now ships with all files Ackee needs and only builds those containing environment variables. This means running yarn start
is way faster and the Docker container even smaller.
Oh, and we also reduced the JS file size of the UI by ~60%.
This change is relevant for you when using a wildcard as the Access-Control-Allow-Origin.
Using a wildcard (*
) for the Access-Control-Allow-Origin
header was never recommended as it's neither a secure solution nor does it allow Ackee to ignore your own visits. Please disable the ignoreOwnVisits
option in ackee-tracker if you're currently using a wildcard. The SSL and HTTPS guide contains better alternatives.
ignoreOwnVisits
is now enabled by default and won't work when using a wildcard.
This change is relevant for everyone.
Ackee requires a new Access-Control-Allow-Credentials
header which was previously optional. Make sure to add this header in your server or reverse proxy configuration.
This change is only relevant for you when using ackee-tracker in the Manually or Programmatic way.
The changelog of ackee-tracker contains everything you need to know when updating to the newest version.
This change is relevant for you when using the GraphQL API.
A new parameter is required when requesting referrers via the GraphQL API. The parameter is called ReferrerType
and can be WITH_SOURCE
, NO_SOURCE
or ONLY_SOURCE
.
This change is relevant for you when using the GraphQL API.
The id
of requested referrers was always a URL, but has been changed to a string. That's because referrers can now include parameters (e.g. source
when using ackee-tracker
).
- Browser navigation. It's now possible to navigate using the back and forward button in the browser.
- "Copied to clipboard" message when clicking on an input or textarea that copies to the clipboard (#166)
- Modals can be closed with the ESC key
- Tests for permanent tokens, events and actions
source
field for records to track (thanks @BetaHuhn, #185)- Referrers will now show the
source
parameter when available (thanks @BetaHuhn, #185) - Use the
s
key to open the settings ando
to switch to the overview (Keyboard shortcuts) - Explanation why data is missing (#192)
- Compiled source files are now part of the repo
- Docker container size has been reduced (again)
- Updated build tools allow us to use ~60% less JS in the UI
- Close, delete and submit in modals could be triggered multiple times
- Updated Dockerfile reduces the size of the Docker build by ~58% (#195, thanks @omBratteng)
- Errors from permanent tokens not showing up in the UI
- Remove console logs from
apollo-server-plugin-http-headers
- Log GraphQL error instead of
undefined
Ackee now ignores your own visits once you have logged into the dashboard. Make sure to enable the ignoreOwnVisits
option in ackee-tracker to use this feature. It's currently opt-in, because it requires a new Access-Control-Allow-Credentials
header, which wasn't previously required. It will be turned on by default in the next major release of Ackee.
ℹ️ Some browsers strictly block third-party cookies when Ackee runs on a different domain than the site you're visiting. Therefore, it may happen that your own visits still find their way into your statistics, even when the option
ignoreOwnVisits
is turned on.
- Ignore own visits (#100, thanks @yehudab)
- Tons of new tests (#171, thanks @yehudab)
This release adds support for Vercel and updates the included ackee-tracker
which now ignores bots.
- Support for Vercel (#180, thanks @elliottsj)
- Contributing guide and issue templates (#184, thanks @BetaHuhn)
- ackee-tracker updated to version 4.1.0
New tools like ackee-report, ackee-bitbar and the Ackee iOS widget are build upon the powerful API of Ackee. This release makes it even easier to them by introducing permanent tokens. Permanent tokens never expire and are perfect for tools that run in the background. You can create them in the settings of Ackee and use them for authentication in Ackee-powered apps.
- Permanent tokens (#176, thanks @BetaHuhn)
- Serverless function CORS headers (#175)
- Error while deploying to Netlify (#175)
This release introduces support for serverless functions. You can now deploy Ackee to Netlify 🚀 It also reduces the memory usage and allows you to build all static files into /dist
by running yarn build
. Run yarn server
to start the server without building those files, again. This reduces the initial startup time. yarn start
combines both commands for convenience and is still the recommended way to run Ackee.
- Support for serverless functions and Netlify (#155)
- Added "Deploy to Netlify" to the Get Started guide
- Build all static files into
/dist
by runningyarn build
- Start the server without rebuilding static files using
yarn server
- Improved scrollbars on Windows (#153, thanks @Go-Merk)
- Reduce high memory usage by building files in a different step (#170)
- Show only active records in visitor counter (#161)
- Labels in modals sometimes not clickable because of invalid ids
- Invalid value error (#165)
- More relevant data on the dashboard: Ackee now shows the top data of the last 24 hours instead of last 7 days
- Heroku installation docs (#154, thanks @Go-Merk and @aleccool213)
This updates improves the look of the README and adds some missing pieces of documentation.
- Privacy Policy example (#122)
The first major back-end and front-end rewrite of Ackee with new API, dashboard, active visitors counter and more. Updating is as easy as ever. Simple grab the newest version, ensure that you're using Node.js v14 or higher and start Ackee. That's it!
- GraphQL API
- Overview with facts and data from all domains
- Facts card with live visitor counter, average visits and durations and the total number of visits today, this month and year
- New navigation that allows you to view stats by domain
- Keyboard shortcuts
- Switch between daily, monthly and yearly durations
- Click on a card headline to view more of this domain or insight
- Support
+srv
connection string modifier for MongoDB urls (#132, thanks @ericsandine)
- Improved performance for all aggregations
- Show stale data while loading new data
- Removed detailed durations
- Delete records of a domain when deleting a domain
- Updated the required Node.js version and Docker Node.js version to v14
- Removed "All time" and replaced it with "Last 6 months" for performance reasons
- Sorting of yearly views
- Instructions for using Helm (#109, thanks @suda)
- Instructions for using systemd (#112, thanks @LickABrick)
- Instructions on how to update when hosting on Heroku (#107, thanks @ckipp01)
- Filter bar to quickly change what you're viewing
- Documention website
- Browsers, devices and operating systems are now visible in the UI (thanks @RomainCscn)
- Browser and screen resolutions allow you to view width and height combined (thanks @RomainCscn)
- View the last 24 hours, 7 days, last 30 days or the top entries of all time (thanks @RomainCscn)
- API returns more entries (25 -> 30)
- Loading design in header
- Origin header check for multiple hosts (#84, thanks @jaryl)
- Switch between daily, monthly and yearly views
ACKEE_ALLOW_ORIGIN
now supports multiple domains (#79 #82, thanks @jaryl)
- JS error handling with React error boundary
- Loading indicator when the sizes-view is loading
- Catch errors when the sizes-view throws an error
- Ackee can track detailed data (optional) and now shows more of them in the "Detailed"-menu
- Simply deploy to Heroku by clicking one button (#72, thanks @aleccool213)
ACKEE_ALLOW_ORIGIN
option for Platforms-As-A-Service (#73, thanks @aleccool213)
- Allow the use of
PORT
instead ofACKEE_PORT
(#70) - Improved parts of the documentation
- Related modules in README
- Click a Twitter link to see who tweeted the link
- "New referrers"
- Custom tracker URL (#53)
- Incorrect content type for JS files (#54)
- Average and detailed durations
- Links now open in a new tab with
rel="noopener"
- Remove username and password before logging MongoDB connection URI (#50)
- Horizontal scroll on pages with vertical scroll (#52)
- Large numbers in chart view overlapping bars
- "Last 7 days" now shows last 7 days instead of 8
- Title for "Unique site views"
- CORS headers in documentation
- Data fetched twice when navigating in UI
- Abort old fetch calls when they're triggered again
- Top and recent languages
- Comparison bars for "Views per page"
- Top and recent pages in a dedicated view
- Hover recent referrers to see the date
- Improved URL normalization for cleaner URLs in "Views per page" and "Referrers"
- Improved logging of errors in the server log
- Improved menu on small screens
- Reset state after pressing "Reload Ackee" in the error overlay to recover from bugs caused by a faulty state
⚠️ All options / environment variables have been renamed. They're now starting withACKEE_
to avoid collisions with other tools. Please update your options accordingly.
- "Views per page" shows you the top 25 pages of a domain with the most views
- More documentation and FAQ
- Comparison bar behind items in the referrer list
- Normalize
siteLocation
before storing it in the database
- "Total views" => "Total page views"
- "Unique views" => "Unique site views"
/domains/:domainId/views
response contains a new type
- Login not working because environment variables already in use (#45)
- Everything