Skip to content

FAQ.md

Latest commit

History

History
83 lines (47 loc) · 3.6 KB

FAQ.md

File metadata and controls

83 lines (47 loc) · 3.6 KB
Raw

FAQ

Basics

How does it work?

You run the Ackee server which then waits for requests through its API.

The API of Ackee accepts information about your visitors sent to it using ackee-tracker. It's a small script you add to your sites, similar to the JavaScript tracking snippet provided by Google Analytics.

The interface of Ackee lets you view and analyze your tracked information.

Features

Can I import my nginx logs?

Ackee uses a JS snippet to aggregate data. Nginx logs won't work, but it might be possible to use the API of Ackee to build a custom import script.

Does Ackee support multiple user-accounts?

Ackee only works with one user and it's not planned to add support for multiple user-accounts. Ackee is however lightweight enough to create one Ackee instance per user. All instances can be connected to the same MongoDB.

Configuration

How to reset my password?

You can change the username and password environment variables whenever you want. Just make sure you restart Ackee after changing those.

How to reset my account?

There's no "account" in Ackee. Just delete your database or switch to a different one.

Comparison

How does Ackee compare to Matomo (Piwik)?

Matomo is more like Google Analytics in the way it works and what you can do with it. Ackee will never be a replacement if you are looking for a full-featured marketing analytics platform with tons of options and insights. Ackee tries to be less. Lightweight, easy to install and with a good balance between analytics and privacy.

Ackee is the right tool for you if Matomo offers more than you need and when you put a focus on the privacy of your users.

How does Ackee compare to Fathom?

Ackee and Fathom are very similar. Both in the way they display data and how they process it. The biggest advantages at the moment of writing:

  • Ackee is free and open-source
  • Ackee offers a documented GraphQL API that lets you build upon it. The API can be used for custom import scripts or apps that display your current visitor stats in the menu bar. The possibilities are endless.
  • Ackee allows you to track more than just page/site views (browser, system, etc.). This is optional and off by default, but great for people/companies that need more insights.

Definitions

What is a unique site view?

Each user increases the unique site view counter when visiting a domain for the first time a day.

Examples:

  • User visits three pages of a domain => The count increases by one
  • The same user visits your page at the end of the day => The count won't increase because the user is a returning user
  • The same user visits two pages on the next day => The count increases by one because new day = new user

What are total page views?

Each visit or reload of a page will increase the total page views counter.

Examples:

  • User views three pages of a domain => The count increases by three
  • User reloads the same page two times => The count increases by three (initial visit + first reload + second reload)

Are page views unique?

No, the views aren't unique, because Ackee can't track returning users for individual pages. This is because Ackee isn't storing a browsing history of your users.

Examples:

  • User visits three pages of a domain => The count of each page increases by one
  • User reloads the same page two times => The count of the page increases by three (initial visit + first reload + second reload)
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Ackee/docs/FAQ.md at master · objctp/Ackee · GitHub
Skip to content
FAQ.md
Latest commit
History
History
83 lines (47 loc) · 3.6 KB
FAQ.md
File metadata and controls
83 lines (47 loc) · 3.6 KB
Raw
FAQ
Basics
How does it work?
You run the Ackee server which then waits for requests through its API.
The API of Ackee accepts information about your visitors sent to it using ackee-tracker. It's a small script you add to your sites, similar to the JavaScript tracking snippet provided by Google Analytics.
The interface of Ackee lets you view and analyze your tracked information.
Features
Can I import my nginx logs?
Ackee uses a JS snippet to aggregate data. Nginx logs won't work, but it might be possible to use the API of Ackee to build a custom import script.
Does Ackee support multiple user-accounts?
Ackee only works with one user and it's not planned to add support for multiple user-accounts. Ackee is however lightweight enough to create one Ackee instance per user. All instances can be connected to the same MongoDB.
Configuration
How to reset my password?
You can change the username and password environment variables whenever you want. Just make sure you restart Ackee after changing those.
How to reset my account?
There's no "account" in Ackee. Just delete your database or switch to a different one.
Comparison
How does Ackee compare to Matomo (Piwik)?
Matomo is more like Google Analytics in the way it works and what you can do with it. Ackee will never be a replacement if you are looking for a full-featured marketing analytics platform with tons of options and insights. Ackee tries to be less. Lightweight, easy to install and with a good balance between analytics and privacy.
Ackee is the right tool for you if Matomo offers more than you need and when you put a focus on the privacy of your users.
How does Ackee compare to Fathom?
Ackee and Fathom are very similar. Both in the way they display data and how they process it. The biggest advantages at the moment of writing:
  • Ackee is free and open-source
  • Ackee offers a documented GraphQL API that lets you build upon it. The API can be used for custom import scripts or apps that display your current visitor stats in the menu bar. The possibilities are endless.
  • Ackee allows you to track more than just page/site views (browser, system, etc.). This is optional and off by default, but great for people/companies that need more insights.
