Push opt-in timing in FTUE versus later sessions
Checklist for push notification permission timing, anchored to Apple HIG privacy and request-review timing guidance.
Push permission is a one-shot system dialog on Apple platforms. Apple’s HIG Privacy guidance emphasises clear purpose and avoiding unnecessary prompts. Apple’s request-review documentation likewise advises against interrupting launch and recommends waiting for a completed positive sequence — useful timing hygiene even though it addresses reviews, not push.
Operator checklist
- Pre-permission screen explaining the value (energy full, war start, event) before the system dialog.
- Not at first cold launch unless the feature is unusable without push.
- After a value moment (first clear, first clan invite, first energy empty).
- Purpose string matches actual push categories.
- Decline path: App remains usable; soft re-prompt via settings deep link only.
- Analytics: Record auth status; do not treat provisional/denied as opted-in.
- Live-ops dependency: Critical events must also surface in-session for denied users.
Limits
Android notification permission timing differs by OS version; confirm on current target API separately.
