Improve trial upgrade conversion

2026-06-09 18:17:19 +08:00
parent c98ff34c1e
commit 7b965ac60d
11 changed files with 221 additions and 8 deletions
@@ -0,0 +1,62 @@
+type OpsFunnelStep = {
+  key?: string;
+  label?: string;
+  count?: number;
+  uniqueActors?: number;
+};
+
+type ConversionBase = {
+  key: string;
+  label: string;
+};
+
+const PAID_CONVERSION_BASES: ConversionBase[] = [
+  { key: "trial_created", label: "试用" },
+  { key: "signup_success", label: "注册" },
+  { key: "enter_terminal", label: "终端" },
+  { key: "landing_view", label: "访客" },
+];
+
+function finiteNonNegative(value: unknown) {
+  const numeric = Number(value);
+  return Number.isFinite(numeric) && numeric > 0 ? numeric : 0;
+}
+
+function stepValue(step?: OpsFunnelStep) {
+  return finiteNonNegative(step?.uniqueActors) || finiteNonNegative(step?.count);
+}
+
+function formatRate(numerator: number, denominator: number) {
+  if (denominator <= 0) return "—";
+  return `${((numerator / denominator) * 100).toFixed(1)}%`;
+}
+
+export function getOpsPaidConversionKpi(steps: OpsFunnelStep[]) {
+  const stepByKey = Object.fromEntries(
+    steps.map((step) => [step.key || step.label || "", step]),
+  );
+  const paid = stepValue(stepByKey.payment_success);
+  const base = PAID_CONVERSION_BASES
+    .map((candidate) => ({
+      ...candidate,
+      value: stepValue(stepByKey[candidate.key]),
+    }))
+    .find((candidate) => candidate.value > 0);
+  const denominator = base?.value ?? 0;
+  const landing = stepValue(stepByKey.landing_view);
+  const visitorRate = landing > 0 ? formatRate(paid, landing) : "—";
+  const visitorContext =
+    base && base.key !== "landing_view" && visitorRate !== "—"
+      ? ` · 访客 ${visitorRate}`
+      : "";
+
+  return {
+    rateLabel: formatRate(paid, denominator),
+    subLabel: base
+      ? `${base.label} ${denominator} → ${paid}${visitorContext}`
+      : `支付 ${paid}`,
+    numerator: paid,
+    denominator,
+    denominatorKey: base?.key ?? null,
+  };
+}