☁️ SaaS-сервис

// Регистрация (активация)
{
  "event": "signup",
  "user_id": "user_123",
  "properties": {
    "method": "email",
    "source": "google_ads"
  },
  "attributes": {
    "email": "user@example.com",
    "name": "Иван Петров",
    "company": "ООО Ромашка"
  },
  "_metadata": {
    "is_activation": true,
    "event_display_name": "Регистрация",
    "event_color": "#28a745"
  }
}

// Начало триала
{
  "event": "trial_start",
  "user_id": "user_123",
  "properties": {
    "plan": "pro",
    "trial_days": 14,
    "trial_ends_at": "2026-04-02"
  },
  "_metadata": {
    "funnel_sales_step": 2,
    "funnel_sales_name": "Начало триала",
    "event_display_name": "Начало триала"
  }
}

// Создание подписки (первый платёж)
{
  "event": "subscription_created",
  "user_id": "user_123",
  "properties": {
    "plan": "pro",
    "amount": 9900,
    "billing_period": "month",
    "interval": 1
  },
  "_metadata": {
    "funnel_sales_step": 3,
    "funnel_sales_name": "Платная подписка",
    "is_order": true,
    "order_revenue_field": "amount",
    "event_display_name": "Покупка подписки",
    "event_color": "#2A6DF4"
  }
}

// Ежемесячный платёж
{
  "event": "subscription_payment",
  "user_id": "user_123",
  "properties": {
    "plan": "pro",
    "amount": 9900,
    "payment_date": "2026-04-01",
    "invoice_id": "INV-001"
  },
  "_metadata": {
    "is_order": true,
    "order_revenue_field": "amount",
    "event_display_name": "Ежемесячный платёж"
  }
}

// Отмена подписки
{
  "event": "subscription_cancelled",
  "user_id": "user_123",
  "properties": {
    "plan": "pro",
    "reason": "too_expensive",
    "cancelled_at": "2026-05-01",
    "effective_date": "2026-06-01"
  },
  "_metadata": {
    "event_display_name": "Отмена подписки",
    "event_color": "#dc3545"
  }
}

{
  "event": "company_data",
  "user_id": "user_123",
  "attributes": {
    "email": "user@example.com",
    "company_name": "ООО Ромашка",
    "company_size": 45,
    "industry": "retail",
    "plan": "enterprise",
    "plan_started_at": "2026-01-15",
    "trial_ends_at": "2026-01-29",
    "subscription_status": "active",
    "mrr": 45000,
    "ltv": 450000,
    "total_paid": 135000,
    "payment_method": "invoice",
    "account_manager": "Иван Петров",
    "churn_risk": "low",
    
    "_metadata": {
      "company_name": {
        "attribute_display_name": "Компания",
        "attribute_category": "Основное"
      },
      "plan": {
        "attribute_display_name": "Тариф",
        "attribute_category": "Подписка",
        "attribute_format": "string",
        "attribute_color": "#2A6DF4"
      },
      "mrr": {
        "attribute_display_name": "MRR",
        "attribute_category": "Финансы",
        "attribute_format": "currency"
      },
      "ltv": {
        "attribute_display_name": "LTV",
        "attribute_category": "Финансы",
        "attribute_format": "currency"
      },
      "churn_risk": {
        "attribute_display_name": "Риск оттока",
        "attribute_category": "Аналитика",
        "attribute_format": "string",
        "attribute_color": "#fd7e14"
      }
    }
  }
}

Churn Rate = (Клиенты, отменившие подписку за месяц) / (Всего активных клиентов) × 100%

LTV = (Средний чек × Частота покупок) / Churn Rate

LTV = Сумма выручки от когорты / Размер когорты

