Get Premium Popup: Prerequisites and User Interaction After Full-Screen Ads

This article explains when users see the “Get Premium” subscription pop-up and what must be true before it appears.

General prerequisites

Before the pop-up can show, all of the following must be true:

1. The feature is turned on

   Premium prompts are enabled for the app (configured remotely; they are on by default).

2. Subscriptions are enabled for this app

   The app build/tenant must have subscriptions turned on in the ads settings. If subscriptions are off, the pop-up never appears (even if the remote config says it is enabled).

3. The user is eligible by usage or time

   The pop-up can show when either of these is true:

• They have opened the app on enough separate occasions (by default: more than 10 times), or

• Enough time has passed since the pop-up was last shown (by default: 15 days).

4. A full-screen ad was just closed

   The pop-up is only considered after the user closes a full-screen (interstitial) advertisement.

After the pop-up is shown once (whether they tap Yes, No, or dismiss it), the app-open counter starts over, and the waiting period is recorded from that moment.

When the pop-up is shown

There is one trigger:

After closing a full-screen ad

When: The user finishes viewing and closes a full-screen interstitial ad.

Also required: All general prerequisites above (feature on, subscriptions enabled, and eligibility by app opens or cooldown).

What the user sees and can do:

• A message promoting the app's Premium/subscription (with an animation).

• Yes - they are taken to the subscriptions screen to learn more or subscribe.

• No - the pop-up closes; they stay in the app.

Remote configuration

The general prerequisites (feature on/off, number of app opens, time between prompts) are controlled via Firebase Remote Config.

Remote Config key

| Key | Format |

|-----|--------|

| `get_premium_popup` | JSON object |

If this key is missing or invalid, the app uses the default values in the table below.

Parameters

| Parameter | What it controls | Default |

|-----------|------------------|---------|

| `isEnabled` | Whether the premium popup can appear at all. If `false`, users never see it. | `true` |

| `sessionNumber` | Number of app opens used for eligibility. The popup can show after more than this many opens (e.g. `10` means from the 11th open onward), if the other rules are met. | `10` |

| `requestRateDays` | Number of days after the last time the popup was shown before it can appear again based on time alone (even if the app-open counter was reset). | `15` |

Example JSON

```json

{

  "isEnabled": true,

  "sessionNumber": 10,

  "requestRateDays": 15

}

```

Whether subscriptions are available in the app is not set in this Remote Config key - it comes from the app’s ads/subscription settings. The pop-up only runs when that is enabled.

When and how often full-screen ads appear is separate (ad configuration), not part of `get_premium_popup`.