Home IOS Development Superwall: Distant Paywall Configuration on iOS

Superwall: Distant Paywall Configuration on iOS

Superwall: Distant Paywall Configuration on iOS


Subscriptions are an effective way to monetize your app. By exhibiting a paywall, you may convert your free customers into paying subscribers who assist fund that Ferrari you’ve had your eye on. As such, making a high-converting paywall is extraordinarily vital. However carrying out that’s annoyingly tough. It sometimes requires numerous hours of iterating on design, messaging, placement, pricing and options to get it excellent. Even then, the job is rarely completed and even the highest-grossing apps nonetheless check completely different paywalls to maximise income.

Luckily, Superwall has come to the rescue. It’s created an SDK to allow you to remotely configure each facet of your paywall and shortly discover the most effective model.

On this tutorial, you’ll construct an app that generates motivational fitness center quotes behind a paywall that’s remotely configured on Superwall. Alongside the way in which, you’ll study:

  • Find out how to combine and use Superwall to remotely configure your paywall.
  • What Occasions, Campaigns and Guidelines are.
  • Find out how to create an A/B check.
  • Find out how to measure paywall efficiency.

Getting Began

Obtain the starter mission by clicking the Obtain Supplies button on the prime or backside of the tutorial.

As soon as downloaded, open GymMotivation.xcodeproj from the starter folder and go searching. You’ll discover the mission offers the interface for a welcome display and a motivational quote generator.

Construct and run. You’ll see a welcome web page with a button on the backside of the display:

Gym Motivation Welcome Screen with Swift bird trying to lift a dumbbell

Faucet the Get Impressed button to navigate to the motivational fitness center quote generator:

Motivation Gym Quote Generator

Refresh the quote by tapping the refresh arrow within the prime proper.

With motivational quotes like these, somebody utilizing your app would possibly simply turn out to be the subsequent Arnold Schwarzenegger. Why give this content material away when individuals could possibly be paying good cash for it?

In Xcode, you’ll see a StoreKit testing configuration referred to as Merchandise.storekit containing three auto-renewable subscriptions that every have per week’s free trial. StoreKitService.swift offers some code to assist implement in-app subscriptions.

Your job is so as to add a remotely configured paywall that makes use of these merchandise to offer entry to those quotes.

Exploring the Dashboard

With out additional ado, join a free account on Superwall’s web site.

After signing up and getting into your app particulars, you’ll see the dashboard:

The Superwall dashboard.

This has many makes use of, together with:

  • Creating new paywalls.
  • Analyzing, enhancing and controlling current paywalls.
  • Viewing paywall metrics.
  • Defining situations for when to point out paywalls to customers.
  • Viewing customers and their person journey by way of your app and paywall.
  • Localizing your paywalls.

Within the Paywalls part, you’ll see there’s an instance paywall already created for you:

An example paywall in the Superwall dashboard.

This can be a helpful place to begin. Click on the Instance Paywall and also you’ll see an interface with preconfigured information:

The paywall editor

The left-hand facet splits into two tabs: normal and structure.

Normal Tab

On this tab you configure the next:

You possibly can specify as much as three merchandise to your paywall. In your app, the SDK will pull actual, localized product information from the App Retailer based mostly in your product ids. Nevertheless, within the editor, Superwall will use instance product information that you just present as a preview. In case your app is on the App Retailer, Superwall will extract its bundle identifier and pre-fill product values once you create a product on Superwall. In the event you’re utilizing RevenueCat to deal with your in-app subscriptions, you may set your RevenueCat API key right here or in settings. It’ll robotically load your product identifiers from any product connected to an providing. Alternatively, you may manually fill in product information.


These settings decide how the paywall shows and the way it behaves.

Fonts, Sizing, Spacing, Colours and Superior

Right here you alter international design settings of the paywall.

Format Tab

Click on the Format tab within the prime left. You’ll see a primary overview of the construction of the paywall:

The Layout tab of the Paywall Editor.

You utilize this tab if you wish to change the structure of your paywall design by including/eradicating parts. That is an extremely highly effective characteristic that permits you to assemble any paywall design you need.