Definitions
What is a unique site view?
Each user increases the unique site view counter when visiting a domain for the first time a day.
Examples:
  • User visits three pages of a domain => The count increases by one
  • The same user visits your page at the end of the day => The count won't increase because the user is a returning user
  • The same user visits two pages on the next day => The count increases by one because new day = new user
What are total page views?
Each visit or reload of a page will increase the total page views counter.
Examples:
  • User views three pages of a domain => The count increases by three
  • User reloads the same page two times => The count increases by three (initial visit + first reload + second reload)
Are page views unique?
No, the views aren't unique, because Ackee can't track returning users for individual pages. This is because Ackee isn't storing a browsing history of your users.
Examples:
  • User visits three pages of a domain => The count of each page increases by one
  • User reloads the same page two times => The count of the page increases by three (initial visit + first reload + second reload)

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Ackee/docs/FAQ.md at master · objctp/Ackee · GitHub
Skip to content
FAQ.md
Latest commit
History
History
83 lines (47 loc) · 3.6 KB
FAQ.md
File metadata and controls
83 lines (47 loc) · 3.6 KB
Raw
FAQ
Basics
How does it work?
You run the Ackee server which then waits for requests through its API.
The API of Ackee accepts information about your visitors sent to it using ackee-tracker. It's a small script you add to your sites, similar to the JavaScript tracking snippet provided by Google Analytics.
The interface of Ackee lets you view and analyze your tracked information.
Features
Can I import my nginx logs?
Ackee uses a JS snippet to aggregate data. Nginx logs won't work, but it might be possible to use the API of Ackee to build a custom import script.
Does Ackee support multiple user-accounts?
Ackee only works with one user and it's not planned to add support for multiple user-accounts. Ackee is however lightweight enough to create one Ackee instance per user. All instances can be connected to the same MongoDB.
Configuration
How to reset my password?
You can change the username and password environment variables whenever you want. Just make sure you restart Ackee after changing those.
How to reset my account?
There's no "account" in Ackee. Just delete your database or switch to a different one.
Comparison
How does Ackee compare to Matomo (Piwik)?
Matomo is more like Google Analytics in the way it works and what you can do with it. Ackee will never be a replacement if you are looking for a full-featured marketing analytics platform with tons of options and insights. Ackee tries to be less. Lightweight, easy to install and with a good balance between analytics and privacy.
Ackee is the right tool for you if Matomo offers more than you need and when you put a focus on the privacy of your users.
How does Ackee compare to Fathom?
Ackee and Fathom are very similar. Both in the way they display data and how they process it. The biggest advantages at the moment of writing:
  • Ackee is free and open-source
  • Ackee offers a documented GraphQL API that lets you build upon it. The API can be used for custom import scripts or apps that display your current visitor stats in the menu bar. The possibilities are endless.
  • Ackee allows you to track more than just page/site views (browser, system, etc.). This is optional and off by default, but great for people/companies that need more insights.
