Alkalmazás-analitika
A Stripe beépített analitikát ad a piactéren közzétett alkalmazásokhoz, így rálátsz a telepítésekre, a listázás teljesítményére és a felhasználói aktivitásra. Webhookokkal és a Stripe API-val saját analitikát is építhetsz.
Elérhető jelentések
A Stripe Dashboard a következő analitikát kínálja a közzétett alkalmazásodhoz:
Telepítési metrikák
| Metrika | Leírás |
|---|---|
| Telepítések | Az új alkalmazástelepítések száma a kiválasztott időszakban |
| Eltávolítások | Az alkalmazás-eltávolítások száma a kiválasztott időszakban |
| Halmozott nettó telepítés | A telepítések mínusz eltávolítások futó összege az idő során |
A listázás teljesítménye
| Metrika | Leírás |
|---|---|
| Listázás megtekintései | Az alkalmazásod piactéri listázásának összes oldalmegtekintése |
| Egyedi megtekintések | A piactéri listázásodat megtekintő egyedi látogatók |
| Havi konverziós arány | A listázást megtekintők közül az alkalmazást telepítők havi összehasonlításban vett aránya |
Növekedési metrikák
| Metrika | Leírás |
|---|---|
| Havi növekedési ütem | A nettó telepítések előző hónaphoz mért növekedése |
| Lemorzsolódási arány | A telepített felhasználók havonta eltávolító hányada |
Az adatok frissessége
Caution
Az analitikai adatok 48 órás késéssel érkeznek. Amit a dashboardon látsz, az nagyjából két nappal korábbi aktivitást tükröz. Ehhez igazítsd a riportolási időablakaidat.
- Az adatok naponta frissülnek, 48 órás feldolgozási késéssel
- A korábbi adatok az alkalmazás első közzétételének napjától érhetők el
- A metrikák UTC időzónában számolódnak
- Az adatokat CSV-ben exportálhatod a Stripe Dashboardból külső elemzéshez
Analitika elérése API-n keresztül
Az alkalmazás analitikáját programozottan is elérheted a Stripe Reporting API-val:
Telepítési adatok
# 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"Listázás megtekintései
# 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"Programozott hozzáférés (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;};Users fül
Az alkalmazás analitikájának Users fülén az egyes fiókok szintjén látod az adatokat:
| Oszlop | Leírás |
|---|---|
| Account ID | Az a Stripe fiók, amely telepítette az alkalmazásodat |
| Telepítés dátuma | Mikor telepítették az alkalmazást |
| Állapot | Aktív vagy eltávolított |
| Eltávolítás dátuma | Mikor távolították el az alkalmazást (ha volt ilyen) |
Ezeket az adatokat így használhatod:
- Kövesd az egyes fiókok aktiválási állapotát
- Keresd meg azokat a fiókokat, amelyek telepítettek, de nem fejezték be a bevezetést
- Azonosítsd az eltávolító fiókokat, és értsd meg a lemorzsolódás okait
- Vesd össze a telepítési adatokat a saját platformod analitikájával
Saját analitika webhookokkal
Valós idejű analitikához és mélyebb elemzésekhez állíts be webhookokat az alkalmazás eseményeire:
Webhook események
Ezekre az eseményekre figyelj, ha saját analitikát építesz:
| Esemény | Leírás |
|---|---|
account.application.authorized | A felhasználó telepítette az alkalmazásodat |
account.application.deauthorized | A felhasználó eltávolította az alkalmazásodat |
Webhook kezelő
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 platformoknál a Connect List API-val kérdezheted le azokat a fiókokat, amelyekre telepítve van az alkalmazásod:
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;};Saját analitikai dashboard építése
Kombináld a Stripe analitikáját a saját adataiddal a teljes képért:
// 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, };};A legfontosabb követendő metrikák
A Tajo Brevo integrációnál ezekre a metrikákra érdemes koncentrálni:
| Metrika | Célérték | Miért számít |
|---|---|---|
| Telepítés-aktiválás arány | > 70% | A telepítők közül hányan fejezik be a Brevo beállítását |
| Első szinkronizálásig eltelt idő | < 5 perc | Milyen gyorsan látja a felhasználó az értéket telepítés után |
| 30 napos megtartás | > 80% | A felhasználók hány százaléka aktív még 30 nap után |
| Havi lemorzsolódási arány | < 5% | Egy értékes integrációval alacsonyan tartható az eltávolítás |
| Listázás konverziós aránya | > 15% | A listázást megtekintők közül hányan telepítenek |
| Fiókonként szinkronizált vásárlók | > 100 | Megmutatja, milyen mélyen használják az integrációt |
Tip
Állíts be automatikus riasztásokat a jelentős metrikaváltozásokra. Az eltávolítások hirtelen megugrása vagy az aktiválási arány esése hibára vagy UX-problémára utalhat, amivel azonnal foglalkozni kell.