概述
自 v1.0.0 起，免费版 Statnive WordPress 插件内置专属收入报表，将 WooCommerce 订单数据转化为 /wp-admin 内的 CRO 专注仪表盘。无需配置、无付费档位、无第三方数据传输——所有数据均保留在 WordPress 数据库中。
该集成基于 WooCommerce 8.5+ 订单归因构建，兼容 HPOS 与 Block Checkout，且对 WooCommerce 只读——Statnive 仅使用 $order->get_*() 取值方法，从不写入 WooCommerce 数据表或文章元数据。
系统要求
- WordPress 6.2+（已测试至 7.0）
- PHP 8.1+（在 v0.4.13 中由 8.0 提升）
- WooCommerce 8.5+（渠道归因依赖订单归因功能）
- Action Scheduler（WooCommerce 5.4 起已捆绑）
收入报表的五个关键指标
| 指标 | 数据来源 | 说明 |
|---|---|---|
| 订单数 | 统计 processing + completed 状态的 COUNT(orders) | 已退款订单在「退款总额」下单独统计 |
| 净收入 | net_total − refund_total | 不含税费和运费；下方显示 总额：$X 辅助信息 |
| 平均订单金额 | net_revenue / orders | 按 WooCommerce 商店货币设置精确显示小数 |
| 退款总额 + 退款率 | refund_total，refund_rate = refunds / gross | 显示为「退款总额 · 退款率：X%」 |
| 税费 + 运费 | tax_total + shipping_total | 合计金额，明确标注为「不计入收入」 |
七个细分维度
收入报表在页面上呈现七个维度；全部十一个端点（wc-status、backfill、summary、timeseries、by-channel、by-utm、by-landing、products、funnel、refunds、coupons）也通过 REST API 公开。
按渠道划分的收入
可排序数据表，包含 渠道 · 订单 · 收入 · 平均订单金额，覆盖 Statnive 将流量归入的 8 个渠道：
- 直接访问
- AI 助手 — 14 个主机：ChatGPT（
chatgpt.com、chat.openai.com）、Claude（claude.ai）、Gemini（gemini.google.com、bard.google.com、notebooklm.google.com）、Copilot（copilot.microsoft.com）、Perplexity（perplexity.ai）、Meta AI（meta.ai）、Le Chat / Mistral（chat.mistral.ai）、DeepSeek（deepseek.com、chat.deepseek.com）、You（you.com）、iAsk（iask.ai）、Jasper（jasper.ai）、Writesonic（writesonic.com）。AI 检测在搜索引擎分类器之前运行，因此 AI 引荐不会被错误归因为自然搜索。 - 自然搜索
- 社交媒体
- 邮件
- 引荐来源
- 付费搜索（来自 UTM
medium=cpc、ppc、paidsearch、paid_search） - 付费社交（来自 UTM
medium=cpm、paid_social）
热门产品
默认显示前 10 个产品（可按件数或收入排序，最多 100 个）。变体归入其父产品。退款已应用至对应行项目。
购物车至购买漏斗
四个阶段，由 WooCommerce 服务器端提供——无需额外安装 JS：
- 浏览产品 — 事件：
wc_product_view - 加入购物车 — 事件：
wc_add_to_cart - 开始结账 — 事件：
wc_checkout_start - 完成购买 — 事件：
wc_purchase
各步骤转化率（当前 / 上一步）及总体转化率（购买数 / 最宽入口）与会话数并列显示。
v1.1.0 更新。「总体 %」分母由首步切换为最宽步骤，按步骤 UI 显示转化率而非流失率。该约定与 WooCommerce Analytics 在 WC 9.x 中采用的一致。
按 UTM source / medium / campaign 划分的收入
分页表格，包含已归因订单上看到的 utm_source、utm_medium 和 utm_campaign 值，每行显示订单数、收入和平均订单金额。
按落地页划分的收入
分页表格，包含每个入口落地页的订单数和收入 —— 回答「哪个入口页面实际带来了买家？」
退款
时段内的退款率趋势，外加退款最多的产品列表，退款在行项目级别应用。
优惠券
分页表格，包含优惠券核销情况：代码、次数、折扣总额，以及折扣后的净收入。
v1.1.0 日期分桶
订单按
COALESCE(date_paid_gmt, date_created_gmt)分桶，因此订阅续费和延迟支付订单（BACS、支票、货到付款、晚到的完成 webhook）落在付款实际清算的当天，而不是下单当天。此前 v1.0.0 只使用date_created_gmt，导致续费付款被错误地放在过去。
零配置历史回填
在 WooCommerce 站点上激活 v1.0.0 后首次打开收入报表时，Statnive 会通过 Action Scheduler 将后台任务排入队列，导入历史订单。运行状态显示在收入报表顶部。
- 批次大小： 每个 Action Scheduler 钩子处理 500 个订单（
statnive/wc/backfill/chunk） - 统计的状态：
processing和completed。已退款的行项目会减少其父订单的行项目收入，而不是作为独立状态计入。 - 查看方式： 进入 WooCommerce → 状态 → 已安排操作，按
statnive/wc/backfill/chunk筛选
命令行替代方案
如果偏好从命令行触发或监控回填：
wp statnive woocommerce-backfill该命令具有幂等性——在回填进行中重复运行将返回 409。
数据库表
v1.0.0 通过 dbDelta 新增五张表。从 0.4.x 升级时，现有 Statnive 表及其数据完整保留。
| 表名 | 用途 |
|---|---|
wp_statnive_orders | 订单元数据、归因快照、渠道 |
wp_statnive_order_attribution | 渠道、UTM 参数、引荐来源主机、漏斗步骤 |
wp_statnive_order_items | 行项目、产品、SKU、退款统计 |
wp_statnive_order_refunds | 含金额和原因的退款事件 |
wp_statnive_order_coupons | 每笔订单的优惠券使用情况和折扣金额 |
表前缀遵循 WordPress 的 $wpdb->prefix 设置。
隐私与安全立场
- 对 WooCommerce 只读。 仅调用
$order->get_*()取值方法；Statnive 从不写入 WooCommerce 数据表或文章元数据。已通过在拥有 1,933 个订单的站点上执行CHECKSUM TABLE前后对比验证。 - 不使用 Cookie。 不使用任何浏览器存储进行访客识别。
- 每日轮换盐值（CSPRNG 生成，48 小时重叠窗口）——同一访客每天生成不同的哈希值，跨日再识别因此不可行。
- 不存储原始 IP。 IP 经过哈希处理，用于 GeoIP 查询后立即丢弃。IPv4：最后一个八位组清零。IPv6：最后 80 位清零。
- 服务器端遵循 GPC 与 DNT。
- WordPress 隐私 API 的导出器和删除器在启用时注册。
- 卸载需手动开启（默认关闭）。重新安装会保留分析数据和收入历史。
顶级后台页面
启用 v1.1.0 后，Statnive 后台导航包含以下范围内的页面：
- 总览（
/wp-admin/admin.php?page=statnive）— 访客数、会话数、页面浏览量、平均时长，以及热门来源和热门页面 - 收入报表（
/wp-admin/admin.php?page=statnive-revenue）— 上述五项 KPI + 七个细分维度 - Ask me!（
/wp-admin/admin.php?page=statnive-ask）— 横跨 10 个类别、以站长口吻表述的 116 个问题，其中 63 个问题今天即可作答（v1.1.0+） - 设置（
/wp-admin/admin.php?page=statnive-settings）— 隐私、保留期、排除规则、GeoIP
无需任何 WooCommerce 专项配置。一旦安装了 WooCommerce，集成将始终处于开启状态。
从 0.4.x 升级
无缝升级。通过 dbDelta 新增五张表；现有 21 张表及其数据不受影响。在 WooCommerce 站点上，启用后几分钟内，收入报表会通过零配置回填自动填充数据。无需更改任何代码。
完整发布说明请参阅 v1.0.0 更新日志。