Store review prompt

The system-drawn 'enjoying this app?' dialog with the star row, requested through Apple's requestReview API (SKStoreReviewController) or Google's In-App Review API. The key word is requested: you ask, the OS decides. It may show nothing, and it never tells you whether it appeared. Apple caps it at roughly three prompts per user per year, and Google enforces its own quota.

Timing is the whole game. Fire it after a success moment (a finished workout, a saved export, the third good session), never on first launch, never mid-task, and never stacked next to a permission dialog or paywall. Track your own counter so you spend the yearly budget on your happiest users, and gate on real engagement rather than days installed.

Gotchas: both platforms forbid incentivizing ratings, and Apple prohibits your own custom rating dialog in place of the native one, so the old 'did you like it? no? then email us instead' funnel is a policy risk. Testing is also deceptive, in two different ways. In a development build the prompt does appear, but it is a test dialog that submits nothing. In a TestFlight build the request does nothing at all: no dialog, no error, no signal, which is not a bug in your integration. And in production it often will not show either, because the quota is doing its job. Log the call site and move on rather than chasing a dialog you were never going to see.