Analytika aplikácie
Stripe poskytuje pre publikované aplikácie v marketplace zabudovanú analytiku, ktorá Vám dáva prehľad o inštaláciách, výkone listingu a zapojení používateľov. Vlastnú analytiku si navyše môžete postaviť pomocou webhookov a Stripe API.
Dostupné reporty
Dashboard Stripe poskytuje pre Vašu publikovanú aplikáciu nasledujúce analytické údaje:
Metriky inštalácií
| Metrika | Popis |
|---|---|
| Inštalácie | Celkový počet nových inštalácií aplikácie vo zvolenom období |
| Odinštalovania | Celkový počet odinštalovaní aplikácie vo zvolenom období |
| Kumulatívne čisté inštalácie | Priebežný súčet inštalácií po odpočítaní odinštalovaní v čase |
Výkon listingu
| Metrika | Popis |
|---|---|
| Zobrazenia listingu | Celkový počet zobrazení stránky Vášho listingu v marketplace |
| Unikátne zobrazenia | Unikátni návštevníci, ktorí si pozreli Váš listing v marketplace |
| Medzimesačný konverzný pomer | Medzimesačné percento návštevníkov listingu, ktorí si aplikáciu nainštalujú |
Metriky rastu
| Metrika | Popis |
|---|---|
| Medzimesačná miera rastu | Medzimesačný rast čistých inštalácií |
| Miera odchodu | Percento používateľov s inštaláciou, ktorí aplikáciu za mesiac odinštalujú |
Aktuálnosť dát
Caution
Analytické dáta majú 48-hodinové oneskorenie. Údaje, ktoré vidíte v dashboarde, zodpovedajú aktivite spred približne dvoch dní. Podľa toho si naplánujte obdobia svojich reportov.
- Dáta sa aktualizujú denne s 48-hodinovým oneskorením spracovania
- Historické dáta sú dostupné od dátumu, keď bola Vaša aplikácia prvýkrát publikovaná
- Metriky sa počítajú v časovom pásme UTC
- Dáta si môžete z dashboardu Stripe exportovať ako CSV a analyzovať externe
Prístup k analytike cez API
K analytike aplikácie sa dostanete aj programovo cez Stripe Reporting API:
Dáta o inštaláciách
# Fetch app install reportcurl 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"Zobrazenia listingu
# Fetch listing views reportcurl 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"Programový prístup (Node.js)
const stripe = require('stripe')('sk_live_xxxxx');
// Create a report run for app installsconst 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 completionconst 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;};Záložka Users
Záložka Users v analytike Vašej aplikácie zobrazuje dáta na úrovni jednotlivých účtov:
| Stĺpec | Popis |
|---|---|
| ID účtu | Účet Stripe, ktorý si nainštaloval Vašu aplikáciu |
| Dátum inštalácie | Kedy bola aplikácia nainštalovaná |
| Stav | Aktívna alebo odinštalovaná |
| Dátum odinštalovania | Kedy bola aplikácia odinštalovaná (ak nastalo) |
Tieto dáta použite na to, aby ste:
- Sledovali stav aktivácie jednotlivých účtov
- Oslovili účty, ktoré si aplikáciu nainštalovali, ale nedokončili onboarding
- Identifikovali účty, ktoré odinštalovali, a pochopili dôvody odchodu
- Prepojili dáta o inštaláciách s analytikou vlastnej platformy
Vlastná analytika pomocou webhookov
Pre analytiku v reálnom čase a hlbšie prehľady si nastavte webhooky na sledovanie udalostí aplikácie:
Udalosti webhookov
Na tieto udalosti sa napojte, ak si chcete postaviť vlastnú analytiku:
| Udalosť | Popis |
|---|---|
account.application.authorized | Používateľ si nainštaloval Vašu aplikáciu |
account.application.deauthorized | Používateľ odinštaloval Vašu aplikáciu |
Obsluha webhooku
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
Na platformách Connect použite Connect List API na získanie informácií o účtoch, ktoré majú Vašu aplikáciu nainštalovanú:
const stripe = require('stripe')('sk_live_xxxxx');
// List all connected accounts with your app installedconst 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;};Zostavenie vlastného analytického dashboardu
Skombinujte analytiku Stripe s vlastnými dátami a získate ucelený pohľad:
// Aggregate analytics for reportingconst 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, };};Kľúčové metriky na sledovanie
Pri integrácii Tajo s Brevo sa sústreďte na tieto metriky:
| Metrika | Cieľ | Prečo na nej záleží |
|---|---|---|
| Pomer inštalácia k aktivácii | > 70 % | Percento inštalujúcich, ktorí dokončia nastavenie Brevo |
| Čas do prvej synchronizácie | < 5 minút | Ako rýchlo používatelia po inštalácii uvidia prínos |
| 30-dňová retencia | > 80 % | Percento používateľov, ktorí sú po 30 dňoch stále aktívni |
| Mesačná miera odchodu | < 5 % | Hodnotná integrácia drží počet odinštalovaní nízko |
| Konverzný pomer listingu | > 15 % | Percento návštevníkov listingu, ktorí si aplikáciu nainštalujú |
| Počet synchronizovaných zákazníkov na účet | > 100 | Ukazuje, ako do hĺbky sa integrácia využíva |
Tip
Nastavte si automatické upozornenia na výrazné zmeny metrík. Náhly nárast odinštalovaní alebo pokles miery aktivácie môže signalizovať chybu alebo problém s UX, ktorý si vyžaduje okamžitú pozornosť.