Sign inGet started
Reference

Metrics and dimensions

View as MarkdownOpen in ChatGPTOpen in Claude
Connect your agent
Add to CursorAdd to VS Code

Every metric and dimension your agent can ask for in nextanalytica, with its key, unit, which way is better and how it's defined.

Updated

Every number your agent can ask for, with what it means. Your agent reads this list itself with describe_data, and uses these keys in query, so a number means the same thing in every answer.

Visitors and visits

KeyNameUnitBetterDefinition
visitorsVisitorscountHigherDistinct visitors in the period: people we know, plus one per day for visitors who haven't consented.
visitsVisitscountHigherVisits (sessions): a visit ends after 30 minutes without activity.

Pages

KeyNameUnitBetterDefinition
pageviewsPage viewscountHigherPages opened, including single-page navigation.
bounce_rateBounce rateratioLowerShare of visits that started on a page and saw only that page.
entriesEntriescountNeitherVisits that started on the page.
exitsExitscountNeitherVisits that ended on the page.
exit_rateExit rateratioLowerExits divided by page views of the page.
scroll_depthScroll depthratioHigherAverage deepest point people reached on the page, 0 to 1.

Acquisition

KeyNameUnitBetterDefinition
avg_engaged_timeEngaged time per visitmsHigherTime the page was visible and in use, per visit.
acq_visitsVisits (by source)countHigherVisits, from the acquisition rollup: use it with channel, campaign or landing page.
acq_bounce_rateBounce rate (by source)ratioLowerShare of visits from a source that saw one page.
conversion_rateConversion rateratioHigherVisits with the conversion divided by all visits.

Conversions

KeyNameUnitBetterDefinition
conversionsConversionscountHigherVisits in which the given conversion happened (counted once per visit), credited to that visit's source.
conversion_valueConversion valuemoneyHigherValue of the given conversions, in their original currency (break down by currency).

Ad accounts

KeyNameUnitBetterDefinition
spendAd spendmoneyLowerSpend in the ad account's currency (break down by currency when there are several).
impressionsAd impressionscountHigherTimes the ads were shown.
clicksAd clickscountHigherClicks on the ads, as the platform counts them.
ctrAd click-through rateratioHigherClicks divided by impressions.
cpcCost per clickmoneyLowerSpend divided by clicks.

Google Analytics 4

