Understanding the Offer mode

This article explains about how the offer mode works in the Screen composer

Offer mode in Purchasely screen composer allows you to display an alternative copy or price for your offers. This feature is perfect for new user acquisition, retention and winback an expired user and lets you leverage the same Screen / Paywall both for end-users who are eligible to an Offer and those who are not.

When is Offer Mode displayed?

Offer Mode is displayed only when the end-user is eligible for the Offer associated with the plan—either an Introductory Offer or a Promotional Offer configured in the Offering. If no specific text has been defined for Offer Mode, the SDK automatically falls back to the Regular Mode text.

If the user is eligible for the two offers, iOS and Android do not use the same offer. See Which offer the SDK uses.


Which offer the SDK uses

A plan can have an introductory offer (for example a free trial) and a promotional offer in its Offering. The SDK selects one offer. It uses this offer for the Offer mode texts, the offer price tags and the purchase. iOS and Android select the offer in a different order, because the App Store and Google Play give offers to users in different ways.

PlatformOrderWhy
iOS1. The introductory offer, if the user is eligible for it.
2. If not, the promotional offer of the Offering, if the App Store gives it to the user.
3. If not, the Regular mode.
The App Store gives promotional offers only to current and past subscribers.
Android1. The offer of the Offering (promotional or developer determined offer), if Google Play gives it to the user.
2. If not, the introductory offer (the default offer of the base plan), if the user is eligible for it.
3. If not, the Regular mode.
Google Play gives a "New customer acquisition" offer only to an eligible user. Thus the offer of the Offering already follows the eligibility rules of Google Play.

The default offer of an Android base plan is its first offer without the ignore-offer tag.

Example: a plan has a 7-day free trial, and its Offering contains a 40% discount offer.

  • On Android, a new user sees and buys the 40% discount, not the free trial.
  • On iOS, the same user sees and buys the free trial.

In Observer mode, the SDK sends the selected offer to your purchase interceptor. On Android, the Purchase action contains this offer in offer and subscriptionOffer.

Developer determined offers (Google Play)

Google Play gives a "Developer determined" offer to all users. Your app decides which users are eligible. Thus, on Android, if the Offering contains a developer determined offer, the SDK shows the Offer mode and buys this offer for all users. isEligibleToOffer(storeOfferId) also returns true for all users.

To give this offer only to the users that you select, use one of these solutions:

  • A user attribute. Set a custom user attribute from your app (for example eligible_promo_offer). Use it in a conditional visibility rule or in an Audience. Show the purchase button with the Offering only to these users.
  • The eligibility to the introductory offer. Use the Eligibility for an Offer condition. Show a purchase button without Offering to the users who are eligible for the introductory offer. Show the purchase button with the developer determined offer to the users who are not eligible.
📘

The "Eligibility for an Offer" condition

The Eligibility for an Offer condition checks only the introductory offer, on iOS and on Android. It does not check the promotional offer of the Offering. Thus, on Android, a component with this condition can stay hidden while the purchase button buys the promotional offer.


How to customize a paywall for offer mode:

Once you have prepared a paywall for Regular Mode, you turn on the offer mode radio button on the top of the screen and customize each and every text element you have filled for the regular mode you can customize it for offer mode.

How to display the offer price for different regions ?

Purchasely provides you with tags to automatically to fetch the offer price and offer duration.

Use the following tag to show the the introductory offer or new user acquisition offer & promotional offer or developer determined offer price.

TagUsageExample
OFFER_PRICEDisplays 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_AMOUNTDisplays 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_PERIODDisplays 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_DURATIONDisplays 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_COMPARISONDisplays 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_PERCENTAGEDisplays 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%

Get user eligibility to introductory offer

Purchasely SDK provides a method to retrieve easily from your application if a user is eligible to a introductory offer (or free trial)
More information in the dedicated article


What’s Next

Check Dynamic Offering to learn more about how to associate multiple offering to a same Paywall

Did this page help you?