App events

App Events gives you a complete view of everything happening in your app - from installations and billing changes to custom events you’re tracking. Think of it as your app’s timeline, where every customer action, subscription change, and tracked event comes together in one searchable feed. Whether you’re verifying billing changes or investigating a customer’s journey, you’ll find the answers here.

What makes this view different

While most reports help you spot trends or analyze patterns, App Events shines when you need to confirm exactly what happened and when. This detailed event log becomes your go-to tool for troubleshooting, verification, and tracking specific customer’s journeys through your app.

View components

Events feed

The main view shows you a chronological feed of everything happening in your app. Each event comes with essential context:

The type of event tells you whether it’s a platform action like an install or a financial event like a subscription change
Timing details help you piece together exactly when things happened, from relative timing for recent events to precise timestamps for historical investigation
Customer information connects events to specific merchants, making troubleshooting and verification straightforward
Event details provide the context you need, whether that’s plan changes, billing amounts, or custom event data

The feed captures two main types of events:

Activity events:

Installations and uninstalls are your fundamental platform touchpoints. Each install represents a new opportunity, while uninstalls might signal product fit issues or reveal patterns in customer departures
Customer identifications marks the moment Mantle is given access to enrich data, opening up deeper analytics and custom feature access across your integration
Review submissions show you exactly when customers feel strongly enough about your app to share feedback, helping you connect satisfaction to specific parts of their journey
Custom events are your window into how merchants actually use your app. Track everything from first-time feature usage to power-user milestones to understand what drives long-term success

Subscription events:

New subscriptions and trial starts represent key revenue moments, showing you exactly when merchants commit to your value proposition
Plan changes tell stories about customer growth, whether they’re upgrading to access more features or adjusting their subscription to match their needs
Cancellations and churns provide crucial context about customer departures, helping you connect exits to specific events or patterns
Payment-related events give you visibility into your billing health, from successful charges to payment method changes

Powerful filtering

The comprehensive filtering system helps you focus on exactly what you’re investigating. Each filter type serves specific investigation needs:

Activity filters:

Installation tracking doesn’t just show new customers - it helps verify your integration is working and onboarding flows are running smoothly
Platform events reveal the health of your Shopify connection, from account status changes to reactivations
Review monitoring connects customer feedback to specific points in their journey, helping you understand what drives satisfaction
Custom event filters let you trace feature adoption and usage patterns that matter most to your business

Subscription filters:

Billing events provide the full story of your financial relationships, from first charge to ongoing subscription health
Plan changes highlight customer growth patterns and help you verify pricing adjustments
Payment status tracking helps you stay ahead of potential billing issues and understand collection patterns
Trial management shows you the complete trial lifecycle, from start to conversion or departure

You can also narrow things down by filtering by date or plan.

Making the most of events

Pro tips

The difference between basic event tracking and powerful investigation often comes down to technique. Here’s how to level up your App Events game:

Investigation strategies:

Start with broad filters before narrowing down - you’d be surprised how often the context around an event matters more than the event itself. That customer who churned? The events leading up to their departure might reveal opportunities to improve retention
Export filtered data regularly when monitoring specific patterns - sometimes the export function isn’t just about analysis, it’s about having a record of what happened when. This becomes invaluable during platform hiccups or when verifying complex customer scenarios
Master the customer search for support scenarios - nothing builds customer confidence like having immediate access to their complete event history during a support conversation
Remember timing display shifts from relative to absolute - recent events show as “4 hours ago” for quick context, but dig into history and you’ll get precise timestamps. This matters when you’re investigating patterns or verifying exact sequences of events

Whether you’re doing routine verification or deep investigation, App Events helps you understand exactly what’s happening in your app. Need help tracking down specific events or building better monitoring processes? Our team is here to help!