独立产品出海指标：从访问到付费的最小看板

// ❌ 修改前：激活条件过于宽松
function checkActivation(user: User) {
  // 注册后生成了任意一篇内容就算激活
  return user.hasCompletedSignup && user.contentsCount >= 1
}
 
// ✅ 修改后：激活 = 多场景使用，证明价值被内化
const ACTIVATION_CRITERIA = {
  // 至少生成 3 篇内容
  minContents: 3,
  // 至少用过 2 种不同模板/场景
  minScenarios: 2,
  // 注册后 48 小时内完成
  windowHours: 48,
} as const
 
function checkActivation(user: User): ActivationResult {
  const firstContentAt = user.contents[0]?.createdAt
  const now = Date.now()
  const hoursSinceSignup = firstContentAt
    ? (now - firstContentAt.getTime()) / (1000 * 60 * 60)
    : Infinity
 
  const scenarios = new Set(user.contents.map(c => c.templateId))
 
  return {
    activated:
      user.contents.length >= ACTIVATION_CRITERIA.minContents &&
      scenarios.size >= ACTIVATION_CRITERIA.minScenarios &&
      hoursSinceSignup <= ACTIVATION_CRITERIA.windowHours,
    progress: {
      contentsRatio: user.contents.length / ACTIVATION_CRITERIA.minContents,
      scenariosRatio: scenarios.size / ACTIVATION_CRITERIA.minScenarios,
    },
  }
}

// 注册后自动进入 onboarding 邮件序列
const onboardingSequence = [
  {
    day: 0,
    template: 'welcome',
    subject: 'Welcome to {product} — hereʹs your first template',
  },
  {
    day: 2,
    template: 'first-steps',
    subject: '3 prompts that 10x your writing output',
    condition: (user) => user.contents.length < 3,
  },
  {
    day: 7,
    template: 'advanced-templates',
    subject: 'Unlock advanced templates for your workflow',
    condition: (user) =>
      new Set(user.contents.map(c => c.templateId)).size < 2,
  },
  {
    day: 14,
    template: 'nudge',
    subject: 'We miss you — hereʹs what youʹre missing',
    // 14 天内核心动作少于 3 次的用户
    condition: (user) =>
      getCoreActions(user, 14).count < 3,
  },
]

// 营销页面（由设计师添加）
posthog.capture('signup_completed', { plan: 'pro' })
 
// 产品 Dashboard（由后端添加）
posthog.capture('user_registered', { method: 'google' })
 
// 移动端（另一个开发者添加）
posthog.capture('register_success', { platform: 'ios' })
 
// Stripe Webhook（由 CI/CD 添加）
posthog.capture('signup', { source: 'stripe' })

// ✅ 正确做法：集中管理事件名称，全局复用
// src/analytics/events.ts
 
/**
 * 核心增长事件 —— 全产品共用这套命名
 * 改名需要走 PR 审批，不接受临时新增
 */
export const GrowthEvents = {
  // 注册流程
  SIGNUP_STARTED: 'signup_started',
  SIGNUP_COMPLETED: 'signup_completed',
 
  // 激活流程
  ONBOARDING_STARTED: 'onboarding_started',
  CORE_ACTION_COMPLETED: 'core_action_completed',
 
  // 付费流程
  CHECKOUT_STARTED: 'checkout_started',
  PAYMENT_SUCCEEDED: 'payment_succeeded',
  PAYMENT_FAILED: 'payment_failed',
  SUBSCRIPTION_CANCELLED: 'subscription_cancelled',
} as const
 
/**
 * 用户属性标准字段
 * 出海产品必须记录国家、语言和来源
 */
interface StandardUserProperties {
  country: string        // 从 IP 或注册信息推断
  language: string       // 浏览器 Accept-Language
  referrer: string       // 来源渠道
  plan: string           // 订阅计划
  locale: string         // 当前界面语言
}
 
// 统一上报入口，避免散落调用
export function trackEvent(
  event: (typeof GrowthEvents)[keyof typeof GrowthEvents],
  properties?: Record<string, unknown>,
) {
  posthog.capture(event, {
    ...properties,
    app_version: APP_VERSION,
    platform: getPlatform(),
  })
}

// ❌ 错误：属性散乱，同义词混用，缺少上下文
posthog.capture('signup', { email: '[email protected]' })
posthog.capture('Register', { userEmail: '[email protected]' })
posthog.capture('new_user', { mail: '[email protected]', src: 'google' })
 
// ✅ 正确：统一属性名，携带标准上下文
posthog.capture('signup_completed', {
  email: '[email protected]',
  method: 'google',          // 注册方式
  country: 'US',             // 用户国家
  language: 'en',            // 界面语言
  referrer: 'google_organic',// 来源渠道
  plan: 'free_trial',        // 注册时的计划
})

// ❌ 错误：在组件中直接散落 posthog.capture 调用
'use client'
 
export function SignupForm() {
  const handleSubmit = () => {
    // 直接调用，无统一入口，事件名和属性全靠手打
    posthog.capture('user_signup', { email: formData.email })
  }
  return <form onSubmit={handleSubmit}>...</form>
}
 
// ✅ 正确：通过统一封装调用，保证事件名和属性一致
'use client'
 
import { trackEvent, GrowthEvents } from '@/analytics/events'
 
export function SignupForm() {
  const handleSubmit = async () => {
    trackEvent(GrowthEvents.SIGNUP_STARTED, {
      method: 'email',
      page: '/signup',
    })
 
    try {
      const user = await signup(formData)
      trackEvent(GrowthEvents.SIGNUP_COMPLETED, {
        method: 'email',
        plan: user.plan,
        country: user.country,
      })
    } catch (error) {
      trackEvent(GrowthEvents.PAYMENT_FAILED, {
        method: 'email',
        error: (error as Error).message,
      })
    }
  }
  return <form onSubmit={handleSubmit}>...</form>
}