Break an event or goal down
One event or goal by a prop or by where its visits came from, with conversions, conversion rate and revenue.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Which channels brought the fleet deals we won in the last 90 days, and how much did they spend?
Your agent callsanalytics_breakdownFree*
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"site": "halversoncycle.example",
"event": "Deal won",
"by": "channel",
"period": "90d"
}Use it when
Someone asks which channels, campaigns or landing pages bring signups, bookings or money.
- For the site's whole picture for a period, use
analytics_stats.
What it does
One event or goal by a prop (by: "prop:plan") or by where its visits came from: channel, source, referrer, campaign, medium, term, content, landing_page, page, country, device, browser or os. Each row has conversions, visitors, the conversion rate (for where visits came from) and revenue, so you see which channels, campaigns and landing pages bring signups and money, including what analytics_track and Conecto's own bookings, chats and forms counted.
What comes back
Rows by the value asked for, each with conversions, visitors, the conversion rate and revenue per currency, and the totals. Events the agent tracked that no visit led to are one row, (no visit). Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
siteRequired | string | The site's domain (e.g. halversoncycle.example) or its site_id. 4 to 253 characters. |
event | string | Up to 60 characters. |
goal | string | Up to 60 characters. |
by | string | Up to 50 characters. Default: channel. |
period | string | One of: today,yesterday,7d,30d,90d,month,last_month,12mo,custom. Default: 30d. |
from | string | With period custom: the first day, 2026-10-01. Up to 10 characters. |
to | string | With period custom: the last day. Up to 10 characters. |
filters | object | Narrow the stats: page and entry_page ("/blog/*", * for any part), goal (a goal's name), event, channel (Direct, Organic search, Paid search, Organic social, Paid social, AI assistants, Email, Referral, Affiliates, Display, Paid other, Other campaigns), source ("Google", "Direct"), referrer, campaign, medium, term, content, country ("DE"), device (desktop, tablet, mobile), browser, os. Example: {"channel": "Organic search", "device": "mobile"}. |
limit | integer | 1 to 100. Default: 20. |
The call
Over MCP, call analytics_breakdown on https://api.conecto.chat/mcp/analytics. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/analytics_breakdown \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"site":"halversoncycle.example","event":"Deal won","by":"channel","period":"90d"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No site the business counts has that domain or site_id. | Call analytics_list_sites and use a domain from it. |
invalid_input400 | No event or goal was named, or both, the goal does not exist, or by is not one of the dimensions or prop:<name>. | Name one event or one goal, and pick by from the list. |
rate_limited429 | The business ran more analytics reports this minute than its limit allows. | Wait a minute, then call again. |
More Website analytics tools
All 18 tools- Count a website's visits
analytics_add_siteStarts counting visits to a website, without cookies, and returns the snippet for its pages.$3.00 a call - Get install steps
analytics_installStep-by-step instructions to put the counting script on a site: any html, Shopify, WordPress, Webflow or Google Tag Manager.Free* - Read a site's stats
analytics_statsA site's visitors, pages, sources, countries, devices, events, goals and speed for a period, against the period before.Free* - Who is on a site now
analytics_realtimeVisitors in the last 5 minutes, and the pages people looked at in the last 30.Free* - Set a site's goals
analytics_set_goalsSets the conversions a site counts: pages reached or events, replacing its goals; with notify, the agent hears of each one as it happens.Free - Define events without touching the site
analytics_define_eventsDefines events from what the script already sees (clicks, pages, scrolling, time on a page, props), with nobody editing the site.Free - Track events from outside the site
analytics_trackRecords events that happen away from the site, like orders, deals won or renewals, tied to the visit that led to them when it can be found.Free - See where people drop off
analytics_funnelHow many visitors did each step of a path in order, and how many dropped out at each one.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md