文档目录
报表和保存的视图
更新于 2026年11月17日
报表按活动、Offer、地理、设备、token 和时间汇总点击日志。Free 查询最近 15 天,最多 2 个维度。Pro 及以上保留全部历史,可用 5 个维度。每个用户可以保存视图。CSV 导出使用同一次查询。
分组和指标
报表引擎接受这些维度:campaign_id、offer_id、lander_id、flow_id、path_id、country、region、city、isp、device、os、browser、language、is_bot、token1–token10、zone、hour 和 day。报表界面的维度选择只列出 token1–token3。token4–token10 和 is_bot 仍可通过 API 和 MCP 的 report_query 使用。
内置指标有点击、独立访客、机器人点击、成本、转化、pending、rejected、trash、收入、待定收入、垃圾收入、CR、EPC、ROI,以及由此算出的利润、CPA 和 CPC。自定义指标是基于这些基础指标的公式,最多 12 个,存在 custom_metrics 设置里。该功能属于 Pro(以及 Team 和 Founder)。Free 没有。
套餐限制
Free:报表回溯 15 天,一次查询最多按 2 个维度分组。定价 FAQ 说更早的数据会保留;授权限制的是查询窗口,授权包里没有把它写成删除任务。Pro 把回溯和活动上限设为不限制(存的数字是 0),并允许 5 个分组维度。Team 和 Founder 使用 Pro 的报表限制。Team 另有审计日志,那不是报表。
界面上的树状下钻在分组维度不少于 2 个且下钻打开时,子行只请求第一个维度。界面默认查询上限是 1000 行。POST /api/reports/export 写出 CSV。界面用 ?bom=1 请求 BOM。
保存的视图和定时发送
report_views 按用户保存名称和 JSON 配置。在报表界面创建或删除,或使用 list_report_views、save_report_view、delete_report_view。定时邮件报表需要 Pro 功能 scheduled_reports,并且服务器设置了 VELOTRAK_SMTP_*。仪表盘(GET /api/dashboard)返回合计、对比窗口、序列、头部活动和最近一次备份时间。
这些报表里的成本来自点击的 cost 列。这一列如何填上,见成本分摊。