Подайте заявку на ранний доступ

Укажите имя, а также email или номер телефона. Мы отправим Вам информацию о доступе к Tajo.

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

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

Получить аналитику приложения программно можно через Stripe Reporting API:

Данные об установках

Terminal window
# 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"

Просмотры листинга

Terminal window
# Fetch listing views report
curl https://api.stripe.com/v1/reporting/report_runs \
-u sk_live_xxxxx: \
-d "report_type=app.listing_views.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',
},
});
// Poll for report completion
const checkReport = async (reportId) => {
const report = await stripe.reporting.reportRuns.retrieve(reportId);
if (report.status === 'succeeded') {
// Download the report file
const file = await stripe.files.retrieve(report.result.id);
console.log('Report URL:', file.url);
return file;
}
if (report.status === 'failed') {
throw new Error('Report generation failed');
}
// Report still processing
return null;
};

Вкладка Users

Вкладка Users в аналитике приложения показывает данные по отдельным аккаунтам:

СтолбецОписание
Account IDАккаунт Stripe, установивший ваше приложение
Install DateКогда приложение было установлено
StatusАктивно или удалено
Uninstall DateКогда приложение было удалено (если применимо)

Используйте эти данные, чтобы:

  • Отслеживать статус активации по каждому аккаунту
  • Связываться с аккаунтами, которые установили приложение, но не завершили онбординг
  • Выявлять аккаунты, удалившие приложение, и понимать причины оттока
  • Сопоставлять данные об установках с аналитикой своей платформы

Собственная аналитика на вебхуках

Для аналитики в реальном времени и более глубоких выводов настройте вебхуки, отслеживающие события приложения:

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

Подпишитесь на эти события, чтобы построить собственную аналитику:

СобытиеОписание
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;
}
default:
console.log('Unhandled event type:', event.type);
}
res.json({ received: true });
});

Connect List API

Платформам Connect подойдёт Connect List API: он возвращает сведения об аккаунтах, где установлено ваше приложение:

const stripe = require('stripe')('sk_live_xxxxx');
// List all connected accounts with your app installed
const getInstalledAccounts = async () => {
const accounts = [];
let hasMore = true;
let startingAfter = null;
while (hasMore) {
const params = { limit: 100 };
if (startingAfter) {
params.starting_after = startingAfter;
}
const response = await stripe.accounts.list(params);
for (const account of response.data) {
// Check if your app is installed on this account
if (account.settings?.apps?.includes('com.tajo.brevo-integration')) {
accounts.push({
id: account.id,
email: account.email,
created: account.created,
});
}
}
hasMore = response.has_more;
if (response.data.length > 0) {
startingAfter = response.data[response.data.length - 1].id;
}
}
return accounts;
};

Создание собственного дашборда аналитики

Объедините аналитику Stripe со своими данными, чтобы получить полную картину:

// Aggregate analytics for reporting
const getAppAnalytics = async (startDate, endDate) => {
const [stripeInstalls, brevoSyncStats, activationData] = await Promise.all([
// Stripe install data
getStripeInstallReport(startDate, endDate),
// Brevo sync metrics from Tajo
getBrevoSyncMetrics(startDate, endDate),
// Activation funnel from your database
getActivationFunnel(startDate, endDate),
]);
return {
// Acquisition
totalInstalls: stripeInstalls.installs,
totalUninstalls: stripeInstalls.uninstalls,
netInstalls: stripeInstalls.installs - stripeInstalls.uninstalls,
listingConversionRate: stripeInstalls.conversionRate,
// Activation
onboardingCompleted: activationData.completedOnboarding,
brevoConnected: activationData.connectedBrevo,
firstSyncCompleted: activationData.firstSyncCompleted,
activationRate: activationData.completedOnboarding / stripeInstalls.installs,
// Engagement
totalCustomersSynced: brevoSyncStats.totalCustomers,
totalEventsSynced: brevoSyncStats.totalEvents,
averageSyncFrequency: brevoSyncStats.avgSyncPerDay,
// Retention
churnRate: stripeInstalls.uninstalls / stripeInstalls.totalActive,
monthlyGrowthRate: stripeInstalls.momGrowth,
};
};

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

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

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

Tip

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

Подайте заявку на ранний доступ

Укажите имя, а также email или номер телефона. Мы отправим Вам информацию о доступе к Tajo.

определим автоматически
AI-ассистент

Привет! Спрашивайте меня о документации.