用途：该技能用于调用 GA4 的 Realtime 端点（runRealtimeReport），获取“当前正在发生”的数据，适合实时看板、监控和“站点是否正常”类场景。它与 runReport 属于不同 API：runReport 数据有约 24-48 小时延迟、支持任意日期范围、约 50 个指标与约 150 个维度；Realtime 为最近约 30 分钟的滚动窗口，仅支持约 10 个指标与约 15 个维度，并有独立配额。
主要能力：可查询 activeUsers、screenPageViews、eventCount、conversions、keyEvents 等实时指标，以及 country、city、deviceCategory、unifiedScreenName、unifiedScreenClass、eventName、streamId、streamName、platform、appVersion、audienceName、audienceId 等维度。支持 dimension_filter 与 metric_filter，但仅限 Realtime 支持的字段。
使用方式：需先通过 ga4-auth-setup 配置可访问目标属性的 GA4 Data API 凭据，安装 Python 的 google-analytics-data，并准备数字属性 ID。调用时使用 RunRealtimeReportRequest，传入 property="properties/123456789" 与 metrics/dimensions；不要添加 date_ranges，窗口隐式为最近 30 分钟，添加会报错。无维度时返回单行，rows 为空应渲染为 0 而非视为失败。
限制：Realtime 不提供 pagePath、sessionSource 等 Data API 专属维度，也不支持自定义事件聚合（如 purchase_revenue），如需实时收入需用 eventCount 过滤 eventName=="purchase" 并结合平均客单价推算。配额默认（2026）为每项目每天 5,000 次、每属性每天 250 次、每属性每分钟 60 次；建议轮询间隔不低于约 30 秒，60 秒通常足够。API 与 GA4 网页 UI 的 Realtime 窗口略有差异，UI 默认约 5 分钟，可能包含尚未可报告的进行中事件。事件到可见通常有约 10-30 秒延迟，超过 2 分钟应检查 DebugView。超过 30 分钟的窗口应改用 ga4-data-api-query，DAU/MAU/留存等标准报告不可实时化。