Guides

Reports

How your newsletter grew and where its readers came from, issues side by side, and what happens on your website, each as a table you can download as CSV.

Growth

The Reports page (or get_growth_report) shows who joined and left in each day, week or month of a range of up to 730 days (2 years), with the total at the end of each. A subscriber joins on the day they signed up, unless they are still waiting to confirm; they leave on the day they unsubscribed, bounced or complained. Imports leave out of the leavers, since their dates aren't yours. The total is worked back from today's subscribers. Days are UTC. Every number is one count the database makes, so a long range of a big list costs the same as a short one of a small one.

The joins are split by source (the website, a pop-up, a gated issue, a form, a Magic Link, the API, a recommendation), channel (direct, search, social, email, paid, another website, a recommendation, the referral program), UTM campaign or form, with how many of each are still subscribed. The biggest 8 show; the rest are Other. Signups from before FlockStack kept where they came from have the channel their source says and no campaign.

Issues side by side

compare_issues lists your newest sent issues (up to 25, or the ones you pick with ids, or a date range) with what went out, opens, clicks and unsubscribes with their rates, bounces, complaints, views of the issue's web page and its most clicked link. Rates are of delivered emails. It reads each issue's own counters, so it doesn't grow with the list.

Your website

Page views and visitors for each day of the last year, the websites that sent them, their countries and the issues read most (get_site_report). It is counted by FlockStack as pages open: no cookie, no browser storage and no script from another company, and nothing is kept about a visitor. A visitor is a hash of their network address and browser that changes every day and is never stored. It only decides which of a few hundred counters for that day goes up, so you see an estimate of distinct visitors for each day, within a few percent, and nobody can see who they were. Someone back tomorrow is a new visitor, so the total is the days' visitors added up. The country is what Cloudflare reports for the visitor's network. A browser that sends Do Not Track or Global Privacy Control, and a crawler, isn't counted. Newsletters don't get third-party tracking pixels: a reader's browser talks only to your newsletter's host.

CSV

Every report has its export buttons, and export_report does the same from the API: report growth (a series table, one row for each period, or a breakdown, one row for each group with a column for each period), issues, or site (daily, referrers, countries or pages). Rates are fractions from 0 to 1, and a cell a spreadsheet would run as a formula is quoted as text.