Pricing Eligibility States

This document describes how Pricing Eligibility works in SDK version 3.1

Paid Feature

Pricing Eligibility is supported in Nami SDK Versions 3.1+ for customers on Team plans or above.

Select Nami paywall templates are configured with pricing eligibility in mind. There are two flavors of eligibility-aware paywalls:

• Trial Eligibility: Allows you to create a paywall that can be configured to show conditional information based upon whether the user is eligible for a Free Trial Otherwise, the paywall surfaces Standard pricing. Requires Team or above plans and a supported paywall template.

• Offer Eligibility: Allows you to create a paywall that can be configured to show conditional information based upon all user eligibilities: Free Trial, Introductory Offer, Promotional Offer, or Standard (no offer) eligibility. Requires Business or above plans and a supported paywall template.

Determining Eligibility

SDK 3.2

In the latest 3.2.x versions of the Nami SDK (Paywall Creatorcompatible), a user can be in multiple different eligibility states and the paywall logic will determine what product and paywall copy and contents to show.

SDK 3.1

In the 3.1.x versions of the Nami SDK, a user can fall into multiple different eligibility states but the SDK will choose only 1 state for each product using this logic:

if the product is eligible for a free trial:
	use "Free Trial" text
else if the product is eligible for an introductory pricing offer (apple only):
	use "Introductory Pricing" text
else if you have added a promotional offer identifier and the user is eligible:
	use "Promotional Pricing" text
else:
	use "Standard Pricing" text

Promotional Offers

Products can have a number of promotional offers available. You will need to provide us with a reference to the promotional offer you want to be purchased from the paywall.

Here is how to find a specific promotional offer based on your app platform(s):

Finding Promotional Offers in Apple App Store Connect

1. Login to App Store Connect
2. Navigate to your app in the Apps list. Click 'Subscriptions' from the left-hand menu.

3. Select the Subscription Group of the product

4. Click the Subscription product in the list and scroll down to 'Subscription Prices'

5. Click 'View all Subscription Prices'

6. Select the 'Promotional Offers' tab

7. You will see a list of Promotional offers that you have configured for this product. Note the order of the promos and their ids.

Finding Promotional Offers in Google Play Console

Instructions coming soon

Choosing a Promotional Offer to Purchase

1. Navigate to the paywall, click 'Products', and then select the base SKU that a promotional offer exists for.

2. In the 'Promo to Purchase' field in this product's display, enter one of these options:

   1. ${sku.promo:0} to purchase the first promo in the list

   2. ${sku.promo:1} to purchase the second promo in the list

   3. ${sku.promo:_promo_ref_id to purchase a promo with the provided identifier from the platform developer console (see above instructions)

Setting up Paywall

Product SKU Copy for each Eligibility State

Each product SKU has a number of editable fields. When pricing eligibility state is turned on, each of these fields can be changed to show different copy to users depending on their eligibility.

To update text, pick the state from the 'Pricing Eligibility' dropdown and change each text field accordingly.

Dynamic Paywall Copy for each Eligibility State

Some paywalls also support changing paywall title, subtitle, button text, or other copy based on eligibility. The state is chosen using this logic:

if any product in the selected group is eligible for a free trial:
	use "Free Trial" text
else if any product in the selected group paywall is eligible for an introductory pricing offer:
	use "Introductory Pricing" text
else if any product has a promotional offer identifier:
	use "Promotional Pricing" text
else:
	use "Standard Pricing" text

Example

In this example paywall, 2 products are shown: 1 month and 1 year. The paywall title, product text elements, and purchase button all change depending on the user's eligibility.

See this table to understand how to setup this scenario using eligibility.

Component	Copy
Paywall Header	Free Trial - "Try Better Sleep for Free" Intro Offer - "Special Offer for New Users" Promo Offer - "20% off for a Limited Time" Standard - "Unlock Better Sleep"
Product Secondary Text	Free Trial - "${sku.freeTrialDuration} free trial" Intro Offer, Promo Offer, Standard - ""
Product Price	Free Trial - "${sku.price}" Intro Offer - "${sku.price} ${sku.introductoryPrice}" Promo Offer - "${sku.price} ${sku.promoPrice:0}" Standard - "${sku.price"
Product Badge	Free Trial - "Save ${sku.percentagePriceDifferenceFromSku:1}" Intro Offer - "Special Offer" Promo Offer - "Save 21%" Standard - "Save ${sku.percentagePriceDifferenceFromSku:1}"
Purchase Button	Free Trial - "Start your free trial" Intro Offer - "Activate Introductory Offer" Promo Offer - "Get started for ${sku.promoPrice:0}/year" Standard - "Continue"

📘 Use Smart Text to quickly pull prices for each type of offer. Paywall Smart Text