ga4_run_realtime_report

Run GA4 Realtime Report

Ga4

Description

Run a GA4 realtime report (last 30 minutes of events). Primary use: verifying tags and key events fire after a tracking change, without waiting for standard processing lag. Args: property_id (string, required): GA4 property ID (numeric) or full resource name. dimensions (string[], optional): Up to 9 realtime dimension API names (e.g. eventName, unifiedScreenName, country, deviceCategory). metrics (string[], required): 1-10 realtime metric API names (e.g. activeUsers, eventCount, keyEvents). limit (number, optional): Max rows, default 50. Returns: row_count and rows flattened as { dimension: value, metric: value } objects.

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ga4_run_realtime_report",
    "arguments": {
      "property_id": "123456789",
      "dimensions": [
        "eventName"
      ],
      "metrics": [
        "eventCount"
      ],
      "reason": "Confirm tags fire after a tracking change"
    }
  }
}

Parameters

NameTypeRequiredDescription
property_id string Required GA4 property ID (numeric) or full resource name.minLength: 1
metrics array Required Realtime metric API names, e.g. activeUsers, eventCount, keyEvents.
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (2)
NameTypeRequiredDescription
dimensions array Optional Realtime dimension API names, e.g. eventName, unifiedScreenName, country, deviceCategory.
limit integer Optional Max rows (default 50).min: 1, max: 10000

Examples

Verify events firing

{
  "property_id": "123456789",
  "dimensions": [
    "eventName"
  ],
  "metrics": [
    "eventCount"
  ],
  "reason": "Confirm tags fire after a tracking change"
}

hopkin ga4 realtime-report --property-id 123456789 --dimensions eventName --metrics eventCount