View Campaigns by clicking them over on the left-hand sidebar:

Campaigns consist of three main concepts:

  1. Placements
  2. Audiences
  3. Paywalls

Campaigns are the centerpiece of Superwall. You can use one, or several, campaigns that can run concurrently. To understand campaigns, think of them like this:

  • In a campaign, you add placements — which are actions you want to result in a paywall, or might someday want to result in a paywall(i.e. loggedCaffeine, addedEntry, etc).
  • Then, as users take actions in your app, those placements are registered in the Superwall SDK.
  • When a placement is registered, it’s then evaluated by Superwall. Superwall looks at your campaign filters, and may or may not show a matching paywall.

With this setup, you can be incredibly simple or make in-depth, complex filters which determine when (and what) paywall is shown. You can set the percentage of new users that see each paywall, or even configure no paywall (a.k.a. a holdout) to be shown for certain placements.

Toggling campaigns by status

You can toggle between campaigns by their status using the tabs at the top (above the campaigns):

  • All: The default view. This shows all of your campaigns, regardless of their status.
  • Active: Campaigns being used in production and serving up paywalls.
  • Inactive: Campaigns that are not serving paywalls in production, but can be quickly re-enabled.
  • Archived: Campaigns that have been archived, and not attached to any campaign. These can be restored.

Viewing campaign top-level metrics

Each campaign will also display its active placements and top-level metrics (if any are available). In this example, the campaign at the top has data, while the one below it doesn’t:

Metrics shown include:

  • Opens: The amount of time any of the campaign’s placements resulted in a paywall being presented.
  • Conversions: The number of conversions produced from any paywall attached to the campaign.
  • Conversion Rate: The conversion rate of the current campaign.

If the campaign isn’t currently serving any paywalls because none have been attached to it, you’ll see a wanting indicating that in this view. In the image above, that’s the case for the campaign at the bottom, called “Survey”.

Toggling campaigns by date

To toggle the date range that the metrics previously mentioned should display within, use the date toggle at the top-right side:

Viewing campaign details

To view more about any campaign, to setup filters, edit placements, paywalls and more — simply click on any campaign listed in the table. Then, campaigns details will be presented. More on that in the next page.

Viewing transactions

To view recent transactions from your app, use the “Recent Transactions” view:

The transaction view displays:

  • User: The user ID the event belongs to, along with an emoji flag representing their territory. Click on this value to quickly copy it to your clipboard.
  • Placement: The placement that the event associates to. You can click this to open the campaign that the placement belongs to.
  • Paywall: The paywall that the event took place on. Click this value to quickly open a modal preview of the paywall.
  • Product: The product the event represents. Hover over this value to get a tooltip that will display the product’s identifier.
  • Revenue: Any revenue generated from the event.
  • Purchased: The time the event occurred.
  • Type: The event type. The list of events can be found below.

Transaction event types

Each of the following transaction types can show up in the transaction view:

Event NameDescription
Main Events (Default)A collection of key subscription events for tracking purposes.
All EventsIncludes every possible subscription-related event for complete tracking.
Paywall ConversionTriggered when a user successfully converts or starts a trial via a paywall.
Trial StartIndicates the beginning of a free trial period.
Direct Sub StartA subscription starts without a trial period.
One Time PurchaseA non-subscription, single-payment transaction is completed.
Intro OfferA user subscribes using an introductory offer.
Trial ConvertA trial that successfully converted into a paid subscription.
RenewalAn existing subscription renews for another billing period.
RefundA user is refunded for a previous purchase.
Trial CancelA user cancels their trial before it converts to a paid subscription.
Trial ExpireA free trial ends without converting to a paid subscription.
CancelA user cancels their active subscription.
UncancelA previously canceled subscription is reactivated before expiration.
ExpireA subscription fully expires and is no longer active.

You can filter the transaction view by any of these using the toggle at the top right:

If you see the paywall or placement values blank — don’t worry. This means the user started a subscription, reactivated or whatever the event may be out outside of your app. Typically, this occurs when they visit their Apple ID’s settings and change subscription or products there manually. Further, processing simply represents just that — Superwall received an event, but some of the details are still being fetched. Typically, this shouldn’t make more than a few minutes.