Unity SDK
A Unity review prompt for iOS and Android in one C# call
PromptSurge for Unity is a UPM package that shows a short, branded pre-prompt in your game and then opens the native review sheet: StoreKit on iOS, Google Play In-App Review on Android. Call RequestReview() after a level; the copy, theme, header image and languages come from the server.
Free plan · Unity 2022.3 LTS+ · iOS and Android
1 · Your pre-prompt
A quick favor
We worked hard on offline sync. A short review helps other people discover the app.
2 · The native rating sheet
App Store or Google Play
Apple's or Google's own sheet, shown unchanged
What the Unity SDK does for you
Both stores, one call
PromptSurge.RequestReview() opens SKStoreReviewController on iOS and Play's In-App Review on Android through small native shims. The Play dependency resolves automatically with External Dependency Manager, or with one Gradle line without it.
Built for game UIs
The dialog is a UGUI overlay built in code, with your colours and header image. It creates an EventSystem if your scene has none, closes on a tap outside the card or the Android back button, and stays hidden until it is ready, so a slow image never blocks input.
Silent in the Editor
Every call is a deliberate no-op in Play Mode: no dialog, no native sheet, no billed events and nothing written to PlayerPrefs. Build to a device to see it.
IL2CPP ready
The package ships link.xml and [Preserve] attributes, so managed code stripping at Medium or High does not remove what the SDK needs.
Every eligibility check built in
Opt-out, a 90-day cooldown per device, the 10% control group, the 50-device warm-up and your plan's monthly cap are checked first. When the pre-prompt is held back for the warm-up, the control group or a spent cap, the native sheet still opens, so the moment is not lost.
The integration
Add the package in Window > Package Manager > + > Add package from git URL, using the version-pinned URL from the docs. Then initialize once and call RequestReview() at your moment.
GameManager.cs
using PromptSurgeSDK;
public class GameManager : MonoBehaviour {
void Start() {
PromptSurge.Initialize("ps_live_your_key_here");
PromptSurge.Prefetch(); // warms the cache in the background
}
}LevelManager.cs
using PromptSurgeSDK;
public class LevelManager : MonoBehaviour {
void OnLevelComplete() {
PromptSurge.RequestReview();
}
}On Android, Play's review library arrives through EDM4U automatically; without EDM4U, add implementation 'com.google.android.play:review:2.0.1' to mainTemplate.gradle. PromptSurge.SetLogLevel(LogLevel.Info) prints one line per decision while you integrate.
What your user sees, in three steps
Same users, same moment. The difference is that they are asked first, in words about your app.
Trip saved
Available offline
requestReview()
Step 1
Your code picks the moment
Call requestReview() right after something went well, such as a saved trip or a finished level.
A quick favor
We put a lot of work into offline maps. A short review helps other travelers find this app.
Not nowSureStep 2
The pre-prompt asks in your words
A short message that names what your app does. Not now closes it and nothing else happens.
Rate this app
Tap a star to rate
A review that names the feature
Offline maps saved my trip. Works without a signal.
Step 3
The store's own rating sheet
A yes opens the store's sheet, unchanged. The message they just read gives them something specific to write about.
What it is built for
More reviews from the same users
People are asked at a moment you chose, with a reason to answer.
More written reviews
A message about a feature invites words, not only stars.
Your keywords in their words
Reviews that name what your app does tell the next visitor who it is for.
A signal the stores read
Apple and Google both say ratings and reviews play a part in how apps rank in search.
Your dashboard shows what changed for your app: written reviews per day, stars and keyword mentions, before the pre-prompt and with it.
Sources: Apple: App Store search · Google Play: app discovery and ranking
How it works
Add the SDK
Install the iOS, Android or Unity package and call initialize() once at launch. Then call requestReview() at a moment you choose, such as a finished level, a saved project or a completed order.
Make the pre-prompt yours
In the dashboard, write the title, message and two button labels, or let the built-in AI draft them from your own reviews. Pick a theme, add a header image on Startup and above, and accept: the copy is translated into 10 languages and reaches devices without an app update.
Compare against the control group
10% of devices never see the pre-prompt and get the native sheet directly at the same moments. The dashboard puts both groups side by side and records your store rating and rating count every day.
Measured against a control group, not assumed
Every app gets a control group. 10% of devices are assigned to it for their lifetime and never see the pre-prompt: when they reach the moment you chose, the native sheet fires directly, as it would without PromptSurge. A new app also starts with a warm-up of 50 devices on the native sheet alone, so a baseline exists before the first pre-prompt is shown.
The dashboard compares the two groups over every device that reached your review moment: how many saw the pre-prompt, how many tapped through, how many native sheets were requested. It holds back a verdict until each side has at least 50 devices.
One honest limit: Apple and Google never tell an app whether a user rated or what they wrote. So next to the funnel, PromptSurge records your store rating and rating count once a day and shows the change. It is a store total, not credited to any single prompt, and the dashboard says so.
10% control group
Assigned per device, for life. The native sheet fires directly at the same moments.
50-device warm-up
A new app starts on the native sheet alone, so the baseline comes first.
Daily store snapshot
Your average rating and rating count from each store, once a day, for apps with a store link.
Frequently asked questions
Which Unity versions are supported?
Unity 2022.3 LTS and later. Older LTS versions may work but have not been compiled and are not supported. Android builds need Play Store distribution and minSdkVersion 21; iOS builds need iOS 14.
Why does nothing happen in the Editor?
By design. Every entry point is a no-op in Play Mode so testing never bills impressions or fills PlayerPrefs. Build to a device; on a fresh app also expect the 50-device warm-up, which you can switch off in the dashboard while you test.
Can QA see the dialog more than once?
Yes. PromptSurge.SetRateLimitBypass(true) turns off the cooldowns on that device. It is saved in PlayerPrefs and logs a warning on every check while it is on, so never call it in a build you ship.
Is the pre-prompt allowed on both stores?
Both stores require the rating itself to happen in their own sheet, and the SDK only ever opens those: StoreKit on iOS, Play In-App Review on Android, both unchanged. Apple's guideline 5.6.1 disallows custom review prompts, and Google asks apps not to ask users any questions before its card. The pre-prompt never asks how the player feels or what they would rate, and a title phrased as a statement asks no question at all. Both stores also advise against opening their sheet from a button tap, because their limits can leave it unshown; current SDK versions skip the pre-prompt where that limit has probably been reached, separately on iOS and Android. How each store reviews a particular game is that store's decision.
What the stores say, and a note for App Review →What does it cost?
The Indie plan is free forever: one app and 500 pre-prompt impressions a month, no credit card. Startup is €39 per app per month (€31 billed annually) for 10,000 impressions a month and a custom header image. Growth is €99 and Unlimited €249 per app per month. Each app has its own plan; the plan sets how many apps your organization can create. A prompt impression is one pre-prompt shown; native review sheets and control-group devices are not counted. Prices in EUR, VAT included.
Related
Start free
The Indie plan is free forever: one app, 500 pre-prompt impressions a month, no credit card. Custom header images start with Startup at €39 per app per month. Prices in EUR, VAT included.
One call after your level, the rest in the dashboard
Free plan, no credit card. Create a game, copy its API key and build to a device.
Create your free account →Already have an account? Log in