Request App Review

PDF for offline use
Related Samples:

Let us know how you feel about this

Translation Quality


0/250

last updated: 2017-03

This article covers the RequestReview method that Apple added to iOS 10 and how to implement it in Xamarin.iOS.

Overview

New to iOS 10.3, the RequestReview() method allows an iOS app to ask the user to rate or review it. When this method is called in a shipping app that the user has installed from the App Store, iOS 10 will handle the entire rating and review process for the developer. Because this process is governed by App Store policy, an alert may or may not be displayed.

Requesting a Rating or Review

While the RequestReview() static method of the SKStoreReviewController class can be called at any point where it makes sense in the user experience, the review process is governed and handled by App Store policy. As a result, this method may or may not display an alert and should never be called in response to a user action, such as tapping a button.

For example, an app might request a review after it has been launched a given number of times or a game might request a review after the player finishes a level.

To requests a review as soon as an Xamarin.iOS app finishes launching, make the following changes to the AppDelegate.cs file:

using Foundation;
using StoreKit;
using UIKit;

namespace iOSTenThree
{
    [Register ("AppDelegate")]
    public class AppDelegate : UIApplicationDelegate
    {
        ...

        public override bool FinishedLaunching (UIApplication application, NSDictionary launchOptions)
        {
            // Request a review from the user
            SKStoreReviewController.RequestReview ();

            return true;
        }

        ...

    }
}
ℹ️

NOTE: Calling RequestReview() in an under-development app will always display the rating and review dialog so it can be tested. This does not apply to apps that have been distributed through TestFlight, where the method call will be ignored.

When the RequestReview() method is called in a shipping app that the user has installed from the App Store, iOS 10 will handle the entire rating and review process for the developer. Again, because this process is governed by App Store policy, an alert may or may not be displayed.

Linking to an App Store Product Page

In addition to the new RequestReview method, the developer can still provide a deep link to the app's product page in the App Store from within an app. By appending action=write-review to the end of the product page URL, a page will be opened where the user can write a review of the app automatically.

Summary

This article has covered the RequestReview method that Apple added to iOS 10 and how to implement it in Xamarin.iOS.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.