[XB] User Upgrade Statistics: Sales, Revenue & Retention Analytics 1.0.0

Track XenForo User Upgrade purchases, revenue, renewals, retention, refunds, and active subscriptions from a dedicated statistics dashboard in the Admin Control Panel.

User Upgrade Statistics provides detailed sales and financial analytics for paid user upgrades, including historical trends, payment provider breakdowns, recurring renewal performance, customer metrics, lifecycle statistics, and revenue comparisons.

---

Features:​

Sales & Purchase Statistics​

• User Upgrade Sales Statistics: Track successful XenForo User Upgrade purchases, including initial purchases and recurring renewals.
• Daily, Weekly & Monthly Charts: Analyze upgrade purchases over different reporting periods using XenForo's statistics interface.
• Totals & Daily Averages: Switch between total purchase counts and average daily activity.
• Multiple Data Series: Compare up to 15 upgrade series simultaneously.
• Purchase Totals: Review total purchases for the selected reporting period.
• Unique Purchasers: See how many individual members purchased user upgrades.
• Renewal Statistics: Track recurring renewal purchases separately from initial purchases.
• Purchases per Customer: Measure how many upgrade purchases each customer generates on average.
• Upgrade Breakdown: Compare purchases across individual user upgrades using a horizontal chart.
• Payment Provider Breakdown: Analyze purchases by payment provider, including renewal share.
• Payment Profile Filter: Filter purchase and revenue analytics by XenForo payment profile.

Revenue & Financial Analytics​

• Revenue Tracking: Report user upgrade revenue separately for each currency.
• Gross & Net Revenue: Compare gross payment volume with net financial results.
• Initial Purchase Revenue: Track revenue generated from new upgrade purchases separately.
• Renewal Revenue: Measure revenue generated by recurring subscription renewals.
• ↩ Refund Tracking: Track refunded user upgrade revenue.
• ♻ Reinstated Revenue: Account separately for payments that were reversed and later reinstated.
• Period Comparison: Compare financial performance with the immediately preceding equivalent period.
• Multi-Currency Reporting: Keep financial totals separated by currency instead of combining incompatible values.

Retention & Recurring Upgrades​

• Renewal Retention: Measure recurring user upgrade retention using transaction-based renewal activity.
• Monthly Cohorts: Analyze renewal behavior by purchase cohort.
• Per-Upgrade Retention: Compare retention rates independently for different user upgrades.
• Customer Retention Analytics: Understand how effectively recurring upgrades retain paying members over time.

Upgrade Lifecycle Statistics​

• Active Upgrades: Monitor the current number of active user upgrades.
• New Activations: Track newly activated upgrades during the selected period.
• Expirations: Review user upgrades that expired during the reporting period.
• Upcoming Expirations: See upgrades approaching their expiration date.
• Active Upgrade Distribution: Compare the current active member distribution across individual upgrades.
• 🗂 Dedicated Reporting Tabs: Keep sales and revenue analytics separate from upgrade lifecycle statistics for clearer reporting.

Historical Data & Maintenance​

• Purchase History: Maintain a dedicated record of successfully received upgrade payments.
• Recurring Payment Tracking: Record recurring renewals without counting repeated payment callbacks as additional purchases.
• ↩ Payment Adjustments: Correct financial reporting when payments are reversed or reinstated.
• 🏷 Historical Upgrade Labels: Preserve historical reporting labels even when a user upgrade is later deleted.
• 🛠 Statistics Rebuild Tool: Rebuild purchase and financial statistics from retained successful XenForo payment logs.

---

Usage:​

Open Setup > User upgrades in the XenForo Admin Control Panel and select User upgrade statistics.

After installation, retained successful user upgrade payment logs are imported automatically. Historical payments that are no longer available in XenForo's payment provider log cannot be recovered.

---

Permissions:​

• Manage User Upgrades: Required to access user upgrade management.
• View Statistics: Required to access the User Upgrade Statistics dashboard.

Administrators must have both permissions to view the statistics page.

---

Requirements:​

• XenForo 2.3.0+
• [XB] Core Library 1.0.1+

---

Useful for:​

• User Upgrade Revenue: Track how much revenue paid memberships and upgrades generate.
• Sales Analytics: Measure purchases, customers, renewals, refunds, and payment provider performance.
• Subscription Analytics: Monitor recurring upgrade renewals and recurring revenue.
• Retention Analysis: Measure renewal retention with monthly cohorts and per-upgrade statistics.
• Payment Analysis: Compare upgrade sales across XenForo payment profiles and providers.
• Membership Analytics: Monitor active upgrades, new activations, expirations, and upcoming expirations.
• Financial Reporting: Compare current revenue and sales performance with previous periods.
• Upgrade Optimization: Identify which paid user upgrades generate purchases, recurring renewals, and retained customers.

---

FAQ:​

• Does the add-on track recurring XenForo User Upgrade renewals? Yes. Recurring renewals are recorded separately from initial purchases and are included in revenue and retention reporting.
• Can I see revenue for individual currencies? Yes. Gross, net, initial-purchase, renewal, refund, and reinstated revenue are reported separately for each currency.
• Can I compare different user upgrades? Purchase, retention, and active-upgrade statistics can be compared across individual upgrades.
• Can statistics be filtered by payment profile? Yes. Revenue and purchase reports can be filtered by XenForo payment profile.
• ↩ Are refunds and reinstated payments tracked? Yes. Refunds, reversals, and reinstated payments are reflected separately in financial reporting.
• Does the add-on provide subscription retention statistics? Yes. Transaction-based renewal retention is available through monthly cohorts and per-upgrade retention rates.
• Can I see upcoming user upgrade expirations? Lifecycle statistics include active upgrades, new activations, expirations, upcoming expirations, and active distribution by upgrade.
• 🛠 Can statistics be rebuilt from existing payment data? The rebuild tool imports retained successful payment logs and regenerates purchase and financial aggregates. Payments no longer present in XenForo's payment provider log cannot be recovered.

---

Screenshots:​

Revenue & Purchase Analytics​

Upgrade Lifecycle Analytics​