Standard Placements
Standard placements are events that Superwall automatically manages. The following Superwall Events are registered by the SDK and can be added as placements in campaigns to present paywalls:
app_install
app_launch
deepLink_open
session_start
paywall_decline
transaction_fail
transaction_abandon
survey_response
touches_began
Visit Superwall Events to see a full list of parameters that you can use with these events. Here are a few examples of how they might be used:
Using the paywall_decline
event
This is registered when a user manually dismisses any paywall. You can combine this with rules to show a paywall when a user closes a specific paywall. First, add the standard placement to a campaign:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-placement-adding-implicit-placement.png)
Then, create a filter in the audience using it:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-placements-ex-implicit.png)
Here, when a user closes the paywall named PaywallA
, a new paywall will show.
Note that you can’t reference parameters that you’ve passed in to your original register call in your rules for paywall_decline
.
Using the survey_response
event
This is registered when a response to a paywall survey has been recorded. First, you need to make sure your paywall has a survey attached.
You can combine this with rules to show a paywall whenever a survey response is recorded or when the user gives a specific response. Again, add the standard placement survey_response
to a campaign. Then, add another condition using survey_selected_option_title
that’s equal to the text of a particular response.
For example, if the user selected a survey option named Too Expensive
, you could present another paywall with a discounted option. This is a great opportunity to show a discounted paywall to improve your conversion rate.
Using the deepLink_open
event
This is registered when a user opens the app via a deep link. First, you need to make sure to tell Superwall when a deep link has been opened.
You can use the URL parameters of the deep link within your rules. Just add the standard placement deepLink_open
to a campaign. Then, you could setup a filter that fires based off of its parameters along with a params.path
rule to see if its a certain path you’ve setup.
For example, you could make three conditions to match this deep link: myapp://paywall?offer=July20
. Here’s how:
- Add the a rule to see if the event is
deepLink_open
. See the first example above usingpaywall_decline
to see how to do this. - Add
params.offer
is equal to whatever you’ve made, likeJuly20
for a timeboxed offer you made in that month. - Then, you’d also add
params.path
is equal to the text of a path you setup, likepaywall
.