KeyNameUnitBetterDefinition
ga4_sessionsGA4 sessionscountHigherSessions as Google Analytics 4 counts them, from the connected property.
ga4_key_eventsGA4 key eventscountHigherKey events (GA4's conversions) from the connected property.

Google Search Console

KeyNameUnitBetterDefinition
search_clicksSearch clickscountHigherClicks from Google Search to the site.
search_impressionsSearch impressionscountHigherTimes the site appeared in Google results.
search_ctrSearch click-through rateratioHigherSearch clicks divided by impressions.
search_positionAverage positionscoreLowerAverage rank in Google results, weighted by impressions; 1 is the top.

Bing Webmaster Tools

KeyNameUnitBetterDefinition
bing_clicksBing clickscountHigherClicks from Bing search to the site, by query or by page (Bing Webmaster Tools, weekly).
bing_impressionsBing impressionscountHigherTimes the site appeared in Bing results, by query or by page (weekly).
bing_positionBing average positionscoreLowerAverage rank in Bing results, weighted by impressions; 1 is the top.

Revenue and CRM

KeyNameUnitBetterDefinition
revenueRevenuemoneyHigherPayments, orders and won deals, in their original currency (break down by currency).
leadsLeadscountHigherLeads and opportunities created in the CRM (Odoo), by the UTM source and campaign the CRM recorded.
deals_wonDeals woncountHigherOpportunities marked won in the CRM (Odoo), on the day they closed.
deals_lostDeals lostcountLowerOpportunities marked lost in the CRM (Odoo), on the day they closed.
pipeline_valueNew pipelinemoneyHigherExpected revenue of the leads created, in their own currency (break down by currency); not money received.
refundsRefundsmoneyLowerRefunds, in their original currency.

Page speed (Web Vitals)

KeyNameUnitBetterDefinition
lcp_p75LCP p75msLowerThe 75th percentile of LCP across page views: three in four were this fast or faster.
inp_p75INP p75msLowerThe 75th percentile of INP across page views: three in four were this fast or faster.
fcp_p75FCP p75msLowerThe 75th percentile of FCP across page views: three in four were this fast or faster.
ttfb_p75TTFB p75msLowerThe 75th percentile of TTFB across page views: three in four were this fast or faster.
cls_p75CLS p75scoreLowerThe 75th percentile of CLS across page views: three in four were this fast or faster.
vital_samplesSpeed samplescountNeitherPage views that reported Web Vitals.

JavaScript errors

KeyNameUnitBetterDefinition
errorsScript errorscountLowerUncaught script errors.
not_found_viewsNot-found viewscountLowerPage views that answered 404, where the browser tells us.

Forms

KeyNameUnitBetterDefinition
form_startsForm startscountHigherForms people started to fill in.
form_submitsForm submitscountHigherForms sent.
form_completionForm completionratioHigherSubmits divided by starts.
field_drop_offField drop-offcountLowerPeople who left the form at this field (break down by field).

Events

KeyNameUnitBetterDefinition
event_countEventscountNeitherEvents of any type (break down by event type or name).

Combined metrics

Made from two of the metrics above, possibly from different sources.

KeyNameUnitBetterDefinition
roasReturn on ad spendratioHigherRevenue divided by ad spend, both in the project's currency (2 means 2 back for each 1 spent).
cost_per_conversionCost per conversionmoneyLowerAd spend divided by the given conversions on the site, in the project's currency.

Dimensions

What a number can be broken down or filtered by.

KeyNameDefinition
dayDayThe project's own day, in its time zone.
weekWeekWeeks start on Monday, in the project's time zone.
monthMonthCalendar month in the project's time zone.
weekdayWeekday1 is Monday, 7 is Sunday.
hostnameHostnameThe site's host the page was on (main domain or a subdomain).
routeRouteThe page path with ids folded, e.g. /blog/:slug.
pathPathThe page path as visited, without the query string.
landing_routeLanding pageThe route of the first page of the visit.
channelChannelWhere the visit came from, by our fixed rules (CHANNELS). AI assistants is undercounted: apps that strip the referrer and add no UTM land in Direct.
ai_sourceAI assistantWhich AI assistant sent the visit (chatgpt, perplexity, claude, gemini, copilot, ...).
referrer_hostReferrerThe host of the page that linked to the site.
utm_sourceUTM sourceutm_source of the landing page.
utm_mediumUTM mediumutm_medium of the landing page.
utm_campaignUTM campaignutm_campaign of the landing page.
utm_termUTM termutm_term of the landing page; usually the ad keyword.
deviceDevicedesktop, mobile, tablet or other.
browserBrowserThe browser's family.
osOperating systemThe operating system's family.
countryCountryFrom the IP address, which is then dropped.
conversionConversionA conversion key from the project's conversion definitions.
formFormThe form's id or name.
fieldFieldA form field's name or label, never its value.
error_kindError kindscript_error or not_found.
event_typeEvent typepageview, leave, click, form, vital, error, custom, order.
event_nameEvent nameThe name of a custom or click event.
ad_sourceAd sourcegoogle_ads, meta_ads, linkedin_ads, tiktok_ads, microsoft_ads.
campaignAd campaignThe ad platform's campaign name.
ad_groupAd groupThe ad platform's ad group or ad set name.
keywordKeywordThe ad keyword, where the platform has one.
search_querySearch queryA Google Search Console query.
search_pageSearch pageThe page Google Search Console reports, as a URL.
revenue_kindRevenue kindpayment, refund, order, deal (won or lost) or lead.
currencyCurrencyThe original currency of a money amount.
in_cohortIn the cohortWhether the visit's person is in the spec's cohort: "in cohort" or "not in cohort". Needs cohort in the spec; visitors who haven't consented are never in one.
source_mediumSource / mediumGoogle Analytics 4's session source and medium, as GA4 reports it (google / organic).
Related
  • Sources: Every source you can connect to nextanalytica today, from Google Search Console to Odoo: what each one reads and how it connects.
  • Tag JavaScript API: The methods of window.nextanalytica and the attributes of the tag line, for events, people and consent.
  • Changelog: What shipped in nextanalytica, release by release, newest first: new sources, tools, tag features and fixes your agent can use today.
Still have questions?
Was this page useful?