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 below the input text.

  • When using them inside a button, we strongly advise you to map them with the Plan associated with the button by choosing Use button's plan

    => 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.

    • If you want to reference another Plan (e.g.:to show a strikethrough price) than the one associated with the button / picker, you can choose any other Plan configured in the Purchasely Console.

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

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

  • When using them outside of a button, you need to reference the associated Plan explicitly.


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.

Tag

Usage

Example

PRICE

Displays the plan price with the period.

For a renewing plan:
Subscription starting from{{PRICE}}.
The output will be:
Subscription starting from $6.99/month.

For consumables / non-consumables :
Enjoy a lifetime plan at{{PRICE}}.
The output will be:
Enjoy a lifetime at $83.99.

AMOUNT

Displays the plan price.

For a renewing plan:
Subscription starting from{{AMOUNT}}

The output will be:
Subscription starting from $6.99.

For consumables / non-consumables :
Enjoy a lifetime plan at{{AMOUNT}}.

The output will be:
Enjoy a lifetime plan at $83.99.

PERIOD

Displays the period of the plan.

For a renewing plan:
Subscription starting from{{AMOUNT}}/{{PERIOD}}.

The output will be:
Subscription starting from $6.99/month.

DURATION

Displays the duration of the plan.

For a renewing plan:

  • Subscription starting from {{AMOUNT}} for {{DURATION}}.
  • The output will be:
    Subscription starting from $6.99 for 1 month.

🚧

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).


Introductory offer tags

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

Tag

Usage

Example

TRIAL_PRICE

Displays the intro price or discounted price(that you have configured in Apple or Google store) of the plan.

For a discounted trial:

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

TRIAL_AMOUNT

Displays the intro price or discounted price(that you have configured in Apple or Google store) of the plan.

For a discounted trial:
Don't miss the intro offer of{{TRIAL_AMOUNT}} for the first month.

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

TRIAL_PERIOD

Displays the trial period or free trial (that you have configured in Apple or Google store) configured for the plan.

For a free trial:

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

TRIAL_DURATION

Displays the trial period or free trial (that you have configured in Apple or Google store) configured for the plan.

For a discounted trial:

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

TRIAL_DAYS_DURATION

Displays the trial duration in the days count.

For a free trial:

  • Don't miss the free trial for {{TRIAL_DAYS_DURATION}}
  • The output will be:
    Don't miss the free trial for 7 days

TRIAL_DISCOUNT_PERCENTAGE

Displays the discount percentage between the trial (free or paid) and the regular price of the plan for the period of the subscription.

For a free trial or intro price:

  • Don't miss this starting price with a discount of {{TRIAL_DISCOUNT_PERCENTAGE}}
  • The output will be:
    Don't miss this starting price with a discount of 67%

TRIAL_PRICE_COMPARISON

Displays the price difference between the trial (free or paid) and the regular price of the plan for the period of the subscription.

For a free trial or intro price:

  • Don't miss this starting price with a discount of {{TRIAL_PRICE_COMPARISON}}
  • The output will be:
    Don't miss this starting price with a discount of $24

Duration tags

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

Name

Usage

Example

DAYS_DURATION

Displays the subscription 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

Displays the subscription 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

Displays the subscription 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

Displays the subscription 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

Displays the subscription 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

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.

Name

Usage

Example

DAILY_AMOUNT

Displays the cost of a plan 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

Displays the cost of a plan 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

Displays the cost of a plan 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

Displays the cost of a plan 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

Displays the cost of a plan 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

Displays the percentage difference between the plan in the purchase button and the plan chosen.

With:

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

DISCOUNT_PERCENTAGE

Displays the discount percentage between the actual plan in the purchase button and the plan chosen.
The order in which the plans are selected does not matter.

With:

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

RAISE_PERCENTAGE

Displays the raise of price in percentage between the actual plan in the purchase button and the plan chosen.
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%
      • *{{RAISEPERCENTAGE(MONTHLY,YEARLY)}}** will display 20%

PRICE_COMPARISON

Displays the price difference between the plan in the purchase button and the plan chosen.
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
      • *{{PRICECOMPARISON(MONTHLY,YEARLY)}}** will display $1.66
        => the monthly plan costs $1.66 more than the yearly plan on a monthly base

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.

Tag

Usage

Example

OFFER_PRICE

Displays the winback offer price.

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

Displays the winback offer amount.

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

Displays the winback offer period.

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

Displays the winback offer duration.

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

Displays the discount percentage between the discounted offer and the regular price of the plan.

With:

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

Timer tags

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:

Timer tags when the format D:hh:mm:ss has been selected

Timer tags when the format D:hh:mm:ss has been selected

This allows you to keep only the desired tags or to insert static text in between:


Timer (relative)

This tag presents a relative timer indicating when the offer will expire. This timer resets each time the paywall is reopened. You can use this timer for limited offers.

To use this tag, click on the tags and choose Timer

Select the timer type as relative,

Fill in the count down in seconds and select the format you want to show it(M D hh mm ss .... etc) and click ok to set the timer.


Timer (absolute)

This tag presents an absolute timer for the offer expiration. This timer automatically calculates the remaining time left based on the countdown date set.

To use this tag, click on the tags and choose Timer


Select the timer type as absolute

Select the count down end date, the timezone, and the format you want to show it(M D hh mm ss .... etc) and click ok to set the timer.


Timer (User countdown)

This tag presents an user centric timer. This timer is set based on any date attribute related to the user and their subscription. Refer to all the date attributes here. You can also create a custom attribute and choose it to customize this timer.

To use this tag, click on the tags and choose Timer

Select the User countdown

  1. Select the user attribute to set a countdown dynamically from the app.
  2. The countdown in second you choose is also the number of seconds that will be added to the one you set in the attribute. So the final countdown is attribute + countdown in seconds
  1. When leveraging a Custom User Attribute for the count down (e.g.: promotionStartDate, type:Date) if it has not been set when the paywall is displayed, the SDK will automatically initialize it with the current date - now() - when the Screen is being displayed for the first time.

More details on how to configure and leverage countdown to boost the conversion

Updated about 1 month ago