Very Simple Rating System

About Very Simple Rating System – Unity Editor Tool & Plugin

Very Simple Rating System Unity Asset Overview

The Very Simple Rating System package provides a lightweight, event-driven framework designed to prompt users for store ratings and in-app feedback at optimal engagement points. Architecturally, the system decouples trigger logic from platform-specific SDK implementations, allowing developers to execute rating flows on Android, iOS, and standalone platforms using a unified C# API surface.

At the C# source level, the framework utilizes an event-driven design pattern to minimize poll-based checking in the main thread loop. Rating logic relies on static event channels and C# System.Action delegates rather than heavy MonoBehaviour update loops. State parameters—such as session counts, level completion thresholds, and delay timers—are managed through decoupled ScriptableObject data containers, ensuring configuration logic remains detached from runtime UI elements.

Native Bridge Architecture & Fallbacks

The execution pipeline differentiates between native platform review APIs and fallback custom UI dialogs:

• iOS Platform Integration: Wraps SKStoreReviewController calls to invoke native system popups without forcing users out of the active application.
• Android Platform Integration: Interfaces with the native Google Play In-App Review API using Android Java Native Interface (JNI) wrappers.
• Fallback Custom UI: Provides a customizable UGUI/UI Toolkit modal dialog for desktop releases, custom app stores, or low-tier native API fallbacks when platform limits are reached.

Inspector Configuration & Workflow

The package integrates directly into the Unity Editor using custom property drawers and custom Inspector layouts. Configuration is centralized within a core ScriptableObject asset, preventing scene-level prefab clutter and simplifying cross-scene state retention.

Core Inspector Parameters

Developers configure triggering criteria directly within the inspector without editing code. The primary workflow involves setting up specific thresholds that must evaluate to true before a review request executes:

• Min Sessions Before Prompt: Integer value defining how many discrete application launches must occur before the trigger is eligible.
• Min Custom Events: Tracks progress milestones (e.g., levels completed, boss fights won) before prompting the user.
• Postpone Interval (Days): Dictates the mandatory cooldown duration if the user selects "Remind Me Later".
• Redirect Low Ratings: Boolean switch that routes ratings below a specified star threshold (e.g., 3 stars or fewer) to a custom internal feedback form rather than native store pages.

Quick-Start Unity Integration Guide

To integrate the system, place the manager prefab into your bootstrapping scene or access the static API from your existing game logic controllers. Persistence parameters are written to PlayerPrefs or encrypted persistent storage paths using standard binary or JSON serialization depending on project flags.

Implementation Code Example

The following example demonstrates how to initialize the rating manager, register event callbacks, and increment progress metrics upon completing a gameplay event:

using UnityEngine;
using VerySimpleRatingSystem;

public class GameProgressTracker : MonoBehaviour
{
    [SerializeField] private string levelCompletionEventKey = "LevelsCompleted";

    private void OnEnable()
    {
        // Subscribe to system callbacks
        RatingManager.OnRatingCompleted += HandleRatingFinished;
        RatingManager.OnRatingDismissed += HandleRatingDismissed;
    }

    private void OnDisable()
    {
        // Unsubscribe to maintain clean garbage collection references
        RatingManager.OnRatingCompleted -= HandleRatingFinished;
        RatingManager.OnRatingDismissed -= HandleRatingDismissed;
    }

    public void OnLevelComplete()
    {
        // Increment tracked event metric
        RatingManager.IncrementCustomEvent(levelCompletionEventKey);

        // Evaluate conditions and display prompt if criteria are met
        if (RatingManager.CanShowRatingPrompt())
        {
            RatingManager.ShowRatingDialog();
        }
    }

    private void HandleRatingFinished(RatingResult result)
    {
        Debug.Log($"[Rating System] User submitted score: {result.Score}");
    }

    private void HandleRatingDismissed()
    {
        Debug.Log("[Rating System] User deferred or dismissed the prompt.");
    }
}

Performance & Native Overhead Profile

The Very Simple Rating System maintains a near-zero runtime execution footprint, making it suitable for memory-constrained mobile projects or high-frame-rate titles.

• Zero Frame Allocations: The core logic executes entirely off event triggers. It generates 0 Bytes GC Alloc per frame during active gameplay.
• IL2CPP Build Size Impact: Minimal code footprint adds negligible executable size (less than 150 KB stripping overhead) when compiled under standard IL2CPP settings.
• JNI / Native Overhead: Native bridge bindings execute asynchronously via platform message queues, ensuring no main-thread stuttering during store popup initialization.
• Assembly Definition Files (Asmdef): Encapsulated within dedicated Assembly Definitions to speed up project compilation times and prevent unintended namespace bleeding.

Related Unity Tools Assets