class SaaSSubscriptionTracker {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.apiUrl = 'https://api.instantbase.online/v1/track';
  }
  
  async trackEvent(event, userId, properties = {}, metadata = {}) {
    const data = {
      event,
      user_id: userId,
      timestamp: new Date().toISOString(),
      properties
    };
    
    if (Object.keys(metadata).length > 0) {
      data._metadata = metadata;
    }
    
    try {
      const response = await fetch(this.apiUrl, {
        method: 'POST',
        headers: {
          'X-API-Key': this.apiKey,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify(data)
      });
      
      return await response.json();
    } catch (error) {
      console.error('Failed to track event:', error);
    }
  }
  
  // Регистрация
  trackSignup(userId, userData, source) {
    return this.trackEvent('signup', userId, {
      method: 'email',
      source
    }, {
      is_activation: true,
      event_display_name: 'Регистрация'
    }, userData);
  }
  
  // Активация (ключевое действие)
  trackActivation(userId, feature) {
    return this.trackEvent('activation', userId, {
      feature,
      activated_at: new Date().toISOString()
    }, {
      funnel_sales_step: 1,
      funnel_sales_name: 'Активация',
      event_display_name: 'Активация'
    });
  }
  
  // Начало триала
  trackTrialStart(userId, plan, trialDays) {
    const trialEnds = new Date();
    trialEnds.setDate(trialEnds.getDate() + trialDays);
    
    return this.trackEvent('trial_start', userId, {
      plan,
      trial_days: trialDays,
      trial_ends_at: trialEnds.toISOString().split('T')[0]
    }, {
      funnel_sales_step: 2,
      funnel_sales_name: 'Триал'
    });
  }
  
  // Создание подписки (первый платёж)
  trackSubscriptionCreated(userId, plan, amount, billingPeriod = 'month') {
    return this.trackEvent('subscription_created', userId, {
      plan,
      amount,
      billing_period: billingPeriod,
      created_at: new Date().toISOString()
    }, {
      funnel_sales_step: 3,
      funnel_sales_name: 'Платная подписка',
      is_order: true,
      order_revenue_field: 'amount'
    });
  }
  
  // Ежемесячный платёж
  trackSubscriptionPayment(userId, plan, amount, invoiceId) {
    return this.trackEvent('subscription_payment', userId, {
      plan,
      amount,
      invoice_id: invoiceId,
      payment_date: new Date().toISOString().split('T')[0]
    }, {
      is_order: true,
      order_revenue_field: 'amount'
    });
  }
  
  // Отмена подписки
  trackSubscriptionCancelled(userId, plan, reason) {
    return this.trackEvent('subscription_cancelled', userId, {
      plan,
      reason,
      cancelled_at: new Date().toISOString()
    }, {
      event_display_name: 'Отмена подписки'
    });
  }
  
  // Апгрейд тарифа
  trackSubscriptionUpgraded(userId, oldPlan, newPlan, amount) {
    return this.trackEvent('subscription_upgraded', userId, {
      old_plan: oldPlan,
      new_plan: newPlan,
      amount,
      upgraded_at: new Date().toISOString()
    }, {
      is_order: true,
      order_revenue_field: 'amount',
      event_display_name: 'Апгрейд тарифа'
    });
  }
  
  // Использование функции
  trackFeatureUsed(userId, feature, value = null) {
    return this.trackEvent('feature_used', userId, {
      feature,
      value,
      used_at: new Date().toISOString()
    });
  }
}

// Использование
const tracker = new SaaSSubscriptionTracker('your_api_key');

// При регистрации
tracker.trackSignup('user_123', {
  email: 'user@example.com',
  name: 'Иван Петров',
  company: 'ООО Ромашка'
}, 'google_ads');

// При создании проекта (активация)
tracker.trackActivation('user_123', 'project_created');

// При начале триала
tracker.trackTrialStart('user_123', 'pro', 14);

// При переходе на платный тариф
tracker.trackSubscriptionCreated('user_123', 'pro', 9900);

// Ежемесячный платёж
tracker.trackSubscriptionPayment('user_123', 'pro', 9900, 'INV-001');

// При отмене
tracker.trackSubscriptionCancelled('user_123', 'pro', 'too_expensive');

// Обработчик вебхука Stripe
app.post('/webhooks/stripe', async (req, res) => {
  const event = req.body;
  const tracker = new SaaSSubscriptionTracker(process.env.INSTANTBASE_API_KEY);
  
  switch (event.type) {
    case 'customer.subscription.created':
      await tracker.trackSubscriptionCreated(
        event.data.object.customer,
        event.data.object.items.data[0].price.nickname,
        event.data.object.items.data[0].price.unit_amount / 100,
        event.data.object.plan.interval
      );
      break;
      
    case 'invoice.payment_succeeded':
      await tracker.trackSubscriptionPayment(
        event.data.object.customer,
        event.data.object.lines.data[0].price?.nickname || 'unknown',
        event.data.object.amount_paid / 100,
        event.data.object.id
      );
      break;
      
    case 'customer.subscription.deleted':
      await tracker.trackSubscriptionCancelled(
        event.data.object.customer,
        event.data.object.items.data[0].price.nickname,
        'cancelled'
      );
      break;
  }
  
  res.status(200).send('OK');
});

// Обработчик вебхука YooKassa
app.post('/webhooks/yookassa', async (req, res) => {
  const event = req.body;
  const tracker = new SaaSSubscriptionTracker(process.env.INSTANTBASE_API_KEY);
  
  if (event.event === 'payment.succeeded') {
    await tracker.trackSubscriptionPayment(
      event.object.metadata.user_id,
      event.object.metadata.plan || 'unknown',
      event.object.amount.value,
      event.object.id
    );
  }
  
  res.status(200).send('OK');
});