Questions & analysis recipes

Acquisition#

“Which campaign brought the most human visitors in the last 30 days?” Use get_breakdown with utm_campaign, then compare conversions and attribution before judging return.

“Why did traffic jump yesterday?” Compare get_timeseries, source/device breakdowns, get_bot_traffic and get_traffic_diagnostics with the same site and timezone.

Conversion#

“Where do people leave before signup?” Query a pricing → signup funnel, inspect get_dropoffs, then review the relevant heatmap or permitted replay. Make sure the completion event exists.

“Which landing page converts best?” Compare get_pages in entry mode with goal conversions under matching filters. Check sample size before treating a small high rate as reliable.

Revenue#

“Which source gets credit for sales?” Query get_revenue_attribution with an explicit model, dimension and range. Repeat with another model if useful and label the result accordingly.

“Why is a provider total different?” Compare currency, time boundaries, transaction/refund types, sync coverage and webhook status. Do not add unlike major/minor currency units.

Experience#

“Which pages became slower?” Query performance timeseries and breakdowns with an explicit metric and percentile. Compare device mix and sample volume around the change.

“Do mobile visitors find the CTA?” Filter the heatmap to mobile, check scroll/click coverage and compare a relevant goal. A heatmap alone is not proof of intent.

Management#

“Create a goal for demo_requested.” Have the agent confirm the site and intended definition, then use create_goal with approved write access. Review the new definition with list_goals.

“Give a teammate access.” Specify the exact email and role and approve sending the invitation. The invitation tool is an external email action, not merely a local draft.

API discovery#

Every executable query and management operation is in the tool catalog. Use its schema rather than guessing arguments. The query reference describes shared analytical filters; it is not a raw SQL endpoint.