Have a mess around by clicking and dragging some parts and see the way it modifications the structure of the paywall preview within the middle of the web page. Any modifications you make save domestically however will not be revealed till you hit the Save button. Whenever you’re able to proceed, click on Unpublished, and click on Revert to return to the unique paywall design.

Paywall Preview Part

Within the middle of the web page you’ll see the interactive paywall preview with selectors on the prime to vary the localization and the machine sort:

The paywall preview section

Mouse-over the title factor on the paywall and also you’ll see a blue border seem round it:

A highlighted element on a paywall.

All parts on the paywall are configurable. Click on the title factor and also you’ll see a configuration interface seem within the right-hand sidebar.

Paywall element configuration sidebar.

Ingredient Configuration Part

By switching between the Default and the Free Trial tab on the prime, you may swap between the configuration of the factor when there’s a free trial out there vs when there isn’t. The SDK chooses the factor’s free trial state when it detects a free trial in any of the merchandise on the paywall and the person hasn’t already used a free trial inside that product’s subscription group.

The free trial configuration inherits from the default configuration.

With textual content parts like this, you may insert variables. These reference product information, person properties and machine properties that the SDK subtitutes. Click on + Add Variable to see a listing of every little thing you may add:

Variables that you can add to your text elements.

AI Powered Options

This part provides you clever different options to your textual content factor powered by OpenAI’s GPT-3. In the event you’re working out of concepts along with your paywall copy, then that is your good friend!

Click on Conduct

You possibly can select what occurs when somebody clicks on a component. This consists of: opening URLs, deep hyperlinks, closing the paywall, restoring, buying, or customized actions.

The remainder of the sidebar focuses on customizing the design of the factor.

You’ve now received a really feel for how one can configure a paywall on the dashboard.

Understanding Campaigns

How do you establish when to point out configured paywalls to customers? And to which group of customers? That’s the place Campaigns are available.

A marketing campaign permits you to outline situations for when to point out paywalls to customers. They tie collectively three ideas:

  1. Occasions: Analytical occasions you register in your app.
  2. Guidelines: Logic that determines when to point out a paywall.
  3. Paywalls.

You possibly can consider a marketing campaign as follows: When registering these occasions, consider these guidelines and present these paywalls.

Head again to the dashboard and scroll all the way down to the part named Campaigns and click on Instance Marketing campaign:

The Campaigns section


On the prime of the web page is the place you add your occasions. On this marketing campaign, there’s already one there referred to as campaign_trigger:

Events for the Example Campaign

In a while, your app will register this occasion through the SDK. You possibly can title an occasion nearly something you want.

Superwall robotically tracks occasions and a few of these can current paywalls. Particularly:

  • app_install: On configuration of the SDK for the primary time.
  • app_launch: On app launch from a chilly begin.
  • session_start: On app open both from a chilly begin or after at the very least 30 seconds for the reason that app left the foreground.
  • deepLink_open: When opening a deep hyperlink within the app.
  • transaction_fail: When a transaction fails.
  • transaction_abandon: When a person abandons a transaction.
  • paywall_decline: When a person declines a paywall.


Additional down the web page you’ll see a rule set to true:

A campaign rule

As that is true, all customers will match the rule. Click on the rule to convey up the Rule Editor:

The Rule Editor

Utilizing this, you may create extra complicated guidelines by filtering by person, machine and occasion parameters supplied through the SDK. You can too add a restrict to how usually they need to match.

Guidelines get evaluated so as and as soon as a person matches a rule, no different guidelines get evaluated. If a person doesn’t match a rule, they aren’t proven a paywall.

Listed here are some instance guidelines you would use:

  • if person.days_logged >= 3 then, present 6 instances each 2 weeks.
  • person.style == "jazz" or person.style == "classical"
  • params.end result accommodates "substring"


Beneath every rule is a bunch of paywalls. You’ll see one paywall assigned to 100% of customers. In actual fact, that’s the instance paywall that you just noticed earlier:

A group of paywalls that belong to a rule.

