Placements
Learn how to identify actions or locations in your app that should launch a paywall
If you have lots of paywalls, you will want to do some planning to make it easy to roll out changes without requiring development. Here are some key steps:
1. Identify Placements 🎯
A placement is an action or location in the app that should launch a paywall.
Common Examples Include:
After the user first launches the app
The last step of onboarding
When user attempts to access gated content in a freemium app such as unlocking exclusive content
Clicking a button in the app or settings menu
When user deep-links into the app from a particular URL
Random paywall launch during a sales or promotional event period
Each placement is identified by a label and can have multiple campaigns attached to it. Each of these campaigns in turn can have multiple paywalls.
2. Assign Labels to Placements 💬
After you have identified your current and future placements, assign labels to them. Each placement should have 1 label, that will be attached to all the campaigns.
Labels are short text 'slugs' such as onboarding_step_3, settings, or promo.
The label is used by development to raise a particular campaign placement.
If you change the placement label in the Control Center, make sure it is also updated in your code. Otherwise, your paywall won't launch!
4. Create Campaigns and Rules ▶️
A campaign is a display unit for your paywall. Campaigns have optional labels and rule sets to help show the paywall to the right set of users.
You will want to create at least 1 campaign for each placement.
Each placement can have a number of campaigns. When the code for that placement is run, each campaign in the placement will be tested until a matching set of rules is found.
Campaign Best Practice
Always create a fallback campaign for each placement that has no rules. That way, if a user doesn't match any of the previous campaigns, they will still see a paywall.
5. Assign Paywalls 🌄
Each campaign should have at least 1 paywall.
Paywalls can be customized to match the placement. For example, a placement during onboarding might have copy that welcomes the user and outlines a few key features. But a placement to unlock a specific feature should go into detail about that feature to encourage a purchase.
6. Add Placements to your App Code 👩🏼💻
Now that you have your campaigns and labels ready, development can add campaign launch code. For each of the placements you identified, developers should add a NamiCampaignManager.launch(label) call.
7. Advanced: Create Dynamic Placements ✨
If you have placements in the Nami Control Center set to Paused, they won't launch. You can use this feature to dynamically turn on and off content inside your app.
For example, you could create a placement with label black_friday that controls whether a promotional banner appears on your app home screen. In November, set the placement to 'Live' to turn on the promotional unit without requiring an app update.
Alternately, you can turn on different rules inside a placement
Last updated