App-analyse
Stripe har innebygd analyse for publiserte marketplace-apper, slik at du ser installasjoner, hvordan oppføringen presterer og hvor engasjerte brukerne er. Du kan også bygge din egen analyse med webhooks og Stripe API.
Tilgjengelige rapporter
Stripe-dashboardet gir deg denne analysen for den publiserte appen din:
Installasjonstall
| Måling | Beskrivelse |
|---|---|
| Installasjoner | Totalt antall nye appinstallasjoner i valgt periode |
| Avinstallasjoner | Totalt antall avinstallasjoner i valgt periode |
| Kumulative nettoinstallasjoner | Løpende sum av installasjoner minus avinstallasjoner over tid |
Hvordan oppføringen presterer
| Måling | Beskrivelse |
|---|---|
| Visninger av oppføring | Totalt antall sidevisninger av appens marketplace-oppføring |
| Unike visninger | Unike besøkende som har sett marketplace-oppføringen din |
| Konverteringsrate måned for måned | Andelen av dem som ser oppføringen og installerer appen, målt måned for måned |
Vekstmålinger
| Måling | Beskrivelse |
|---|---|
| Vekstrate måned for måned | Vekst i nettoinstallasjoner fra måned til måned |
| Churn-rate | Andelen av brukerne med appen installert som avinstallerer per måned |
Dataferskhet
Caution
Analysedataene har en forsinkelse på 48 timer. Det du ser i dashboardet gjenspeiler aktivitet fra omtrent to dager tilbake. Planlegg rapporteringsvinduene dine deretter.
- Dataene oppdateres daglig, med 48 timers behandlingstid
- Historiske data er tilgjengelige fra datoen appen din ble publisert første gang
- Målingene beregnes i tidssonen UTC
- Eksporter data som CSV fra Stripe-dashboardet for analyse utenfor Stripe
Hent analysen via API
Du kan hente appanalysen programmatisk med Stripe Reporting API:
Installasjonsdata
# 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"Visninger av oppføring
# 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"Programmatisk tilgang (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;};Fanen Users
Fanen Users i appanalysen viser data på nivå med den enkelte kontoen:
| Kolonne | Beskrivelse |
|---|---|
| Account ID | Stripe-kontoen som installerte appen din |
| Install Date | Når appen ble installert |
| Status | Aktiv eller avinstallert |
| Uninstall Date | Når appen ble avinstallert, hvis det har skjedd |
Bruk disse dataene til å:
- Følge aktiveringsstatus for den enkelte kontoen
- Ta kontakt med kontoer som har installert, men ikke fullført oppstarten
- Finne kontoer som har avinstallert, og forstå hvorfor de forsvinner
- Se installasjonsdataene i sammenheng med analysen på din egen plattform
Egen analyse med webhooks
Vil du ha analyse i sanntid og gå dypere, setter du opp webhooks som følger apphendelsene:
Webhook-hendelser
Lytt etter disse hendelsene for å bygge din egen analyse:
| Hendelse | Beskrivelse |
|---|---|
account.application.authorized | Brukeren installerte appen din |
account.application.deauthorized | Brukeren avinstallerte appen din |
Webhook-håndterer
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
For Connect-plattformer bruker du Connect List API for å hente informasjon om kontoene som har appen din installert:
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;};Bygg ditt eget analysedashboard
Kombiner Stripe-analysen med dine egne data for å få hele bildet:
// 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, };};Nøkkeltall du bør følge
For Tajos Brevo-integrasjon bør du konsentrere deg om disse målingene:
| Måling | Mål | Hvorfor det betyr noe |
|---|---|---|
| Andel installasjoner som blir aktivert | > 70 % | Andelen av dem som installerer og fullfører oppsettet av Brevo |
| Tid til første synkronisering | < 5 minutter | Hvor raskt brukerne får verdi etter installasjonen |
| Andel som er igjen etter 30 dager | > 80 % | Andelen brukere som fortsatt er aktive etter 30 dager |
| Månedlig churn-rate | < 5 % | Hold avinstallasjonene lave med en integrasjon som gir verdi |
| Konverteringsrate for oppføringen | > 15 % | Andelen av dem som ser oppføringen og installerer |
| Kunder synkronisert per konto | > 100 | Sier noe om hvor dypt integrasjonen tas i bruk |
Tip
Sett opp automatiske varsler for store endringer i tallene. En plutselig topp i avinstallasjoner eller et fall i aktiveringsraten kan tyde på en feil eller et UX-problem som må håndteres med en gang.