Campaigns
Campaigns are logical groupings of paywalls to show when certain events are registered and conditions are met. They are an incredibly powerful tool for creating experiments and managing best-in-class monetization flows.
View Campaigns by clicking them over on the left-hand sidebar:
Campaigns consist of three main concepts:
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 Name | Description |
---|---|
Main Events (Default) | A collection of key subscription events for tracking purposes. |
All Events | Includes every possible subscription-related event for complete tracking. |
Paywall Conversion | Triggered when a user successfully converts or starts a trial via a paywall. |
Trial Start | Indicates the beginning of a free trial period. |
Direct Sub Start | A subscription starts without a trial period. |
One Time Purchase | A non-subscription, single-payment transaction is completed. |
Intro Offer | A user subscribes using an introductory offer. |
Trial Convert | A trial that successfully converted into a paid subscription. |
Renewal | An existing subscription renews for another billing period. |
Refund | A user is refunded for a previous purchase. |
Trial Cancel | A user cancels their trial before it converts to a paid subscription. |
Trial Expire | A free trial ends without converting to a paid subscription. |
Cancel | A user cancels their active subscription. |
Uncancel | A previously canceled subscription is reactivated before expiration. |
Expire | A 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.