Definitions
What is a unique site view?
Each user increases the unique site view counter when visiting a domain for the first time a day.
Examples:
  • User visits three pages of a domain => The count increases by one
  • The same user visits your page at the end of the day => The count won't increase because the user is a returning user
  • The same user visits two pages on the next day => The count increases by one because new day = new user
What are total page views?
Each visit or reload of a page will increase the total page views counter.
Examples:
  • User views three pages of a domain => The count increases by three
  • User reloads the same page two times => The count increases by three (initial visit + first reload + second reload)
Are page views unique?
No, the views aren't unique, because Ackee can't track returning users for individual pages. This is because Ackee isn't storing a browsing history of your users.
Examples:
  • User visits three pages of a domain => The count of each page increases by one
  • User reloads the same page two times => The count of the page increases by three (initial visit + first reload + second reload)

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Ackee/docs/FAQ.md at master · objctp/Ackee · GitHub
Skip to content
FAQ.md
Latest commit
History
History
83 lines (47 loc) · 3.6 KB
FAQ.md
File metadata and controls
83 lines (47 loc) · 3.6 KB
Raw
FAQ
Basics
How does it work?
You run the Ackee server which then waits for requests through its API.
The API of Ackee accepts information about your visitors sent to it using ackee-tracker. It's a small script you add to your sites, similar to the JavaScript tracking snippet provided by Google Analytics.
The interface of Ackee lets you view and analyze your tracked information.
Features
Can I import my nginx logs?
Ackee uses a JS snippet to aggregate data. Nginx logs won't work, but it might be possible to use the API of Ackee to build a custom import script.
Does Ackee support multiple user-accounts?
Ackee only works with one user and it's not planned to add support for multiple user-accounts. Ackee is however lightweight enough to create one Ackee instance per user. All instances can be connected to the same MongoDB.
Configuration
How to reset my password?
You can change the username and password environment variables whenever you want. Just make sure you restart Ackee after changing those.
How to reset my account?
There's no "account" in Ackee. Just delete your database or switch to a different one.
Comparison
How does Ackee compare to Matomo (Piwik)?
Matomo is more like Google Analytics in the way it works and what you can do with it. Ackee will never be a replacement if you are looking for a full-featured marketing analytics platform with tons of options and insights. Ackee tries to be less. Lightweight, easy to install and with a good balance between analytics and privacy.
Ackee is the right tool for you if Matomo offers more than you need and when you put a focus on the privacy of your users.
How does Ackee compare to Fathom?
Ackee and Fathom are very similar. Both in the way they display data and how they process it. The biggest advantages at the moment of writing:
  • Ackee is free and open-source
  • Ackee offers a documented GraphQL API that lets you build upon it. The API can be used for custom import scripts or apps that display your current visitor stats in the menu bar. The possibilities are endless.
  • Ackee allows you to track more than just page/site views (browser, system, etc.). This is optional and off by default, but great for people/companies that need more insights.
Definitions
What is a unique site view?
Each user increases the unique site view counter when visiting a domain for the first time a day.
Examples:
  • User visits three pages of a domain => The count increases by one
  • The same user visits your page at the end of the day => The count won't increase because the user is a returning user
  • The same user visits two pages on the next day => The count increases by one because new day = new user
What are total page views?
Each visit or reload of a page will increase the total page views counter.
Examples:
  • User views three pages of a domain => The count increases by three
  • User reloads the same page two times => The count increases by three (initial visit + first reload + second reload)
