LizardHouse Notifications: Permission and Re-Engagement

Earn notification permission at the right moment. Schedule, localize, and measure relevant local notifications that bring players back to your Unity game or app on Android and iOS.

A complete device-local notification permission and re-engagement workflow for Unity, with the editor tools, integrations, testing support, and source code needed to adapt it to your project.

🎯 Permission Journey

• Prompt options: Native Prompt or fully custom Soft Prompt prefab
• Presentation timing: App Start, After Conditions, or Manual
• Engagement conditions: Cumulative Active App Time, developer-defined Custom Events, or both using AND logic
• Contextual follow-ups: Multiple Soft Prompts after Not Now, each with its own prefab, delay, and engagement conditions
• Player-initiated activation: An in-game button or toggle can request native permission directly
• Persistent progress: Permission journey state is retained across scenes, sessions, and app restarts
• Optional restart: The Soft Prompt journey can restart after previously enabled notifications are turned off

🔔 Local Re-Engagement Notifications

• Inactivity-based scheduling: Reminders are scheduled when the player leaves or backgrounds the app
• Flexible sequences: Create one reminder or build a reorderable sequence across hours, days, weeks, or months
• Individual configuration: Set a separate delay, title, message, image, localization, Quiet Hours policy, Notification Key, and Custom Payload for every reminder
• One Time Only: Limit selected reminders to one completed delivery lifecycle per player
• Existing-player reset: Allow a selected One Time Only reminder to be used again in a future game version
• Player-return cleanup: Cancel reminders from the previous inactivity cycle when the player comes back
• Selective ownership: Only notifications scheduled by LizardHouse are cancelled or removed
• Stable reminder identity: Internal notification identifiers remain connected to their reminders when the sequence is reordered

🌙 Quiet Hours

• Device-local timing: Quiet Hours follow the player’s local device time
• Per-reminder control: Every reminder can use a different Quiet Hours policy
• Three delivery policies: Respect Quiet Hours, Allow During Quiet Hours, or Pause Delay During Quiet Hours

📲 Notification Opens and Player State

• Open callback: Detect when a notification scheduled by LizardHouse is opened
• Routing data: Receive an optional Notification Key and Custom Payload
• App lifecycle support: Handles notification opens during warm and cold starts
• Reliable delivery: A pending open is retained until a subscriber is available, with at-most-once callback delivery
• Effective state model: Enabled, DisabledByPlayer, PermissionRequired, PermissionDenied, Pending, and Unsupported
• State updates: Respond when the effective notification state changes
• In-game controls: Enable or disable reminders from your own Settings UI
• OS recovery: Open the app’s operating system notification settings when required

🌍 Content and Localization

• Localization options: None, Unity Localization, or Custom Integration
• Custom provider support: Generate a ready-to-connect localization integration script from the Settings Window
• Fallback content: Keep a title and message available when localized content cannot be resolved
• Notification images: Assign a different optional image to every reminder
• Native image preparation: Images are processed and cached for native notification use
• Android small icon: Configure and validate a custom status-bar icon
• Android notification channel: Configure the player-visible Channel Name and Description while retaining a stable internal Channel ID

📊 Analytics

• Provider options: None, Firebase Analytics, or Custom Integration
• Custom analytics support: Generate a ready-to-connect analytics integration script from the Settings Window
• Eight lifecycle events: Soft Prompt shown, Soft Prompt action, native permission requested, native permission result, reminder scheduled, reminder cancelled, reminder due, and notification opened
• Structured event data: Receive event names and read-only parameter collections through the custom analytics handler
• Data control: Analytics are sent only to the provider selected by the developer
• Payload privacy: Custom Payload content is not included in built-in analytics parameters
• No LizardHouse telemetry: The asset does not require or send data to a LizardHouse analytics service

🛠️ Unity Editor Workflow

• Dedicated Settings Window: Configure platforms, permissions, prompts, reminders, Quiet Hours, localization, analytics, images, keys, and payloads in one place
• Reorderable journeys: Organize Soft Prompt follow-ups and reminder sequences visually
• Configuration summaries: Review important timing and behavior without expanding every item
• Setup validation: Check dependencies, required content, integrations, prefabs, icons, conditions, and notification configuration before saving
• Safe configuration: Invalid setups are prevented from replacing the last valid saved configuration
• Generated integrations: Create custom localization and analytics registration scripts directly from the Window
• Automatic preparation: Save Settings prepares notification images, Android icon resources, integration data, and runtime settings
• Automatic initialization: No notification manager needs to be added manually to a startup scene
• Optional dependency isolation: Unity Localization and Firebase Analytics are not required by the core runtime

🎮 Testing

• Editor Soft Prompt preview: Open and interact with the configured Soft Prompt prefab directly in Unity
• Custom Event simulation: Test engagement-event integration from the included demo
• Configuration status: Inspect the selected permission strategy and current notification state
• Device test controls: Test native permission, in-game notification controls, OS Settings, state changes, notification opens, keys, and payloads
• Isolated test reset: Restart the LizardHouse notification lifecycle without clearing the game’s own save data

📦 Package Contents

