In diesem Leitfaden wird beschrieben, wie Sie In-App-Rezensionen mithilfe von Unity in Ihre App einbinden. Es gibt separate Integrationsanleitungen für die Verwendung von Kotlin oder Java, nativem Code oder der Unreal Engine.
Unity SDK – Übersicht
Die Play In-App Review API ist Teil der Play Core SDK-Familie. Die API für Unity bietet die Klasse ReviewManager, mit der der Ablauf über die Methoden RequestReviewFlow und LaunchReviewFlow angefordert und gestartet werden kann. Nachdem eine Anfrage gestellt wurde, kann Ihre App den Status der Anfrage mit ReviewErrorCode prüfen.
Entwicklungsumgebung einrichten
OpenUPM-CLI
Wenn Sie die OpenUPM-CLI installiert haben, können Sie die OpenUPM-Registrierung mit dem folgenden Befehl installieren:
openupm add com.google.play.reviewOpenUPM
Öffnen Sie die Paketmanager-Einstellungen, indem Sie im Unity-Menü Bearbeiten > Projekteinstellungen > Paketmanager auswählen.
Fügen Sie OpenUPM als Bereichsregistrierung zum Paketmanager-Fenster hinzu:
Name: package.openupm.com URL: https://package.openupm.com Scopes: com.google.external-dependency-manager com.google.play.common com.google.play.core com.google.play.reviewÖffnen Sie das Paketmanager-Menü, indem Sie im Unity-Menü Window > Package Manager auswählen.
Wählen Sie im Drop-down-Menü für den Verwaltungskontobereich Meine Registrierungen aus.
Wählen Sie das Paket Google Play Integrity plugin for Unity aus der Paketliste aus und klicken Sie auf Install (Installieren).
Aus GitHub importieren
Laden Sie die aktuelle Version von
.unitypackagevon GitHub herunter.Importieren Sie die
.unitypackage-Datei, indem Sie im Unity-Menü Assets > Import Package > Custom Package auswählen und alle Elemente importieren.
ReviewManager erstellen
Erstellen Sie eine Instanz von ReviewManager, die die Kommunikation zwischen Ihrer App und der Google Play API übernimmt.
using Google.Play.Review;
// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();
ReviewInfo-Objekt anfordern
Folgen Sie der Anleitung dazu, wann In-App-Rezensionen angefordert werden sollten, um geeignete Stellen im Nutzerfluss Ihrer App zu finden, an denen Sie Nutzer um eine Rezension bitten können (z. B. nachdem ein Nutzer den Zusammenfassungsbildschirm am Ende eines Levels in einem Spiel geschlossen hat). Wenn sich Ihre App einem dieser Punkte nähert, verwenden Sie die ReviewManager-Instanz, um einen asynchronen Vorgang zu erstellen, wie im folgenden Beispiel gezeigt:
var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using requestFlowOperation.Error.ToString().
yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();
Wenn der Aufruf erfolgreich ist, gibt die API das PlayReviewInfo-Objekt zurück, das Ihre App zum Starten des Ablaufs für In-App-Rezensionen benötigt. Im Beispiel erfolgt der Aufruf in einer Coroutine, um den asynchronen Vorgang auszuführen (dadurch wird der Haupt-Thread nicht blockiert). Da der Aufruf asynchron erfolgt, kann es einige Sekunden dauern. Ihre App sollte den Aufruf also ausführen, bevor sie den Punkt im Nutzerfluss erreicht, an dem Sie die In-App-Rezension anzeigen möchten.
In-App-Rezensionsablauf starten
Nachdem Ihre App die PlayReviewInfo-Instanz erhalten hat, kann sie den In-App-Rezensionsablauf starten. Das PlayReviewInfo-Objekt ist nur für einen begrenzten Zeitraum gültig. Ihre App sollte also nicht zu lange warten, bevor sie einen Ablauf startet.
var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using launchFlowOperation.Error.ToString().
yield break;
}
// The flow has finished. The API does not indicate whether the user
// reviewed or not, or even whether the review dialog was shown. Thus, no
// matter the result, we continue our app flow.
Nächste Schritte
Testen Sie den In-App-Rezensionsablauf Ihrer App, um zu prüfen, ob Ihre Integration ordnungsgemäß funktioniert.