Documentation Index
Fetch the complete documentation index at: https://docs.formo.so/llms.txt
Use this file to discover all available pages before exploring further.
Current Visitors
How many unique visitors are currently interacting with your site or app. It includes all visitors who have viewed a page in the last 5 minutes.Unique Visitors
How many daily / weekly / monthly unique visitors are interacting with your site or app across multiple page views and events. A visitor is only counted once within a 24 hour window. The 24 hour limit is necessary to comply with GDPR.New Users
Users who visit your site or app for the first time within the selected time period.Returning Users
Users who have visited your site or app in previous time periods and return within the current period.Resurrected Users
Users who were previously active, became inactive for a period of time, and then return after being inactive.Active Wallets
How many unique daily / weekly / monthly wallets are active on your site or app. We also collect other wallet details, such as the wallet address, wallet type, and wallet profiles.Wallet Connects
How many users have connected their crypto wallets to your app.Transactions
How many transactions have been made across your site or app.Page Views
How many times a page has been viewed across your site or app.Sessions
A session (also known as a visit) is a set of actions that a user takes on your site. Each session is a 24 hour window. If a visitor returns after this window, a new session is counted. This is useful for debugging and identifying problems on your site. For example, if visitors are not completing transactions, you can see which pages were visited and what events were triggered to identify a common problem on your site that is preventing visitors from completing.Session Duration
Session duration measures how long a visitor stays on your website or app during a single visit (session).How It’s Calculated
- Starting Point: When a visitor first lands on your site, the system records a timestamp.
- Ending Point: When the visitor performs their last action before leaving, another timestamp is recorded.
- The Calculation: The system simply subtracts the first timestamp from the last one to determine how long the visitor stayed.
- Averaging: To get the average session duration shown in your reports, the system adds up all individual session durations and divides by the number of sessions.
What This Means For You
- The reported average session duration gives you a reliable measure of how long people typically engage with your site.
- Longer average sessions generally indicate more engaging content.
- This metric helps you understand if changes to your site are improving user engagement over time.
- Note: The system can only measure activity it can see - when someone views a page or clicks something. If a visitor reads a long article without interacting further, the system can’t detect this “passive” time. This is a standard limitation in all web analytics platforms.
Bounce Rate
The bounce rate is the relative number of visitors who have left the site after a single page view, compared to the total number of unique visitors. Formo counts a “bounce” if the visitor visits only a single page and leaves without performing an engaging action.Referrers / Sources
How many users are referred to your site or app by a particular source such as a search engine, social media platform, etc. Referrers are the statistics for the referring site. The data is extracted from the Referrers (with a r) HTTP header and may not be set by the browser. In these cases it will be listed as unknown.UTM parameters
How many users come to your site or app from a particular source. We track these UTM codes:utm_source(e.g.: google.com)utm_medium(e.g.: search)utm_campaign(e.g.: summer_sale)utm_contentutm_term
Channel
The acquisition channel that brought a session to your app. Every session is assigned to exactly one of 12 channels at query time, using a priority-ordered ladder over referrer domain,utm_medium, and 8 ad-platform click IDs (gclid, gad_source, fbclid, msclkid, ttclid, twclid, li_fat_id, rdt_cid).
| # | Channel | Definition |
|---|---|---|
| 1 | Paid Search | Paid signal + referrer is a search engine (Google, Bing, DuckDuckGo, Yahoo, Yandex, Baidu, Brave, Kagi, Naver, …) |
| 2 | Paid Video | Paid signal + referrer is a video platform (YouTube, Vimeo, Twitch, Dailymotion, Loom, Wistia) |
| 3 | Paid Social | Paid signal + referrer is a social platform (Meta, X, LinkedIn, Reddit, TikTok, Pinterest, Snapchat, Threads, Discord, Telegram, Farcaster, …) |
| 4 | utm_medium ∈ {email, e-mail, e_mail, newsletter} | |
| 5 | Affiliates | utm_medium=affiliate or non-empty ref query parameter |
| 6 | Display | utm_medium ∈ {display, banner, expandable, interstitial} |
| 7 | AI | Referrer is an AI assistant domain (ChatGPT, Claude, Gemini, Copilot, Perplexity, DeepSeek, Phind, Poe, Mistral Chat, Meta AI, You.com, Pi) |
| 8 | Organic Search | utm_medium=organic or referrer is a search engine with no paid signal |
| 9 | Organic Social | utm_medium ∈ {social, social-network, social-media, sm} or referrer is a social platform with no paid signal |
| 10 | Organic Video | Referrer is a video platform with no paid signal |
| 11 | Referrers | Any other non-empty referrer not matched by the rules above |
| 12 | Direct | No referrer, no UTM, no click ID (typed URL, bookmark, or stripped referrer) |
utm_medium is one of cpc, cpm, cpv, cpa, ppc, paidsearch, paidsocial, sem, retargeting; utm_medium starts with paid; or any of the 8 click IDs above is non-empty. Same-domain referrers (e.g. blog.example.com referred from app.example.com) are stripped before classification so internal navigation rolls up to Direct instead of Referrers.
Referrals
How many users are referred to your site or app by a particular user. We use theref query parameters to track referrals.
Countries
Countries are the statistics for the country of origin of the visitors.Devices
How many users are using a particular device such as desktop, mobile, tablet, etc.Browsers
Browser is the statistics of the browser used by the visitor. It is extracted from the User-Agent and Client Hints HTTP headers.Operating System
Shows the operating systems used by your visitors.First Seen
The date and time when a user or wallet was first observed interacting with your app.Last Seen
The most recent date and time when a user or wallet was observed interacting with your app.Events
Events are user-defined custom events. They have a name and optional metadata key/value pairs. When you expand the activity feed, you can view and filter the metadata. Metadata can be anything. For example, you can define an event Button clicked and track which button was clicked as the metadata fieldbutton=Header.