Plan pickers vertical
This page provides details on the configuration of the Plan picker vertical in the screen composer
General overview
A Plan Picker is a paywall component that allows users to view and select subscription Plans or one-time purchase options. User can choose which Plan they want to purchase and confirm it by clicking on a purchase CTA.
In the Screen Composer, the CTA to trigger the purchase action (once the Plan has been chosen) is a separated component from the Plan picker, called CTA for Plan pickers that can be put in a different surface:
- Plan pickers allow user to choose which plan they are interested in
- CTAs for Plan pickers are required to trigger the purchase action of the selected Plan
Configuration
Plan picker structure
The Plan picker vertical has the following structure:
The component is composed of:
- a parent element (highlighted on the picture above), where general configuration options valid for all the pickers can be defined
- child elements that represent each Picker individually (Picker 1 & Picker 2 on the picture above). They are stacked vertically and can be reordered.
Configuring the general parameters of the component
Here are all the parameters that can be adjusted for the Plan picker:
-
Id
: the default value "plan_picker_1" works fine. Only change the Id if you want to have several Plan pickers on the same Screen:- Pickers on a same Screen which are are mapped with the same
Id
interact together. - Plan pickers with different
Ids
are independent.
- Pickers on a same Screen which are are mapped with the same
-
Picker styles
-
You can define 2 different
background
andborder
for each picker depending on its state:unselected
/selected
-
-
Pickers icon
-
You can activate or deactivate the icon
-
If you activate it, you can define 2 different images depending on the state of the picker:
unselected
/selected
-
The
icon size
andicon alignment
(left
orright
) can be adjusted -
By enabling
Text and Icon centered
, you can wrap the icon & the Texts inside button at the center of the button
-
-
Pickers layout
Full width
: allows you to extend the picker to fit 100% of the width available. If deactivated, the width of the picker will hug its content.Min height
: defines the minimum height for the picker. If the content overflows and does not fit in that height, the picker will extend its height.Space between pickers
: defines the spacing between the pickers
Configuring the pickers
Each picker must be associated with a Plan and can be optionally associated to an Offer (Promotional Offer). You must have associated the Plans to the Screen (Manage Plan section) prior to mapping it with the pickers.
The Default
switch allows you define that one Picker should be selected by default when the Screen is displayed (without need for the User to manually select it). Only one picker can be selected by default.
Margin Top / Bottom / Left & Right can be defined specifically for each picker.
Configuring Texts in the collections of Texts
To give you maximum flexibility and allow you to create as many lines and font-styles as you wish, each Picker has a collection of texts (ex: Promo label, Texts above button, Texts inside button etc...). Texts can be added inside a collection by clicking on the +
button:
-
Each collection maps a specific location
-
Depending on the collection, up to 4 Texts can be added, which brings you a lot of flexibility to match the desired design.
-
Within a collection, Texts can be reordered by drag & dropping them
-
Spacing between the Texts can be set by adjusting each Text Top & Bottom margin.
Overriding the Texts of the CTA
In the Plan Picker, the collections starting with CTA
allow to override the Texts of the CTA depending on which picker is currently selected:
- When the Picker will be selected by the user, the Texts in these collections will override the default Texts associated at the Purchase CTA level.
- Overriding the Texts is optional but if you override one of them, you must override them all.
Example:
-
The default Text defined for the CTA is "Start my premium membership"
-
This Text is overridden for each picker:
-
"Start my weekly membership" for the Picker associated to the Weekly Plan
-
"Start my monthly membership" for the Picker associated to the Monthly Plan
-
"Start my yearly membership" for the Picker associated to the Yearly Plan
-
-
When a Picker is selected, the Text inside the CTA changes to match the value defined at the picker level
Displaying Regular Texts vs Offer Texts
To give you maximum flexibility and allow you define specific texts depending on the eligibility of the User to an Offer, 2 different versions can be defined for each Text:
Regular text
: this text is displayed when no Offer (neither Introductory Offer or Promotional Offer) has been configured for the Plan in the app stores or when the user is not eligible to the Offer.Offer text
: this text is displayed when an Offer has been configured for the Plan (either Introductory Offer or Promotional Offer) and the User is eligible to this Offer.
Leveraging tags
Tags can be used inside Texts. You can either type them directly in plain text by putting them between pairs of curly brackets (eg: {{PRICE}}
{{AMOUNT}}
{{DURATION}}
). You can also click on the {{TAGS}}
button in the bar just above the text input.
If you want the tag to refer to the button mapped with the element, choose the option "Use element's plan / default plan" after selecting your tag:
- In this case, the tag should appear without parameters when displayed in the text field.
- The advantage is that you will not need to update the tag if you update the Plan associated to the picker.
If you want the tag to refer to another Plan (eg: to strike through a former price), you can pick the desired Plan directly
Configuring the Promo overlay
You can display a Promo overlay on any button / picker or CTA. A promo overlay is a Text
with a background
and a border
. You can adjust its horizontal positioning by using changing the text alignement (left / center / right) and adjusting the left & right margin
This overlay can be associated with 2 styles: selected
/ unselected
Updated 25 days ago