Skip to content

Signups and sign-ins: completions, where they came from, per day

GET
/v1/analytics/signups

For products that sign people up on their own site. Put data-nordva-signup on the signup button (or on the form, where the submit counts) and data-nordva-signin on the log-in button; they send the goals signup and signin. Nothing has to be set up first: those names and a few others (sign-up, sign_up, register, signup-complete; sign-in, login, log-in, sign_in) are recognised, and a site that calls it something else nominates that goal with PATCH /v1/analytics/settings. Only one name is ever counted per role, and the answer says which one and whether it was nominated. by_source groups the signup goal by group_by (default channel), by_day is per UTC day, people is visitors with an id who reached it. A goal is counted when the button is clicked or the form submitted, not when your server confirms it: for OAuth or a magic link call nordva('goal', 'signup') on the page they land on. Past 90 days group_by is one of channel, referrer, utm_source, utm_medium, utm_campaign, country.

History: Free 30 days, Indie 365, Builder 730. The last 90 days are read from raw events; older days from daily totals kept after raw events expire. When any day came from those, the answer has from_rollups: true and rollups: { from, to, missing_days } (the UTC dates read from them, and how many are not summed yet). Past 90 days: visitors are each day’s visitors added up (visitors_basis: "sum_of_daily"), a breakdown keeps each day’s top values and adds the rest as an (other) row, and filters, hourly buckets, visitor lists and funnels answer ANALYTICS_RAW_EVENTS_ONLY.

Auth: Secret key only.

Countries left out: the project’s saved excluded_countries (PATCH /v1/analytics/settings) are left out of this read, unless exclude_country names others (a comma list of two-letter codes, e.g. NO,CH; empty counts every country). The answer names the list it applied in excluded_countries. Past 90 days the totals, time series, goals, map and the country breakdown lose those countries (visits and page views exactly; engaged time, visits with ids, bounce, new visitors and goals in proportion, marked rollups.excluded_estimated; visitors become null); a breakdown or signups grouping by anything else answers ANALYTICS_RAW_EVENTS_ONLY with param: "exclude_country" when those countries had visits on those days.

period_days
integer
default: 7 >= 1 <= 1825
group_by
string
Allowed values: channel referrer utm_source utm_medium utm_campaign path country city device browser os
limit
integer
default: 10 >= 1 <= 50
exclude_country
string
/^([A-Za-z][A-Za-z0-9](,[A-Za-z][A-Za-z0-9])*)?$/

Countries to leave out instead of the saved list, e.g. NO,CH; empty for none.

Signups and sign-ins

Error envelope. See error.code for the discriminator.

object
data
required
null
error
required
object
code
required
string
message
required
string
remediation
required
string
doc_url
string format: uri
param
string
request_id
string
meta
object
key
additional properties

Error envelope. See error.code for the discriminator.

object
data
required
null
error
required
object
code
required
string
message
required
string
remediation
required
string
doc_url
string format: uri
param
string
request_id
string
meta
object
key
additional properties