Are page views unique?
No, the views aren't unique, because Ackee can't track returning users for individual pages. This is because Ackee isn't storing a browsing history of your users.
Examples:
  • User visits three pages of a domain => The count of each page increases by one
  • User reloads the same page two times => The count of the page increases by three (initial visit + first reload + second reload)

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '
Ackee/docs/FAQ.md at master · objctp/Ackee · GitHub
Skip to content
FAQ.md
Latest commit
History
History
83 lines (47 loc) · 3.6 KB
FAQ.md
File metadata and controls
83 lines (47 loc) · 3.6 KB
Raw
FAQ
Basics
How does it work?
You run the Ackee server which then waits for requests through its API.
The API of Ackee accepts information about your visitors sent to it using ackee-tracker. It's a small script you add to your sites, similar to the JavaScript tracking snippet provided by Google Analytics.
The interface of Ackee lets you view and analyze your tracked information.
Features
Can I import my nginx logs?
Ackee uses a JS snippet to aggregate data. Nginx logs won't work, but it might be possible to use the API of Ackee to build a custom import script.
Does Ackee support multiple user-accounts?
Ackee only works with one user and it's not planned to add support for multiple user-accounts. Ackee is however lightweight enough to create one Ackee instance per user. All instances can be connected to the same MongoDB.
Configuration
How to reset my password?
You can change the username and password environment variables whenever you want. Just make sure you restart Ackee after changing those.
How to reset my account?
There's no "account" in Ackee. Just delete your database or switch to a different one.
Comparison
How does Ackee compare to Matomo (Piwik)?
Matomo is more like Google Analytics in the way it works and what you can do with it. Ackee will never be a replacement if you are looking for a full-featured marketing analytics platform with tons of options and insights. Ackee tries to be less. Lightweight, easy to install and with a good balance between analytics and privacy.
Ackee is the right tool for you if Matomo offers more than you need and when you put a focus on the privacy of your users.
How does Ackee compare to Fathom?
Ackee and Fathom are very similar. Both in the way they display data and how they process it. The biggest advantages at the moment of writing:
  • Ackee is free and open-source
  • Ackee offers a documented GraphQL API that lets you build upon it. The API can be used for custom import scripts or apps that display your current visitor stats in the menu bar. The possibilities are endless.
  • Ackee allows you to track more than just page/site views (browser, system, etc.). This is optional and off by default, but great for people/companies that need more insights.
Definitions
What is a unique site view?
Each user increases the unique site view counter when visiting a domain for the first time a day.
Examples:
  • User visits three pages of a domain => The count increases by one
  • The same user visits your page at the end of the day => The count won't increase because the user is a returning user
  • The same user visits two pages on the next day => The count increases by one because new day = new user
What are total page views?
Each visit or reload of a page will increase the total page views counter.
Examples:
  • User views three pages of a domain => The count increases by three
  • User reloads the same page two times => The count increases by three (initial visit + first reload + second reload)
Are page views unique?
No, the views aren't unique, because Ackee can't track returning users for individual pages. This is because Ackee isn't storing a browsing history of your users.
Examples:
  • User visits three pages of a domain => The count of each page increases by one
  • User reloads the same page two times => The count of the page increases by three (initial visit + first reload + second reload)

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Ackee/docs/FAQ.md at master · objctp/Ackee · GitHub
Skip to content
FAQ.md
Latest commit
History
History
83 lines (47 loc) · 3.6 KB
FAQ.md
File metadata and controls
83 lines (47 loc) · 3.6 KB
Raw
FAQ
Basics
How does it work?
You run the Ackee server which then waits for requests through its API.
The API of Ackee accepts information about your visitors sent to it using ackee-tracker. It's a small script you add to your sites, similar to the JavaScript tracking snippet provided by Google Analytics.
The interface of Ackee lets you view and analyze your tracked information.
Features
Can I import my nginx logs?
Ackee uses a JS snippet to aggregate data. Nginx logs won't work, but it might be possible to use the API of Ackee to build a custom import script.
Does Ackee support multiple user-accounts?
Ackee only works with one user and it's not planned to add support for multiple user-accounts. Ackee is however lightweight enough to create one Ackee instance per user. All instances can be connected to the same MongoDB.
Configuration
How to reset my password?
You can change the username and password environment variables whenever you want. Just make sure you restart Ackee after changing those.
How to reset my account?
There's no "account" in Ackee. Just delete your database or switch to a different one.
Comparison
How does Ackee compare to Matomo (Piwik)?
Matomo is more like Google Analytics in the way it works and what you can do with it. Ackee will never be a replacement if you are looking for a full-featured marketing analytics platform with tons of options and insights. Ackee tries to be less. Lightweight, easy to install and with a good balance between analytics and privacy.
Ackee is the right tool for you if Matomo offers more than you need and when you put a focus on the privacy of your users.
How does Ackee compare to Fathom?
Ackee and Fathom are very similar. Both in the way they display data and how they process it. The biggest advantages at the moment of writing:
  • Ackee is free and open-source
  • Ackee offers a documented GraphQL API that lets you build upon it. The API can be used for custom import scripts or apps that display your current visitor stats in the menu bar. The possibilities are endless.
  • Ackee allows you to track more than just page/site views (browser, system, etc.). This is optional and off by default, but great for people/companies that need more insights.
