What are tag used for?

Purchasely has a tagging system to fetch information about the price and duration of subscriptions and one-time purchases, as well as the Introductory Offer (for user acquisition) and Promotional Offer (winback/retention) prices and durations.

Thanks to these tags, you don't have to hard code price for each and every stores in your screens and paywalls.

Using these tags will also ease to make your paywall compliant with the App Store Guidelines.

📘

You should be transparent about the plan price in your Paywalls. If you have any introductory offer or promotional offer, you should mention how much the user will pay after the offer ended.

Where can you use tags?

Tags can be used in any label on a Screen. You can add them by simply clicking on the {{TAGS}} inside the text field.

You can also directly type them in plain text. To do so, put the name of the tag between 2 pairs of curly brackets. Eg: {{PRICE}}

What are the options when using tags?

You can use 2 types of tags.

• Tags with no parameters refer to the Plan directly mapped with the parent element (eg: the picker to which the text belongs or the purchase button) or to the default Plan configured for this Screen. To use this kind of tags, simply click on the blue button inside the widget.

  

  => This way, if you change the Plan associated with the button / picker (or run an Price A/B test), you won't need to update the tag.

• Tags with parameters are mapped with a specific Plan. They appear with the reference of the Plan selected between brackets. If you want to use them, simply select the desired Plan in the widget.

  

  They can be used to reference another Plan in a picker or button than the one which it is mapped with, or to associate a Plan which is not the default one.

🚧

Why does the preview display a $XX.XX instead of the actual price?

In some cases, tags cannot be displayed properly in the preview of the Console. They are replaced by XX.XX

The reason is that the Purchasely Console is not directly interfaced with the App stores. Therefore, it can only know the price of a SKUs in each territory once a transaction has been processed or observed by the Platform.

As soon as it is the case, the XX.XX will be replace by the actual price in the appropriate currency. Eg: $9.99

Be reassured however, the SDK fetches the information directly from the App stores, and therefore always displays the correct price, in the appropriate currency (the one from the user's App store territory).

Types of tags

General tags:

These tags are most common tags that used in all the paywalls. Purchasely checks if your paywall has either the PRICE tag or AMOUNT/DURATION or AMOUNT/PERIOD tag in the purchase buttons.

Introductory offer tags

These tags displays the price and duration of the introductory offers or free trials you have created in the stores.

Duration tags

These tags help you display the subscription duration in days, weeks , months and etc.

Subscription cost per duration tags

These tags helps you to display subscription cost per day, week or month and etc. They are convenient to compare together several plans with different periodicities.
E.g.: compare the monthly price of a yearly subscription with a monthly subscription.

Price & Percentage comparison tags

These tags comes handy for your to calculate percentage difference and the price difference between 2 different plans and show them automatically in the respective currency.

Promotional offer tags

These tags displays the price and duration of the winback/retention offers you have created in the stores and in the Purchasely console.

Countdown tag

These set of tags are very useful to create dynamic countdowns. You can integrate them in any label of your Screen. 3 different types of Timers are offered:

• Relative countdown
• Absolute countdown
• User countdown

Timers are not only a simple tag but rather a set of tags composed of different sub-tags (TIMER(MONTHS), TIMER(DAYS), TIMER(MINUTES), TIMER(SECONDS)) that can be manipulated independently.

Depending on the format you associate to the Tag, they will appear in the text field with the following format:

They are actually a composition of several tags. In the case above:

• one for hours
• one for minutes
• one for seconds

By default, the tags are separated by colon (":"). You can replace the colons by any string you want directly in the text field:

For more information and capabilities about Countdowns. have a look at the Countdown component