taolib.testing.analytics.server.api.analytics

分析查询路由。

Attributes

router
ANALYTICS_API_DESCRIPTION

Functions

_parse_time_range(→ tuple[datetime.datetime, ...)	解析时间范围参数，默认最近 7 天。
get_analytics_service(request)	获取 AnalyticsService 实例。
get_overview(request[, app_id, start, end])	获取概览统计。
get_funnel(request[, app_id, steps, start, end])	获取转化漏斗分析。
get_features(request[, app_id, start, end, limit])	获取功能使用排名。
get_paths(request[, app_id, start, end, limit])	获取用户导航路径。
get_retention(request[, app_id, start, end])	获取区域停留时间分析。
get_drop_off(request[, app_id, steps, start, end])	获取流失点分析。

Module Contents

taolib.testing.analytics.server.api.analytics.router

taolib.testing.analytics.server.api.analytics.ANALYTICS_API_DESCRIPTION = Multiline-String

Show Value

"""
分析查询 API 提供用户行为分析和统计功能。

## 功能模块

- **概览统计**：PV、UV、会话数等核心指标
- **转化漏斗**：分析用户转化路径
- **功能排名**：功能使用热度排行
- **导航路径**：用户行为轨迹分析
- **停留分析**：区域停留时间统计
- **流失分析**：用户流失点识别

## 时间范围

所有接口支持通过 `start` 和 `end` 参数指定时间范围，格式为 ISO 8601。
默认查询最近 7 天的数据。
"""

taolib.testing.analytics.server.api.analytics._parse_time_range(start: str | None, end: str | None) → tuple[datetime.datetime, datetime.datetime]

解析时间范围参数，默认最近 7 天。

taolib.testing.analytics.server.api.analytics.get_analytics_service(request: fastapi.Request)

获取 AnalyticsService 实例。

async taolib.testing.analytics.server.api.analytics.get_overview(request: fastapi.Request, app_id: str = Query(..., description='应用标识'), start: str | None = Query(None, description='开始时间 (ISO 格式)'), end: str | None = Query(None, description='结束时间 (ISO 格式)'))

获取概览统计。

async taolib.testing.analytics.server.api.analytics.get_funnel(request: fastapi.Request, app_id: str = Query(..., description='应用标识'), steps: str = Query(..., description='漏斗步骤（逗号分隔）'), start: str | None = Query(None, description='开始时间 (ISO 格式)'), end: str | None = Query(None, description='结束时间 (ISO 格式)'))

获取转化漏斗分析。

async taolib.testing.analytics.server.api.analytics.get_features(request: fastapi.Request, app_id: str = Query(..., description='应用标识'), start: str | None = Query(None, description='开始时间 (ISO 格式)'), end: str | None = Query(None, description='结束时间 (ISO 格式)'), limit: int = Query(20, ge=1, le=100, description='返回数量'))

获取功能使用排名。

async taolib.testing.analytics.server.api.analytics.get_paths(request: fastapi.Request, app_id: str = Query(..., description='应用标识'), start: str | None = Query(None, description='开始时间 (ISO 格式)'), end: str | None = Query(None, description='结束时间 (ISO 格式)'), limit: int = Query(50, ge=1, le=200, description='返回数量'))

获取用户导航路径。

async taolib.testing.analytics.server.api.analytics.get_retention(request: fastapi.Request, app_id: str = Query(..., description='应用标识'), start: str | None = Query(None, description='开始时间 (ISO 格式)'), end: str | None = Query(None, description='结束时间 (ISO 格式)'))

获取区域停留时间分析。

async taolib.testing.analytics.server.api.analytics.get_drop_off(request: fastapi.Request, app_id: str = Query(..., description='应用标识'), steps: str = Query(..., description='流程步骤（逗号分隔）'), start: str | None = Query(None, description='开始时间 (ISO 格式)'), end: str | None = Query(None, description='结束时间 (ISO 格式)'))

获取流失点分析。