Definitions
What is a unique site view?
Each user increases the unique site view counter when visiting a domain for the first time a day.
Examples:
  • User visits three pages of a domain => The count increases by one
  • The same user visits your page at the end of the day => The count won't increase because the user is a returning user
  • The same user visits two pages on the next day => The count increases by one because new day = new user
What are total page views?
Each visit or reload of a page will increase the total page views counter.
Examples:
  • User views three pages of a domain => The count increases by three
  • User reloads the same page two times => The count increases by three (initial visit + first reload + second reload)
Are page views unique?
No, the views aren't unique, because Ackee can't track returning users for individual pages. This is because Ackee isn't storing a browsing history of your users.
Examples:
  • User visits three pages of a domain => The count of each page increases by one
  • User reloads the same page two times => The count of the page increases by three (initial visit + first reload + second reload)

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Ackee/docs/FAQ.md at master · objctp/Ackee · GitHub
Skip to content
FAQ.md
Latest commit
History
History
83 lines (47 loc) · 3.6 KB
FAQ.md
File metadata and controls
83 lines (47 loc) · 3.6 KB
Raw
FAQ
Basics
How does it work?
You run the Ackee server which then waits for requests through its API.
The API of Ackee accepts information about your visitors sent to it using ackee-tracker. It's a small script you add to your sites, similar to the JavaScript tracking snippet provided by Google Analytics.
The interface of Ackee lets you view and analyze your tracked information.
Features
Can I import my nginx logs?
Ackee uses a JS snippet to aggregate data. Nginx logs won't work, but it might be possible to use the API of Ackee to build a custom import script.
Does Ackee support multiple user-accounts?
Ackee only works with one user and it's not planned to add support for multiple user-accounts. Ackee is however lightweight enough to create one Ackee instance per user. All instances can be connected to the same MongoDB.
Configuration
How to reset my password?
You can change the username and password environment variables whenever you want. Just make sure you restart Ackee after changing those.
How to reset my account?
There's no "account" in Ackee. Just delete your database or switch to a different one.
Comparison
How does Ackee compare to Matomo (Piwik)?
Matomo is more like Google Analytics in the way it works and what you can do with it. Ackee will never be a replacement if you are looking for a full-featured marketing analytics platform with tons of options and insights. Ackee tries to be less. Lightweight, easy to install and with a good balance between analytics and privacy.
Ackee is the right tool for you if Matomo offers more than you need and when you put a focus on the privacy of your users.
How does Ackee compare to Fathom?
Ackee and Fathom are very similar. Both in the way they display data and how they process it. The biggest advantages at the moment of writing:
  • Ackee is free and open-source
  • Ackee offers a documented GraphQL API that lets you build upon it. The API can be used for custom import scripts or apps that display your current visitor stats in the menu bar. The possibilities are endless.
  • Ackee allows you to track more than just page/site views (browser, system, etc.). This is optional and off by default, but great for people/companies that need more insights.
