Bolt Metered Paywall
Table of Contents
This article highlights the functionality of the metered paywall. Please see this article for the paywall overview.
Metered Paywall
Pugpig Bolt supports the concept of a metered paywall, which allows users to access a certain amount of content that would usually be protected before they're presented with the paywall. This serves as an easy, flexible way to give users a taste of the full app experience.
You're able to choose a number of articles or other cards (e.g. audio) that a user can view or interact with before they're shown the paywall. Users will retain access to these articles or cards even after the paywall is shown, but any new articles or cards they interact with will display the paywall. We show a display in the app to let users know how many articles they've read out of their limit. Tapping the display will invoke the paywall, allowing them to easily subscribe at any point.
This limit is tracked locally on the device, and thus users are able to exceed their limit by using multiple devices, or deleting and reinstalling the app
Options
The metered paywall offers a configurable number of free articles and can be reset on a specified time-basis, but there are a number of ways in which we're planning to or considering expanding this functionality in the future, including:
- Resetting at the beginning of every week or month
- Offering a time-based limit
- Tying the limit to a 3rd-party system, such as Piano
Notes
- Metered content will remain available to the user even after they reach their limit.
- Free articles won't count towards the limit.
- The limit can be change via config, but this will not reset the count for users who have already installed the app and viewed some content, it will adjust it. For example if your meter is set to 5 and a user has 2 out of 5 free articles remaining, changing the meter to 10 would adjust the user's free articles to 7 out of 10.
Exclusion
Specific collections or articles can be excluded from the metered paywall (meaning they won't be available at all without subscribing or signing in) by adding a custom field to the collection or article in the CMS called:
pugpig_widgets_meter
To control how the meter works you can set the value for this custom field to:
- "default" - for any articles to be included in the meter
- "excluded" - for articles that should be excluded from the meter.
If the custom field is not there, the content will behave as normal (as part of the meter).
Exclusion via feed
If you'd like to control metered paywall inclusion/exclusion via an RSS feed, you can do so by adding a new tag to each item and setting the value to:
- "default" - for any articles to be included in the meter
- "excluded" - for articles that should be excluded from the meter.
Running concurrent meters (not supported)
A concurrent meter would involve, for example, being able to access 5 standard articles and/or 2 premium articles before hitting the paywall. We have discussed this internally, but currently do not have a good solution that isn't very confusing for the end user. If you have any good suggestions or examples, please get in touch with us.
Analytics and Tracking
- We send a BoltMeterDisplayShown event every time the meter is visible to the user. The pugpigLimitCount or KGLabel (GA4) dimension indicates how many articles the user has left in their meter allowance at the point that it is shown to them.
- BoltPaywallDisplayed fires when a user reaches the end of the meter and the paywall is surfaced
- We can determine when the meter has refreshed when a user who previously fired a BoltMeterDisplayShown event where the pugpigLimitCount / KGLabel dimension = 0, fires another BoltMeterDisplayShown event where the pugpigLimitCount / KGLabel dimension = e.g.
4
if the meter allows the user to view 5 articles