Beneath every paywall title is the quantity of customers at present assigned to that paywall. Paywalls assignments are sticky, which suggests customers will all the time see the identical paywall assigned to them for a given rule. An arrow seems subsequent to it which you’ll be able to click on in the event you’d wish to reset the task for these customers:

Amount of people assigned to a paywall

In the event you wished to, you would add a number of paywalls to this rule and assign every paywall to a sure proportion of customers. If as a substitute of 100% of customers, you assigned solely 50% of customers to the paywall, the remaining 50% wouldn’t see a paywall, which means they’re in a holdout group. All these options make it potential to run A/B assessments to find out the best paywall, which you’ll do afterward.

This above is a quite simple arrange, nonetheless, superior setups are potential. Take a look at the Superwall docs for more information.

You’ve now received a really feel for the way the dashboard works. The following step is to combine the SDK into your app and set off your first paywall!

Integrating the Superwall SDK

Including the Superwall iOS SDK

To point out the paywall in your app, you first want so as to add the Superwall iOS SDK referred to as SuperwallKit to your mission as a Swift Package deal.

In Xcode, choose File ▸ Add Packages…, then paste the SuperwallKit package deal URL into the search bar.


Set the Dependency Rule to Up To Subsequent Main Model and specify 3.0.0 because the decrease certain. Then, click on Add Package deal:

Adding the Superwall Swift package

Initializing the SDK

Subsequent, you have to initialize the SDK when the app launches. Open AppMain.swift and add the next to the highest of the file:

import SuperwallKit

Then, add the next to configure Superwall on init():

