MMetadata /docs
⌘K
Docs/Tools/website_engagement_stats

website_engagement_stats

Website visitor engagement metrics: session data, page views, visitor behavior analytics.

Read analytics

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Website visitor engagement metrics: session data, page views, visitor behavior analytics.

USE FOR: Website traffic/engagement, visitor behavior analysis, session/page view metrics, website conversion funnel, engagement trends, website performance by period.
NOT FOR: Campaign ad performance (use experiment_performance_stats), account list performance (use account_list_performance), budget groups (use budget_group_performance), geographic demographics (use demographic_country_stats).

TIMEFRAMES: YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_MONTH, MONTH_TO_DATE (default), LIFETIME

METRICS: sessions, uniqueVisitors, newVisitors, returningVisitors | pageViews, pagesPerSession, avgSessionDuration | bounceRate, exitRate, timeOnPage | conversions, conversionRate, goals

REQUIRED: Valid timeframe must be specified. Default: MONTH_TO_DATE if ambiguous.

Arguments

ArgumentTypeNotes
dateRange string required Timeframe for engagement data. Options: YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_MONTH, MONTH_TO_DATE (default), LIFETIME. REQUIRED parameter.
one of: YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_MONTH, MONTH_TO_DATE, LIFETIME
page integer Page number for pagination (0-based). Example: page=0 for the first page.
size integer Number of results per page. Default: 15; raise it (up to 10000) to pull the full engagement set in one call.
sort string Sorting criteria. Examples: 'sessions,desc' (default), 'pageViews,desc', 'uniqueVisitors,desc', 'conversionRate,desc'. Format: field,direction where direction is 'asc' or 'desc'.

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"website_engagement_stats","arguments":{"dateRange":"YESTERDAY"}}}'

Response

Recorded with these arguments. Enum values are the first the tool's own schema declares; ids were fetched live from a list_ call immediately before.

arguments used
{
 "dateRange": "YESTERDAY"
}

Real, from the production server, in 539 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
"[value redacted]"

Other analytics tools:

All 160 tools · machine-readable index