Automatically Tracked Events

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

We encourage you to track them in your own analytics as described in 3rd Party Analytics, and use them to trigger paywalls, if supported, as described in Triggering a Paywall.

Event NameActionCan Trigger Paywalls
app_installWhen the SDK is configured for the first time, or directly after calling Paywall.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)
app_closeAnytime the app leaves the foregroundno
app_openAnytime the app enters the foregroundno
paywall_openWhen a paywall is openedno
paywall_closeWhen a paywall is closed (either by user interaction or do to a transaction succeeding)no
transaction_startWhen the payment sheet is displayed to the userno
transaction_failWhen the payment sheet fails to complete a transaction (ignores user canceling the transaction)no
transaction_abandonWhen the user cancels a transactionno
transaction_completeWhen the user completes checkout in the payment sheet and any product was "purchased"no
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
transaction_restoreWhen the user successfully restores their purchasesno
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
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

What’s Next