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 Name

Action

Can Trigger Paywalls

app_install

When the SDK is configured for the first time, or directly after calling Paywall.reset()

yes

app_launch

When the app is launched from a cold start

yes

session_start

When the app is opened either from a cold start, or after at least 30 seconds since last app_close.

yes (recommended)

app_close

Anytime the app leaves the foreground

no

app_open

Anytime the app enters the foreground

no

paywall_open

When a paywall is opened

no

paywall_close

When a paywall is closed (either by user interaction or do to a transaction succeeding)

no

transaction_start

When the payment sheet is displayed to the user

no

transaction_fail

When the payment sheet fails to complete a transaction (ignores user canceling the transaction)

no

transaction_abandon

When the user cancels a transaction

no

transaction_complete

When the user completes checkout in the payment sheet and any product was "purchased"

no

subscription_start

When the user successfully completes a transaction for a subscription product with no introductory offers

no

freeTrial_start

When the user successfully completes a transaction for a subscription product with an introductory offer

no

transaction_restore

When the user successfully restores their purchases

no

nonRecurringProduct_purchase

When the user purchased a non recurring product

no

paywallResponseLoad_start

When a paywall's request to Superwall's servers has started

no

paywallResponseLoad_fail

When a paywall's request to Superwall's servers has failed

no

paywallResponseLoad_complete

When a paywall's request to Superwall's servers is complete

no

paywallWebviewLoad_start

When a paywall's URL begins to load

no

paywallWebviewLoad_fail

When a paywall's URL fails to load

no

paywallWebviewLoad_complete

When a paywall's URL completes loading

no


Did this page help you?