About this chart

The Subscription Events chart is a raw event explorer that plots the volume of server-side subscription lifecycle events over time. Each event type appears as a separate colored line on a time-series chart, letting you compare event volumes side by side. It is designed for deep operational analysis rather than high-level KPI tracking — use it when you need to understand exactly what is happening in your subscription lifecycle at the event level.

Event names correspond to Purchasely server events (the same events delivered via webhooks), making it easy to cross-reference chart data with your backend logs or third-party integrations.

⚠️ Change from dashboard v1: counting subscriptions, not subscribers

The previous version of this dashboard counted unique subscribers (users). Dashboard v2 now counts unique subscriptions, each identified by a unique subscription ID.

This changes the numbers in two ways:

• Restored subscriptions across devices: In v1, when a subscription was restored on a new device by a different anonymous user, it was counted multiple times — once for each anonymous user associated with it. In v2, the subscription is counted only once regardless of how many devices or anonymous users it passes through.
• Multiple subscriptions per user: In v1, a user holding two active subscriptions simultaneously was counted once (one user). In v2, each subscription is counted individually, so the same user contributes two to the total.

Example: Alice holds both a monthly Music plan and a yearly Premium plan. In v1, Alice counted as 1 subscriber. In v2, she counts as 2 active subscriptions. Conversely, if a single subscription was restored across 3 anonymous devices in v1, it appeared as 3 subscribers — in v2 it correctly counts as 1 subscription.

How to read the chart

The chart is a multi-line time-series graph. Each line represents one event type, plotted over the selected date range and granularity.

• The Y-axis shows event count.
• The X-axis shows time (days, weeks, or months depending on granularity).
• A legend at the bottom lists every plotted event type with its corresponding color.

When many event types are selected, the chart can become dense. Use the category chips and search bar at the top to focus on the events that matter for your analysis.

Event categories

Events are organized into color-coded categories. Click a category chip to select or deselect all events in that group at once. You can also use the search bar to find a specific event by name.

Note: Pause-related events (SubscriptionPaused, SubscriptionUnpaused, SubscriptionWithPause, SubscriptionWillNotPause) are Google Play only. They will not appear for App Store subscriptions. | Entitlement / Transfer | Purple | SubscriptionTransferred | | Trial / Intro / Promo offer | Pink/Orange | TrialStarted, TrialConverted, TrialNotConverted, IntroOfferStarted, IntroOfferConverted, IntroOfferNotConverted, PromoCodeStarted, PromoCodeConverted, PromoCodeNotConverted, PromotionalOfferStarted, PromotionalOfferConverted, PromotionalOfferNotConverted | | Transaction Revenue | Blue | TransactionProcessed |

Select ALL (gray chip) to plot every event type simultaneously.

Controls

Category chips and search

At the top of the chart, color-coded category chips let you quickly toggle groups of related events. Click a chip to select all events in that category; click it again to deselect. The search bar filters the event list by name, which is useful when you know exactly which event you are looking for.

Granularity

Use the Daily / Weekly / Monthly selector to control the time resolution.

• Daily — One data point per day. Best for spotting short-lived spikes or anomalies.
• Weekly — One data point per week. Smooths out daily noise while preserving trends.
• Monthly — One data point per month. Best for long-term pattern analysis.

Filters

Click Filters to narrow the data. You can combine multiple filters.

Download CSV

Click the Download CSV button to export the currently displayed data. The export respects your active filters, selected events, and granularity.

Common use cases

• Spot billing issue spikes — Select the Billing Issue category and watch for sudden increases in EnteredBillingRetry or GracePeriodStarted. A spike may indicate a store-side payment processing issue or a wave of expired credit cards.

• Monitor trial-to-paid conversion health — Plot TrialStarted alongside TrialConverted and TrialNotConverted. If TrialNotConverted starts growing faster than TrialConverted, your trial experience may need attention.

• Validate a new paywall deployment — After launching a new paywall or A/B test, filter by Screen or A/B test and check that SubscriptionStarted and Activate volumes are in line with expectations.

• Track refund trends — Select SubscriptionRefundBeforeExpiry and monitor it over time. A rising trend could signal product satisfaction issues or policy abuse.

• Diagnose churn by comparing cancellation events — Plot SubscriptionTerminated, SubscriptionCancelledDuringGracePeriod, and SubscriptionCancelledDuringPause together to understand where in the lifecycle users are dropping off.

• Measure promo offer effectiveness — Compare PromotionalOfferStarted with PromotionalOfferConverted and PromotionalOfferNotConverted to evaluate whether your promotional offers are driving sustained subscriptions or just temporary uptake.

Frequently asked questions

What is the difference between this chart and the other dashboard charts?

Most dashboard charts (MRR, Active Subscriptions, Retention) show aggregated KPIs. The Subscription Events chart shows raw event volumes — it is the most granular view available. Use it when you need to drill into the mechanics of your subscription lifecycle rather than track a summary metric.

Do these events match the webhook events I receive?

Yes. The event names on this chart correspond directly to Purchasely server events (webhook events). If you see a SubscriptionRenewed event in the chart, it maps to the same SUBSCRIPTION_RENEWED event your backend receives via webhooks. This makes it straightforward to cross-reference dashboard data with your server logs.

Why do I see both "Activate" and "SubscriptionStarted"?

These are distinct events in the Purchasely lifecycle. Activate is an entitlement event — it signals that the user should gain access to premium content. SubscriptionStarted is a lifecycle event that records the beginning of a new subscription. They typically fire together for new subscriptions, but Activate can also fire on its own during recoveries or transfers. Similarly, Deactivate and SubscriptionTerminated are related but not identical.

Can I see revenue data in this chart?

The TransactionProcessed event is available under the Transaction Revenue category. While it tracks the occurrence of revenue-generating transactions, the chart plots event counts, not monetary amounts. For actual revenue figures, use the dedicated MRR or Revenue dashboards.

How should I use the category chips vs. the search bar?

Use category chips when you want to explore a functional area (e.g., all billing-related events). Use the search bar when you already know the specific event name you are looking for (e.g., "TrialConverted"). You can combine both — select a category, then use search to add individual events from other categories.

Why does a line disappear or appear flat?

If an event type has zero occurrences over the selected date range, its line will sit at zero or may not be visible behind other lines. Try narrowing the date range, switching to daily granularity, or deselecting high-volume events to make lower-volume lines easier to read.