Definitions
What is a unique site view?
Each user increases the unique site view counter when visiting a domain for the first time a day.
Examples:
  • User visits three pages of a domain => The count increases by one
  • The same user visits your page at the end of the day => The count won't increase because the user is a returning user
  • The same user visits two pages on the next day => The count increases by one because new day = new user
What are total page views?
Each visit or reload of a page will increase the total page views counter.
Examples:
  • User views three pages of a domain => The count increases by three
  • User reloads the same page two times => The count increases by three (initial visit + first reload + second reload)
Are page views unique?
No, the views aren't unique, because Ackee can't track returning users for individual pages. This is because Ackee isn't storing a browsing history of your users.
Examples:
  • User visits three pages of a domain => The count of each page increases by one
  • User reloads the same page two times => The count of the page increases by three (initial visit + first reload + second reload)

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();
Ackee/docs/FAQ.md at master · objctp/Ackee · GitHub
Skip to content
FAQ.md
Latest commit
History
History
83 lines (47 loc) · 3.6 KB
FAQ.md
File metadata and controls
83 lines (47 loc) · 3.6 KB
Raw
FAQ
Basics
How does it work?
You run the Ackee server which then waits for requests through its API.
The API of Ackee accepts information about your visitors sent to it using ackee-tracker. It's a small script you add to your sites, similar to the JavaScript tracking snippet provided by Google Analytics.
The interface of Ackee lets you view and analyze your tracked information.
Features
Can I import my nginx logs?
Ackee uses a JS snippet to aggregate data. Nginx logs won't work, but it might be possible to use the API of Ackee to build a custom import script.
Does Ackee support multiple user-accounts?
Ackee only works with one user and it's not planned to add support for multiple user-accounts. Ackee is however lightweight enough to create one Ackee instance per user. All instances can be connected to the same MongoDB.
Configuration
How to reset my password?
You can change the username and password environment variables whenever you want. Just make sure you restart Ackee after changing those.
How to reset my account?
There's no "account" in Ackee. Just delete your database or switch to a different one.
Comparison
How does Ackee compare to Matomo (Piwik)?
Matomo is more like Google Analytics in the way it works and what you can do with it. Ackee will never be a replacement if you are looking for a full-featured marketing analytics platform with tons of options and insights. Ackee tries to be less. Lightweight, easy to install and with a good balance between analytics and privacy.
Ackee is the right tool for you if Matomo offers more than you need and when you put a focus on the privacy of your users.
How does Ackee compare to Fathom?
Ackee and Fathom are very similar. Both in the way they display data and how they process it. The biggest advantages at the moment of writing:
  • Ackee is free and open-source
  • Ackee offers a documented GraphQL API that lets you build upon it. The API can be used for custom import scripts or apps that display your current visitor stats in the menu bar. The possibilities are endless.
  • Ackee allows you to track more than just page/site views (browser, system, etc.). This is optional and off by default, but great for people/companies that need more insights.
Definitions
What is a unique site view?
Each user increases the unique site view counter when visiting a domain for the first time a day.
Examples:
  • User visits three pages of a domain => The count increases by one
  • The same user visits your page at the end of the day => The count won't increase because the user is a returning user
  • The same user visits two pages on the next day => The count increases by one because new day = new user
What are total page views?
Each visit or reload of a page will increase the total page views counter.
Examples:
  • User views three pages of a domain => The count increases by three
  • User reloads the same page two times => The count increases by three (initial visit + first reload + second reload)
Are page views unique?
No, the views aren't unique, because Ackee can't track returning users for individual pages. This is because Ackee isn't storing a browsing history of your users.
Examples:
  • User visits three pages of a domain => The count of each page increases by one
  • User reloads the same page two times => The count of the page increases by three (initial visit + first reload + second reload)