• Full C# source code
• Runtime notification system
• Settings and Setup Validation Window
• Demo scene for Editor and device testing
• Soft Prompt example prefabs
• Custom localization integration generator
• Custom analytics integration generator
• Offline documentation
• Complete online documentation

⚙️ Platforms and Requirements

• Supported platforms: Android and iOS
• Required package: Unity Mobile Notifications 2.3.0 or newer
• Required UI package: Unity UI (uGUI)
• Optional integration: Unity Localization
• Optional integration: Firebase Analytics
• Architecture: The core permission and local scheduling workflow runs on the player’s device without a LizardHouse backend, account, or MAU fee
• Native testing: Operating system permission and notification behavior is tested through an Android or iOS build

📚 Documentation, Setup, Integrations, and Support

Open the LizardHouse Notifications documentation

🔔 Turn notification permission into a player-return strategy.

LizardHouse Notifications: Permission and Re-Engagement helps Unity developers ask for notification access at the right moment, bring players back with relevant local reminders, and understand the complete journey from first prompt to notification open.

Instead of building permission logic, reminder scheduling, player-return cleanup, notification routing, localization, and analytics separately, you get one connected workflow for Android and iOS.

You define the strategy and content. LizardHouse handles the lifecycle.

🎯 Ask when players understand the value

The native permission prompt gives you a limited opportunity. Make that opportunity count by asking after the player has experienced enough of your game to understand why reminders could be useful.

• Choose between the native permission prompt and your own branded Soft Prompt prefab
• Show the first prompt at app start, at a moment chosen by your game, or after meaningful engagement
• Use cumulative Active App Time, developer-defined Custom Events, or both
• Connect any meaningful action, such as completing a level, puzzle, round, tutorial, or reward
• Continue after Not Now with multiple Soft Prompts
• Give every follow-up its own design, message, delay, and engagement conditions

You can build a thoughtful permission journey without locking your game into a fixed prompt design or asking every player at the same arbitrary moment.

⏰ Create a complete re-engagement sequence

Schedule one reminder after a few hours or build a full journey that continues across days, weeks, or months.

Every reminder can have its own:

• Delay
• Title and message
• Notification image
• Localization
• Quiet Hours behavior
• One Time Only rule
• Notification Key
• Custom Payload

Reminders are scheduled automatically around player inactivity, giving your game more opportunities to bring players back without requiring a campaign server.

No notification backend. No dashboard account. No MAU fees. No internet connection required for the local re-engagement flow.

🌙 Stay relevant and respect the player

A reminder loses its value when it arrives after the player has already returned.

LizardHouse automatically removes reminders from the previous inactivity cycle when the player comes back, then creates a fresh schedule the next time they leave.

It also cancels only the notifications it owns, allowing it to work alongside other notification systems in the same project.

Use three per-notification Quiet Hours policies to decide whether a reminder should:

• Move to the end of Quiet Hours
• Be allowed during Quiet Hours
• Pause its delay while Quiet Hours are active

This gives each message the timing policy it deserves instead of treating every reminder the same.

📲 Turn notification opens into useful actions

Know which reminder brought the player back and decide what should happen next.

The notification open callback provides the optional Notification Key and Custom Payload attached to that reminder. Use them to:

• Open relevant content
• Continue a challenge
• Highlight an event
• Present a reward
• Navigate to a specific screen
• Connect the return to your own game systems

Notification opens are handled during both warm and cold starts, with duplicate-open protection built in.

You can also keep an in-game notification toggle synchronized with the player’s effective permission state and provide direct access to the operating system’s notification settings when needed.

📊 Measure the complete journey

See where players accept, decline, return, or drop out through a consistent eight-event analytics funnel covering:

• Soft Prompt presentation and response
• Native permission request and result
• Reminder scheduling and cancellation
• Reminder due time
• Notification opens

Choose Firebase Analytics, connect your own analytics system through a generated integration script, or use the asset without analytics.

The data stays in the analytics platform you choose. LizardHouse does not require an external account or send your notification analytics to its own servers.

🌍 Fit every reminder to your game

Reach players with content that belongs naturally inside your product.

• Use no localization provider, Unity Localization, or your own localization system
• Generate a ready-to-connect script for custom localization
• Add a different image to each reminder
• Configure a custom Android status-bar icon
• Set the player-visible Android notification channel name and description
• Use your own Soft Prompt prefabs, copy, animation, and visual style

LizardHouse provides the system without forcing its own branding, language, analytics platform, or prompt design into your game.

🛠️ Built to save development time

Configure the permission journey, notification sequence, Quiet Hours, localization, analytics, notification keys, and payloads from one dedicated Unity Window.

The asset initializes automatically, keeps its state across scenes and app restarts, and validates the setup before saving. A focused public API keeps custom integration small.

🎮 Test the experience before shipping

The included demo scene lets you:

• Preview your real Soft Prompt directly in the Unity Editor
• Simulate Custom Events
• Inspect the current permission strategy
• Test native permission and notification settings in a device build
• Verify notification opens, keys, payloads, and state changes

📚 Documentation, setup guides, integrations, and support

LizardHouse Notifications Documentation

Your game worked hard to earn the install. Give it a smarter way to earn the next session.