On this page

Аналитика приложения

Stripe предоставляет встроенную аналитику для опубликованных приложений маркетплейса, обеспечивая видимость установок, эффективности листинга и вовлечённости пользователей. Вы также можете создавать пользовательскую аналитику с помощью вебхуков и Stripe API.

Доступные отчёты

Stripe Dashboard предоставляет следующую аналитику для опубликованного приложения:

Метрики установок

Метрика	Описание
Installs	Общее количество новых установок приложения за выбранный период
Uninstalls	Общее количество удалений приложения за выбранный период
Cumulative Net Installs	Накопительный итог установок минус удаления

Эффективность листинга

Метрика	Описание
Listing Views	Общее количество просмотров листинга на маркетплейсе
Unique Views	Уникальные посетители, просмотревшие листинг
MoM Conversion Rate	Ежемесячный процент посетителей листинга, установивших приложение

Метрики роста

Метрика	Описание
MoM Growth Rate	Ежемесячный рост чистых установок
Churn Rate	Процент установленных пользователей, удаляющих приложение в месяц

Актуальность данных

Caution

Аналитические данные имеют задержку 48 часов. Данные в панели отражают активность примерно двухдневной давности. Учитывайте это при планировании отчётных периодов.

Данные обновляются ежедневно с задержкой обработки 48 часов
Исторические данные доступны с момента первой публикации приложения
Метрики рассчитываются в часовом поясе UTC
Экспортируйте данные в CSV из Stripe Dashboard для внешнего анализа

Доступ к аналитике через API

# Fetch app install report
curl https://api.stripe.com/v1/reporting/report_runs \
  -u sk_live_xxxxx: \
  -d "report_type=app.installs.daily" \
  -d "parameters[interval_start]=1709251200" \
  -d "parameters[interval_end]=1711929600" \
  -d "parameters[app_id]=com.tajo.brevo-integration"

Программный доступ (Node.js)

const stripe = require('stripe')('sk_live_xxxxx');

// Create a report run for app installs
const reportRun = await stripe.reporting.reportRuns.create({
  report_type: 'app.installs.daily',
  parameters: {
    interval_start: Math.floor(new Date('2025-03-01').getTime() / 1000),
    interval_end: Math.floor(new Date('2025-03-31').getTime() / 1000),
    app_id: 'com.tajo.brevo-integration',
  },
});

Пользовательская аналитика с вебхуками

События вебхуков

Событие	Описание
`account.application.authorized`	Пользователь установил ваше приложение
`account.application.deauthorized`	Пользователь удалил ваше приложение

Обработчик вебхука

const express = require('express');
const stripe = require('stripe')('sk_live_xxxxx');

const app = express();

app.post('/webhooks/stripe-app', express.raw({ type: 'application/json' }), async (req, res) => {
  const sig = req.headers['stripe-signature'];
  const webhookSecret = process.env.STRIPE_APP_WEBHOOK_SECRET;

  let event;

  try {
    event = stripe.webhooks.constructEvent(req.body, sig, webhookSecret);
  } catch (err) {
    console.error('Webhook signature verification failed:', err.message);
    return res.status(400).send('Webhook signature verification failed');
  }

  switch (event.type) {
    case 'account.application.authorized': {
      const account = event.data.object;
      console.log('App installed by:', account.id);

      // Track in your analytics system
      await trackEvent('app_installed', {
        account_id: account.id,
        timestamp: new Date(event.created * 1000),
      });

      // Trigger onboarding email
      await sendOnboardingEmail(account.id);
      break;
    }

    case 'account.application.deauthorized': {
      const account = event.data.object;
      console.log('App uninstalled by:', account.id);

      // Track churn
      await trackEvent('app_uninstalled', {
        account_id: account.id,
        timestamp: new Date(event.created * 1000),
      });

      // Clean up account data
      await cleanupAccountData(account.id);
      break;
    }
  }

  res.json({ received: true });
});

Ключевые метрики для отслеживания

Для интеграции Tajo Brevo сосредоточьтесь на следующих метриках:

Метрика	Цель	Почему важна
Конверсия установки в активацию	> 70%	Процент установивших, завершивших настройку Brevo
Время до первой синхронизации	<5 минут	Как быстро пользователи видят ценность после установки
Удержание за 30 дней	> 80%	Процент активных пользователей через 30 дней
Ежемесячный отток	<5%	Поддерживайте низкий процент удалений
Конверсия листинга	> 15%	Процент просмотревших листинг, установивших приложение
Синхронизированных покупателей на аккаунт	> 100	Показывает глубину использования интеграции

Tip

Настройте автоматические оповещения при значительных изменениях метрик. Резкий рост удалений или снижение активации может указывать на ошибку или UX-проблему, требующую немедленного внимания.