HomeGuidesChangelogDiscussions
Log In
Guides
Start typing to search…

Tags

This section provides details about the Price Tags available in the Screen & Paywall Builder

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.

The tag $59.99 references a different Plan than the one associated to the plan picker

The strikethrough price is a reference to another Plan than the one associated with the picker


🚧

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.

Tag

Usage

Example

PRICE

Full price with period (e.g., $9.99/month)

"Subscription will be renewed at {{PRICE}}"

AMOUNT

Price without period (e.g., $9.99)

"Your lifetime plan costs {{AMOUNT}}"

PERIOD

Billing period unit (e.g., month, year)

Billed every {{PERIOD}}

DURATION

Total duration
(e.g., 1 month, 1 year).

Access for {{DURATION}}


Duration tags

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

Name

Usage

Example

DAYS_DURATION

Duration in days

For a renewing plan:

  • Subscription starting from {{PRICE}} is {{DAILY_AMOUNT}}/day during {{DAYS_DURATION}}.
  • The output will be:
    Subscription starting from $6.99/week is $0.99/day only during 7 days.

WEEKS_DURATION

Duration in weeks

For a renewing plan:

  • Subscription starting from {{PRICE}} is {{WEEKLY_AMOUNT}}/week during {{WEEKS_DURATION}}.
  • The output will be:
    Subscription starting from $6.99/month is $1.75/week during 4 weeks.

MONTHS_DURATION

Duration in months

For a renewing plan:

  • Subscription starting from {{PRICE}} is {{MONTHLY_AMOUNT}}/month during {{MONTHS_DURATION}}.
  • The output will be:
    Subscription starting from $24.99/year is $2.08/month only during 12 months.

QUARTERS_DURATION

Duration in quarters

For a renewing plan:
Subscription starting from**{{PRICE}}** is {{QUARTERLY_AMOUNT}}/quarter during {{QUARTERS_DURATION}}.

The output will be:
Subscription starting from 24€99/year is $6.24/quarter only during 4 quarters.

YEARS_DURATION

Duration in years. If the subscription is less than a year, the output will be 0.

For a renewing plan:
Subscription starting from**{{PRICE}}** is {{YEARLY_AMOUNT}}/year for {{YEARS_DURATION}}.

The output will be:
Subscription starting from $119.99/year is $119.99/year only for 1 year.


Subscription cost per duration tags

Perfect for showing equivalent cost breakdowns, useful when comparing plans.

Name

Usage

Example

DAILY_AMOUNT

Cost per day

For a renewing plan:

  • Subscription costs {{DAILY_AMOUNT}} only per day.
  • The output will be:
    Subscription costs $0.49 only per day.

WEEKLY_AMOUNT

Cost per week

For a renewing plan:
Subscription costs**{{WEEKLY_AMOUNT}}** only per week.

The output will be:
Subscription that costs $2.78 only per week.

MONTHLY_AMOUNT

Cost per month

For a renewing plan:

  • Subscription costs **{{MONTHLY_AMOUNT}}**only per month.
  • The output will be:
    Subscription costs $6.99 only per month.

QUARTERLY_AMOUNT

Cost per quarter

For a renewing plan:
Subscription costs**{{QUARTERLY_AMOUNT}}** only per quarter.

The output will be:
Subscription costs $18.99 only per quarter.

YEARLY_AMOUNT

Cost per year

For a renewing plan:

  • Subscription costs {{YEARLY_AMOUNT}} only per year.
  • The output will be:
    Subscription costs $25.99 only per year.

OFFER_DAILY_AMOUNT

Displays the cost of the Introductory Offer or Promotional Offer of a Plan per day.

For a renewing plan:

  • Special offer: {{OFFER_DAILY_AMOUNT}} only per day.
  • The output will be:
    Special offer: $0.49 only per day.

OFFER_WEEKLY_AMOUNT

Displays the cost of the Introductory Offer or Promotional Offer of a Plan per week.

For a renewing plan:
Subscription costs**{{OFFER_WEEKLY_AMOUNT}}** only per week.

The output will be:
Subscription that costs $2.78 only per week.

OFFER_MONTHLY_AMOUNT

Displays the cost of the Introductory Offer or Promotional Offer of a Plan per month.

For a renewing plan:

  • Subscription costs **{{OFFER_MONTHLY_AMOUNT}}**only per month.
  • The output will be:
    Subscription costs $6.99 only per month.

