Superwall Events

The following events are automatically tracked by the SDK, and power the charts in the dashboard.

We encourage you to track them in your own analytics as described in 3rd Party Analytics, and use them to present paywalls, if supported, as described in Tracking Events.

Event NameActionCan Trigger Paywalls
app_installWhen the SDK is configured for the first time, or directly after calling Superwall.shared.reset()yes
app_launchWhen the app is launched from a cold startyes
session_startWhen the app is opened either from a cold start, or after at least 30 seconds since last app_close.yes (recommended)
transaction_failWhen the payment sheet fails to complete a transaction (ignores user canceling the transaction)yes
transaction_abandonWhen the user cancels a transactionyes
paywall_closeWhen a paywall is closed (either by user interaction or do to a transaction succeeding)yes
first_seenWhen the user is first seen in the app, regardless of whether the user is logged in or not.no
app_closeAnytime the app leaves the foregroundno
app_openAnytime the app enters the foregroundno
paywall_openWhen a paywall is openedno
trigger_fireWhen a tracked event triggers a paywall.no
transaction_startWhen the payment sheet is displayed to the userno
transaction_completeWhen the user completes checkout in the payment sheet and any product was "purchased"no
transaction_restoreWhen the user successfully restores their purchasesno
subscription_startWhen the user successfully completes a transaction for a subscription product with no introductory offersno
freeTrial_startWhen the user successfully completes a transaction for a subscription product with an introductory offerno
nonRecurringProduct_purchaseWhen the user purchased a non recurring productno
paywallResponseLoad_startWhen a paywall's request to Superwall's servers has startedno
paywallResponseLoad_failWhen a paywall's request to Superwall's servers has failedno
paywallResponseLoad_completeWhen a paywall's request to Superwall's servers is completeno
paywallResponseLoad_notFoundWhen a paywall's request to Superwall's servers returned a 404 error.no
paywallWebviewLoad_startWhen a paywall's URL begins to loadno
paywallWebviewLoad_failWhen a paywall's URL fails to loadno
paywallWebviewLoad_completeWhen a paywall's URL completes loadingno
paywallWebviewLoad_timeoutWhen the loading of a paywall's website times out.no
paywallProductsLoad_startWhen the request to load the paywall's products started.no
paywallProductsLoad_failWhen the request to load the paywall's products failed.no
paywallProductsLoad_completeWhen the request to load the paywall's products completed.no
paywallPresentationFail_userIsSubscribedWhen the paywall presentation failed because the user is already subscribed.no
paywallPresentationFail_holdoutWhen the paywall presentation failed because the user is in a holdout.no
paywallPresentationFail_noRuleMatchWhen the paywall presentation failed because they didn't match any rules defined in the event's campaign.no
paywallPresentationFail_eventNotFoundWhen the paywall presentation failed because event provided was not found in any campaign on the dashboard.no
paywallPresentationFail_debuggerLaunchedWhen the paywall presentation failed because the debugger is launched.no
paywallPresentationFail_alreadyPresentedWhen the paywall presentation failed because there's already a paywall presented.no
paywallPresentationFail_noPresenterWhen the paywall presentation failed because there isn't a view to present the paywall on.no
paywallPresentationFail_noPaywallViewControllerWhen the paywall presentation failed because there was an error getting the paywall's view controller.no
user_attributesWhen the user attributes are set.no
subscription_status_did_changeWhen the user's subscription status changesno