init() {
  Superwall.configure(apiKey: "YOUR_API_KEY")

Open the Superwall dashboard, click on the Settings tab within the sidebar, choose Keys and duplicate the Public API Key:

Again in AppMain.swift, substitute YOUR_API_KEY along with your Public API key.

Construct and run your app. You gained’t discover any visible modifications. However in the event you head to the Superwall dashboard, you’ll discover the primary two gadgets checked off within the quickstart guidelines. You’ve efficiently configured the Superwall SDK:

Completion of two items on the onboarding checklist

Presenting the Paywall

The best place to point out the paywall in your app is when the person presses the Get Impressed button. When that occurs, you’ll have to register the occasion campaign_trigger.

On the coronary heart of Superwall is register(occasion:params:handler:characteristic). This lets you register an occasion to entry a characteristic which will or might not be behind a paywall later in time. It additionally permits you to select whether or not the person can entry the characteristic even when they don’t make a purchase order.

It takes the next parameters:

  • occasion: The title of the occasion you want to register.
  • params: Non-compulsory parameters that you may check with in your paywall and the principles you outline in your marketing campaign.
  • handler: An non-compulsory handler whose features present standing updates for a paywall.
  • characteristic: An non-compulsory completion block containing a characteristic that you just want to put behind a paywall.

The calling of the characteristic block is determined by whether or not the paywall is gated or non-gated:

  • Gated: Solely calls the characteristic block if the person is already paying or if they start paying.
  • Non-Gated: Calls the characteristic block when the paywall dismisses no matter whether or not they paid or not.Gating is remotely configurable within the paywall editor.

    It’s really useful to register all core performance in your app with the intention to remotely configure which options you wish to gate with out an app replace.

    Including Register to Your App

    Open WelcomeView.swift. In continueButton(), substitute:

    path.append(Vacation spot.motivationView)


    Superwall.shared.register(occasion: "campaign_trigger") {
      path.append(Vacation spot.motivationView)

    That’s all you want!

    Construct and run your app. Faucet the Get Impressed button and see your paywall introduced!

    A presented paywall.

    Head to the dashboard and also you’ll see the subsequent few steps checked off within the onboarding checklist:
    Three elements in onboarding list checked off.

    You now have working logic in your app to point out a paywall. Sadly, it nonetheless very a lot appears to be like like a template and the Buy Major button to buy merchandise doesn’t work!

    Shut the paywall by tapping the proper button within the prime proper of the paywall. You’ll discover it navigates straight to your valuable quotes after the paywall closes. That’s as a result of the paywall is non-gated and subsequently prompts the characteristic block despite the fact that you haven’t paid. On your app, you have to make this gated. Ain’t no one getting free quotes!

    Customizing Your Paywall

Making Your Paywall Gated

Open the Paywall Editor for the Instance Paywall on the Superwall dashboard.

Within the Normal tab, scroll all the way down to Settings and alter Characteristic Gating to Gated:

Changing the feature gating

Click on the Save button within the prime proper.

Now construct and run your app. Faucet the Get Impressed button to launch your paywall after which shut it once more by tapping on the proper button within the prime proper. When the paywall closes, it gained’t navigate to your quotes!

Including Merchandise to Your Paywall

Again within the Paywall Editor, create your first product by clicking the + Create Product button within the Merchandise part:

The create product button

Within the popup, set the Product Identifier to gm_2099_1y, Trial to 1 week, Worth to 20.99 and Interval to 12 months:

Adding a product.

Save the paywall, then construct and run your app.

Current the paywall and faucet the Buy Major button. You’ll see it presents the acquisition sheet so that you can buy the product:

Purchasing a product.

Faucet Subscribe and buy the product. After buying the paywall will dismiss and also you’ll navigate by way of to the MotivationView. Delete the app to reset your subscription standing for the needs of this tutorial.

That is now a completely functioning paywall! Open the Superwall dashboard to verify all onboarding steps checked off:

All onboarding items checked off

All that’s left is to change the paywall’s design to be higher suited to your app.

Adjusting Paywall Design

Open the Paywall Editor and click on the Format tab.

For simplicity’s sake, we’ll solely hold a couple of sections and delete the others that we don’t need. In a production-ready paywall, you’ll wish to experiment with the size of your paywall. Often, longer paywalls carry out higher. It’s because buying is an emotional determination so that you’ll wish to give your customers sufficient data to steer them that your product is deserving of a small portion of their kids’s inheritance.

Click on the trash can icon subsequent to the Part factor beneath the Subheading factor within the Principal Content material checklist:

Deleting a section

Click on Delete within the popup that seems. Repeat these steps and delete the subsequent two Sections beneath Subheading. Lastly, scroll down and delete the final Part within the Principal Content material checklist. You need to find yourself with 4 sections and a navbar:

The first part of the updated paywall.

The second part of the updated paywall.

Within the navbar, click on the left button, and set its Show to None:

Hiding the left button.

Repeat this for the Title navbar factor. Set the textual content of the proper button to Exit.

Choose the picture factor and click on the Add button. Select the picture named paywall-image.png out of your tutorial supplies. Then change High Padding to 40px:

Uploading an image

Substitute the major heading textual content with:

Unlock Professional

Substitute its subtitle textual content with:

with a {{ main.trialPeriodText }} free trial

This references the trial interval of your main product inside the textual content.

Set the bullet factors’ heading’s Show to None. Then for every bullet level title, conceal it’s subtext in the identical approach.

Substitute every bullet level textual content such that your checklist appears to be like like this:

  • Limitless quotes
  • Limitless motivation
  • Most quantity of beneficial properties
  • Cancel anytime in seconds

Then substitute the title above the overview part with:

Extremely rated

For the acquisition button, substitute the textual content with Proceed in its default state and Attempt now in its free trial state.

Substitute the main chosen description with:

Solely {{ main.worth }} per {{ main.interval }}

Click on the Save button, then construct and run your app to see your new paywall in motion! It ought to appear to be this:

A screenshot of an edited paywall

A screenshot of an edited paywall

Testing Paywall Variants

Say you’ve launched your app on the App Retailer however have a sense the title isn’t actually promoting the product. You’d like to check a paywall with completely different copy and see if it makes extra gross sales. With Superwall, you may run a number of paywalls on the similar time.

Open the Superwall dashboard. Beneath Paywalls, hover over your paywall’s title and click on copy:

The paywall copy button

Click on Duplicate to redirect to the paywall editor for the duplicate paywall.

Click on the title within the paywall Unlock Professional and substitute it with:

Unlock your full potential. Go Professional.

Then, click on the title of the paywall to vary it from Instance Paywall (copy) to:

Instance Paywall | Title Change

Click on Save and head again to the dashboard. Beneath Campaigns, click on Instance Marketing campaign and add a brand new paywall variant to your rule by clicking + Add Paywall:

Adding a new paywall variant

Choose your paywall Instance Paywall | Title Change from the drop down and click on Create:

Choosing a paywall variant.

Then, above your newly added paywall, click on 0% of customers, set each paywall values to 50 and click on the test mark to verify your new visitors distribution:

Adjusting paywall traffic

You now have an A/B check working two paywalls on the similar time, with a 50/50 visitors cut up between them. Your unique paywall is the management and the brand new one is a variation or variant.

Analyzing Paywall Efficiency

How have you learnt which is the successful paywall in an A/B check? What do you have to do after you’ve got a transparent winner? What efficiency indicators do you have to measure? All crucial questions!

After information begins coming in to your paywalls, you may view metrics beneath every marketing campaign rule like this:

A table of data below a rule.

These default to information retrieved within the final 24 hours however you may change this to any time vary within the prime proper nook of the marketing campaign web page:

Dropdown to change the date for campaign metrics.

You should use this information to research your paywalls’ efficiency.

An organization referred to as CXL have created a calculator that may assist you take your outcomes from Superwall and work out whether or not they’re statistically vital. Open their calculator:

AB+ Test Calculator by CXL

For instance, let’s say you’ve been working a check with the above paywalls for 30 days. Within the marketing campaign, you’ve seen that there have been 300 opens for every paywall because you arrange the check. It seems you’ve had 20 conversions, or purchases, from the management and 40 conversions from the variation. All you have to do is enter this information into the AB+ Check Calculator.

Within the Check length enter subject, enter 30.

On the AB+ check calculator web site, enter 300 within the Customers or classes fields for each the management and variation. Then enter 20 and 40 within the Conversions fields for the management and the variation respectively.

The AB+ Test Calculator filled out with example data.

In the event you had extra paywall variations you would add one other by clicking Add Variant. Go away Step 3 of the calculator as it’s. That is the place you’d regulate the arrogance stage of your experiment in the event you wished to:

Step 3 in the AB+ Test Calculator.

Lastly, the outcomes will probably be robotically calculated for you utilizing Bayesian statistics. This solutions the query “How probably is it that the variation(s) will probably be higher than the management?”, or vice versa. It outputs two graphs. The primary provides the chance of every paywall variation being the winner and the second signifies the chance of a paywall’s conversion fee:

Graphs showing the probability of each paywall variation being the winner and the likelihood of a paywall's conversion rate.

As you may see, the variation has a 100% likelihood of being the winner in comparison with the management.

Open the marketing campaign on the Superwall dashboard and take away the dropping paywall by clicking the x within the nook:

Removing a paywall variant from a campaign.

Affirm the removing of the paywall:

Confirming the removal of a paywall variant

This can make it reset the paywall task for customers assigned to that paywall. Then, set 100% of visitors to the brand new paywall:

Setting 100% of traffic to a paywall.

Given the instance information above, you may see that you just’ve doubled your revenue simply from working an experiment. But it surely’s not over! After this, you’d wish to strive a brand new experiment reminiscent of altering the positioning, design, or pricing of the paywall.

The place to Go From Right here?

You possibly can obtain the entire mission by clicking the Obtain Supplies button on the prime or backside of this tutorial.

This mission scraped the floor of what you are able to do with Superwall. There’s nonetheless loads to study, together with:

  • Figuring out customers.
  • Assigning person properties.
  • In-app paywall previews.
  • Localizing paywalls.
  • Sport controller assist.
  • Third-party analytics.
  • Customized paywall buttons.
  • Customized paywall presentation
  • Utilizing deeplinks to point out paywalls

If you wish to study extra about Superwall’s capabilities, take a look at its documentation.

To study extra about configuring in-app subscriptions, take a look at In-App Buy Tutorial: Auto Renewable Subscriptions.

I hope you loved this tutorial. In case you have any questions or feedback, be part of the dialogue under.



Please enter your comment!
Please enter your name here