Αναλυτικά στοιχεία εφαρμογής
Το Stripe παρέχει ενσωματωμένα αναλυτικά στοιχεία για τις δημοσιευμένες εφαρμογές του marketplace, δίνοντάς σας εικόνα για τις εγκαταστάσεις, την απόδοση της καταχώρισης και την ενεργοποίηση των χρηστών. Μπορείτε επίσης να δημιουργήσετε προσαρμοσμένα αναλυτικά στοιχεία με webhooks και το API του Stripe.
Διαθέσιμες αναφορές
Ο πίνακας ελέγχου του Stripe παρέχει τα ακόλουθα αναλυτικά στοιχεία για τη δημοσιευμένη εφαρμογή σας:
Μετρήσεις εγκαταστάσεων
| Μέτρηση | Περιγραφή |
|---|---|
| Εγκαταστάσεις | Συνολικός αριθμός νέων εγκαταστάσεων της εφαρμογής στην επιλεγμένη περίοδο |
| Απεγκαταστάσεις | Συνολικός αριθμός απεγκαταστάσεων της εφαρμογής στην επιλεγμένη περίοδο |
| Σωρευτικές καθαρές εγκαταστάσεις | Τρέχον σύνολο εγκαταστάσεων μείον απεγκαταστάσεις με την πάροδο του χρόνου |
Απόδοση καταχώρισης
| Μέτρηση | Περιγραφή |
|---|---|
| Προβολές καταχώρισης | Συνολικές προβολές σελίδας για την καταχώριση της εφαρμογής σας στο marketplace |
| Μοναδικές προβολές | Μοναδικοί επισκέπτες που είδαν την καταχώρισή σας στο marketplace |
| Ποσοστό μετατροπής MoM | Μηνιαίο ποσοστό (μήνα προς μήνα) των επισκεπτών της καταχώρισης που εγκαθιστούν την εφαρμογή |
Μετρήσεις ανάπτυξης
| Μέτρηση | Περιγραφή |
|---|---|
| Ρυθμός ανάπτυξης MoM | Ανάπτυξη των καθαρών εγκαταστάσεων από μήνα σε μήνα |
| Ποσοστό αποχώρησης | Ποσοστό των χρηστών με εγκατεστημένη εφαρμογή που την απεγκαθιστούν ανά μήνα |
Επικαιρότητα των δεδομένων
Caution
Τα αναλυτικά δεδομένα έχουν καθυστέρηση 48 ωρών. Τα δεδομένα που βλέπετε στον πίνακα ελέγχου αντικατοπτρίζουν δραστηριότητα περίπου δύο ημερών πριν. Προγραμματίστε ανάλογα τα χρονικά παράθυρα των αναφορών σας.
- Τα δεδομένα ενημερώνονται καθημερινά, με καθυστέρηση επεξεργασίας 48 ωρών
- Τα ιστορικά δεδομένα είναι διαθέσιμα από την ημερομηνία της πρώτης δημοσίευσης της εφαρμογής σας
- Οι μετρήσεις υπολογίζονται στη ζώνη ώρας UTC
- Εξαγάγετε τα δεδομένα σε CSV από τον πίνακα ελέγχου του Stripe για εξωτερική ανάλυση
Πρόσβαση στα αναλυτικά στοιχεία μέσω API
Μπορείτε να αποκτήσετε προγραμματιστική πρόσβαση στα αναλυτικά στοιχεία της εφαρμογής μέσω του Reporting API του Stripe:
Δεδομένα εγκαταστάσεων
# 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"Προβολές καταχώρισης
# 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"Προγραμματιστική πρόσβαση (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;};Καρτέλα χρηστών
Η καρτέλα χρηστών στα αναλυτικά στοιχεία της εφαρμογής σας εμφανίζει δεδομένα σε επίπεδο μεμονωμένου λογαριασμού:
| Στήλη | Περιγραφή |
|---|---|
| Αναγνωριστικό λογαριασμού | Ο λογαριασμός Stripe που εγκατέστησε την εφαρμογή σας |
| Ημερομηνία εγκατάστασης | Πότε εγκαταστάθηκε η εφαρμογή |
| Κατάσταση | Ενεργή ή απεγκατεστημένη |
| Ημερομηνία απεγκατάστασης | Πότε απεγκαταστάθηκε η εφαρμογή (εφόσον ισχύει) |
Χρησιμοποιήστε αυτά τα δεδομένα για να:
- Παρακολουθείτε την κατάσταση ενεργοποίησης κάθε λογαριασμού
- Επικοινωνείτε με λογαριασμούς που έκαναν εγκατάσταση αλλά δεν ολοκλήρωσαν την αρχική ρύθμιση
- Εντοπίζετε λογαριασμούς που απεγκατέστησαν την εφαρμογή και να κατανοείτε τους λόγους αποχώρησης
- Συσχετίζετε τα δεδομένα εγκαταστάσεων με τα δικά σας αναλυτικά στοιχεία πλατφόρμας
Προσαρμοσμένα αναλυτικά στοιχεία με webhooks
Για αναλυτικά στοιχεία σε πραγματικό χρόνο και βαθύτερη κατανόηση, ρυθμίστε webhooks που παρακολουθούν τα συμβάντα της εφαρμογής:
Συμβάντα webhook
Παρακολουθήστε αυτά τα συμβάντα για να δημιουργήσετε προσαρμοσμένα αναλυτικά στοιχεία:
| Συμβάν | Περιγραφή |
|---|---|
account.application.authorized | Ο χρήστης εγκατέστησε την εφαρμογή σας |
account.application.deauthorized | Ο χρήστης απεγκατέστησε την εφαρμογή σας |
Χειριστής webhook
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 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;};Δημιουργία προσαρμοσμένου πίνακα ελέγχου αναλυτικών στοιχείων
Συνδυάστε τα αναλυτικά στοιχεία του Stripe με τα δικά σας δεδομένα για μια συνολική εικόνα:
// 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, };};Βασικές μετρήσεις προς παρακολούθηση
Για την ενσωμάτωση Tajo Brevo, επικεντρωθείτε σε αυτές τις μετρήσεις:
| Μέτρηση | Στόχος | Γιατί έχει σημασία |
|---|---|---|
| Ποσοστό εγκατάστασης προς ενεργοποίηση | > 70% | Ποσοστό όσων εγκαθιστούν την εφαρμογή και ολοκληρώνουν τη ρύθμιση του Brevo |
| Χρόνος έως τον πρώτο συγχρονισμό | < 5 λεπτά | Πόσο γρήγορα οι χρήστες βλέπουν αξία μετά την εγκατάσταση |
| Διατήρηση 30 ημερών | > 80% | Ποσοστό χρηστών που παραμένουν ενεργοί μετά από 30 ημέρες |
| Μηνιαίο ποσοστό αποχώρησης | < 5% | Κρατήστε χαμηλά τις απεγκαταστάσεις με μια ενσωμάτωση που προσφέρει αξία |
| Ποσοστό μετατροπής καταχώρισης | > 15% | Ποσοστό των επισκεπτών της καταχώρισης που κάνουν εγκατάσταση |
| Συγχρονισμένοι πελάτες ανά λογαριασμό | > 100 | Δείχνει το βάθος χρήσης της ενσωμάτωσης |
Tip
Ρυθμίστε αυτοματοποιημένες ειδοποιήσεις για σημαντικές μεταβολές στις μετρήσεις. Μια απότομη αύξηση των απεγκαταστάσεων ή πτώση του ποσοστού ενεργοποίησης μπορεί να υποδεικνύει σφάλμα ή πρόβλημα εμπειρίας χρήστη που χρειάζεται άμεση προσοχή.