OFFER_QUARTERLY_AMOUNT

Displays the cost of the Introductory Offer or Promotional Offer of a Plan per quarter.

For a renewing plan:
Subscription costs**{{OFFER_QUARTERLY_AMOUNT}}** only per quarter.

The output will be:
Subscription costs $18.99 only per quarter.

OFFER_YEARLY_AMOUNT

Displays the cost of the Introductory Offer or Promotional Offer of a Plan per year.

For a renewing plan:

  • Subscription costs {{OFFER_YEARLY_AMOUNT}} only per year.
  • The output will be:
    Subscription costs $25.99 only per year.

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.

Name

Usage

Example

PERCENTAGE_COMPARISON

Compares the first plan against the second one

With:

  • yearly: $99.99/year
  • monthly: $9.99/month
    • {{PERCENTAGE_COMPARISON(YEARLY,MONTHLY)}} will display 17%
    • {{PERCENTAGE_COMPARISON(MONTHLY,YEARLY)}} will display 20%_

DISCOUNT_PERCENTAGE

Discount % between two plans.
The first plan is the one being described. The second is the one to compare it with.
The order in which the plans are selected matters.

With:

  • yearly: $99.99/year
  • monthly: $9.99/month
    • {{DISCOUNT_PERCENTAGE(YEARLY,MONTHLY)}} will display 17%
    • {{DISCOUNT_PERCENTAGE(MONTHLY,YEARLY)}}* will display 17%_

RAISE_PERCENTAGE

% increase between plans. The order in which the plans are selected does not matter.

With:

  • yearly: $99.99/year
  • monthly: $9.99/monthThe output will be:
    • {{RAISE_PERCENTAGE(YEARLY,MONTHLY)}} will display 20%
      • {{RAISE_PERCENTAGE(MONTHLY,YEARLY)}}* will display 20%_

PRICE_COMPARISON

Raw price difference.
The price difference is computed with the periodicity of the first plan selected.

With:

  • yearly: $99.99/year

  • monthly: $9.99/month

    • The output will be:
    • {{PRICE_COMPARISON(YEARLY,MONTHLY)}}* will display $19.89
      => the monthly plan costs $19.89 more than the yearly plan on a yearly base
      • {{PRICE_COMPARISON(MONTHLY,YEARLY)}}* will display $1.66
        => the monthly plan costs $1.66 more than the yearly plan on a monthly base_

Offer tags

These tags can be used to display the price and duration of the both introductory/new user acquisition offers and Winback/retention offers you have created in the stores and declared in the Purchasely console.

Tag

Usage

Example

OFFER_PRICE

Offer price with period

For a winback offer :

  • Don't miss the intro offer of {{OFFER_PRICE}} for the first week.
  • The output will be:
    Don't miss the intro offer of $0.99/week for the first week.

OFFER_AMOUNT

Offer price without period (e.g., $9.99).

For a winback offer :

  • Don't miss the intro offer of {{OFFER_AMOUNT}} for the first month.
  • The output will be:
    Don't miss the intro offer of $5.99 for the first month.

OFFER_PERIOD

Billing period during offer

For an extension of a free trial:

  • Don't miss the free trial for a {{OFFER_PERIOD}}.
  • The output will be:
    Don't miss the free trial for a week.

OFFER_DURATION

Total offer length

For a winback:

  • Hurry up intro offer for {{OFFER_AMOUNT}}/ {{OFFER_DURATION}}.
  • The output will be:
    Hurry up intro offer for $0.99 / 1week.

OFFER_PRICE_COMPARISON

Displays the price difference between the discounted offer and the regular price of the plan for the higher duration.

With:

  • offer price: $99.99/year
  • monthly: $9.99/month
    • {{OFFER_PRICE_COMPARISON}}* will display $19.89

OFFER_DISCOUNT_PERCENTAGE

% discount of an Offer price vs Full price.

  • If only one Offering is selected, compares the discount percentage of the Offer (Introductory Offer or Promotional Offer) with the full price.
  • If 2 different Offerings are selected, compares the discount percentage of the Offer (Introductory Offer or Promotional Offer) from the first Offering, with the full price of the second Offering

With:

  • offer price: $99.99/year
  • monthly: $9.99/month
    • {{OFFER_DISCOUNT_PERCENTAGE(plan1,plan2)}}* will display 17%

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:

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

Updated 1 day ago