UniRate is a Unity package to help you promote you mobile games by prompting users to rate the app after using it for a few days or times. Integrating UniRate to your project is deadly simple as a drag & drop, but it is powerful and configurable for some advanced usage. It will count the using of the times and days automatically and if the conditions you set are met, a native prompt will pop up and user can decide whether rate it or not.
This approach is one of the best ways to get positive app reviews by targeting only regular users (who presumably like the game or they wouldn't keep playing it).
You can purchase UniRate from this link of Unity Asset Store and use it in all your projects with the purchase Unity ID.
It is very easy to integrate and use the basic feature of UniRate in your project.
- Download and import the Unity package of
UniRateinto your project. - Find and drag the prefab named
UniRateManagerwhich located inUniRatefolder, to the first scene of your project. - And there is no step 3.
UniRate typically requires no configuration at all and will simply run automatically, using the information of application(bundle ID in iOS or package name in Android) and look app ID and versions up on Internet.
By default, UniRate will prompt your users when they opened your app more than 10 times AND installed at lease 3 days ago. You can change these settings as you like. UniRate provides an easy way to configure them in Unity Editor's Inspector Panel. You can tweak UniRate and change these prompt conditions to satisfy your demand.
The properties you may want to modify are listed below:
This is the minimum number of times the user must launch the app before they are prompted to rate it. This avoids the scenario where a user runs the app once, doesn't look at it for weeks and then launches it again, only to be immediately prompted to rate it. The minimum use count ensures that only frequent users are prompted. The prompt will appear only after the specified number of days AND uses has been reached. This defaults to 10 uses.
For some apps, launches are not a good metric for usage. For example the user can't write an informed review until they've reached a particular level or finished the tutorial. In this case you can manually log significant events and have the prompt appear after a predetermined number of these events by calling UniRate.Instance.LogEvent(true) from anywhere. Like the Uses Until Prompt setting, the prompt will appear only after the specified number of days AND events, however once the day threshold is reached, the prompt will appear if BOTH the event threshold AND uses threshold is reached. This defaults to 0 events, which meas there is no require for an event.
This is the number of days the user must have had the app installed before they are prompted to rate it. The time is measured from the first time THIS version of app is launched. This is a floating point value, so it can be used to specify a fractional number of days (e.g. 0.5). The default value is 3 days.
If you are less concerned with the total number of times the app is used, but would prefer to use the frequency of times the app is used, you can use the usesPerWeekForPrompt property to set a minimum threshold for the number of times the user must launch the app per week (on average) for the prompt to be shown. Note that this is the average since the app was installed, so if the user goes for a long period without running the app, it may throw off the average. The default value is 0.
How long the app should wait before reminding a user to rate after they select the "remind me later" option. A value of zero means the app will remind the user next launch. The default value is 1 day.
By default, UniRate will prompt users by pop up a system dialog window with three buttons (UIAlertView in iOS and AlertDialog in Android). Users can choose to "Rate", "Remind" or "Cancel". You can customize the prompt title and message in the Inspector Panel. There are also customizable button text for you.
The title displayed for the rating prompt. If this value is not set or is an empty string, a default value will be used for display. Default message title is "Rate {applicationName}".
The message body you set and be displayed in prompt pop-up. If this value is not set or is an empty string, a default value will be used for display. Default value is "If you enjoy {applicationName}, would you mind taking a moment to rate it? It will not take more than a minute. Thanks for your support!".
The button label for the button to dismiss the rating prompt without rating the app. If this value is not set or is an empty string, a default value will be used for display. Default value is "No, Thanks".
The button label for the button the user presses if they don't want to rate the app immediately, but do want to be reminded about it in future. If this value is not set or is an empty string, a default value will be used for display. Default value is "Remind Me Later".
The button label for the button the user presses if they do want to rate the app. If this value is not set or is an empty string, a default value will be used for display. Default value is "Rate It Now".
UniRate has a set of delegate methods and will raise the corresponding event at proper time. You can control the action of UniRate by implementing methods in your own code to handle these delegates and events.
UniRate asks if it should pop a prompt when it wants to show a prompt, before it is going to do so. By default, UniRate will check the conditions and pop up a prompt if all conditions are met. But it is not a good idea to prompt your users in some situation. For example, it make no sense to show a prompt when they are in your game progress. When it is not a proper time to pop up prompt, you should return false here and remember a shouldPrompt flag, then call UniRate.Instance.PromptIfNetworkAvailable() later. If it is not implemented, UniRate will always show prompt.
UniRate asks if it should open the rate page when user clicked the Rate button. Return false if you want to implement your own ratings page display logic. Else the AppStore or Android Market page of your app will be opened. If it is not implemented, UniRate will always open the rate page.
This method is called immediately before the rating prompt is displayed. This is useful if you use analytics to track what percentage of users see the prompt and then go to rate for your app. And it is also a change for you to use your customized view intead of system alert view/dialog. See Advanced Usage's Customize Prompt section for more about showing customized prompt.
This method is called when a new version of the app is installed and opened for the first time. All count (used count, days count, etc) was reseted.
This method is called when there is an error during getting app info from Internet. A UniRate.Error will be sent with this method. The error could be one of these: BundleIdDoesNotMatchAppStore, AppNotFoundOnAppStore, NotTheLatestVersion, NetworkError. You can choose to show a UI to tell your users what gets wrong, you can also choose to let it fail silently. How to treat these errors depends on you.
This method is called when the user pressed the rate button in the rating prompt.
This method is called when the user pressed the cancel button in the rating prompt.
This method is called when the user pressed the remind button and asked to be reminded to rate the app in the rating prompt.
The basic usage of UniRate is clear and easy. You can also try some advanced usage of UniRate if you want. I list some frequently usage below.
Sometimes you may not want the system alert view/dialog for prompting because you prefer a better look for your game. You can use a customized prompt view (a well-designed UI produced by your designer for example) instead.
First, you need to switch the Use Customized Prompt View to true in the Inspector Panel of your Unity Editor. It will prevent UniRate to pop up a system prompt view. Then you can implement a listener to the OnPromptedForRating event and write your code to pop up your own prompt view there. You can choose any tool you like for showing the prompt UI (Unity's GUI, NGUI or anything else). When the user interact your customised UI, you can send the corresponding method to UniRate to handle the input result. In detail, you could call UniRate.Instance.SendMessage("UniRateUserWantToRate");, UniRate.Instance.SendMessage("UniRateUserDeclinedPrompt"); or UniRate.Instance.SendMessage("UniRateUserWantRemind");. When UniRate receives these message, it will continue the standard flow and open rate page or setup a remind for you.
By default, UniRate dose not require any setting of app id and rating url. It can get all needed information from app's bundle and AppStore. If you require a different rating url beside AppStore or Google Play market, you can specify it in the Rating iOS URL and Rating Android URL. It is also useful if you want to log some user interaction with UniRate.
There is a setting for App ID (iOS) and package name (Android), but in most cases, you have not to set it yourself. Only when you have your own reasons to lead your users to a different page or you are sure about your app id, you will set it yourself. UniRate will use the App ID and package name to determine the rating url (if the rating url is not set).
Although UniRate will prompt automatically, you may also want a "Rate me" button in your UI and users can use that button to rate your app if they can not wait to say great to you. If you just open a url when tapping the button, UniRate will not know user is already rated, so it might prompt user to rate again. It is not so good. So if you want to make your own "Rate me" button, you'd better to call UniRate method to pop up prompt and rating page. Try to call UniRate.Instance.PromptIfNetworkAvailable() to get app's information and show a prompt and let user to rate. You can also use UniRate.Instance.ShowPrompt() to prompt without an Internet check, but it depend on the AppID in iOS. If you do not set the AppID, DO NOT use ShowPrompt directly.
If you tick the Preview Mode on, UniRate will prompt every time it checks the conditions. It is useful when you are developing the appearance of prompt. Please remember to turn it off when you release your game, or maybe you will get thousands of 1 star. :(
By default, UniRate will not log the most important events. If you are wondering what is happened and eager more control, you can turn on the debug logs by adding a UniRateDebug symbol in Scripting Define Symbols setion in Player Settings in Unity. It is recommanded to remove it when your game release.
There is a demo file in the DemoScene folder, in which shows the basic usage of UniRate. UniRateGUIScript shows some information UniRate got, including all conditions. You can also feel free to click the button to see how to use public methods. UniRateEventHandler implements all events, which would be a guide for advanced use of UniRate.
You can find the script reference here. There is also a support forum for you to ask anything about UniRate. You can also submit an issue if you are sure something goes wrong. Once confirmed, I will fix them as soon as possible. Hope UniRate can help you and you can use it happily!