In diesem Leitfaden wird beschrieben, wie Sie mit Unity In-App-Rezensionen in Ihre App integrieren. Für die Verwendung von Kotlin oder Java oder nativem Code sind separate Einbindungsleitfäden verfügbar.
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, um den Ablauf mit den Methoden RequestReviewFlow und LaunchReviewFlow anzufordern und zu starten. Nachdem eine Anfrage gestellt wurde, kann die Anwendung den Status der Anfrage mit ReviewErrorCode prüfen.
Entwicklungsumgebung einrichten
Laden Sie die neueste Version des Play In-App Review Unity-Plug-ins aus den Google-Paketen für Unity herunter.
ReviewManager erstellen
Erstellen Sie eine Instanz von ReviewManager, die die Kommunikation zwischen der Anwendung und der API verwaltet.
// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();
„ReviewInfo“-Objekt anfordern
Folgen Sie der Anleitung zum Anfordern von In-App-Überprüfungen, um gute Punkte im Nutzerfluss Ihrer App zu ermitteln und Nutzer zur Überprüfung aufzufordern (z. B. nachdem ein Nutzer die Zusammenfassung am Ende eines Levels in einem Spiel geschlossen hat). Wenn die Anwendung einem dieser Punkte nahe kommt, 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 Objekt PlayReviewInfo zurück, das deine App zum Starten der In-App-Überprüfung benötigt. Im Beispiel wird der Aufruf innerhalb einer Coroutine ausgeführt, um den asynchronen Vorgang auszuführen. Dadurch wird der Hauptthread nicht blockiert. Da der Aufruf asynchron erfolgt, kann es einige Sekunden dauern. Daher sollte Ihre Anwendung den Aufruf ausführen, bevor sie im Nutzerfluss den Punkt erreicht, an dem die In-App-Rezension angezeigt werden soll.
In-App-Überprüfungsprozess starten
Nachdem Ihre App die PlayReviewInfo-Instanz erhalten hat, kann sie die In-App-Überprüfung starten. Beachten Sie, dass das PlayReviewInfo-Objekt nur für einen begrenzten Zeitraum gültig ist. Daher sollte Ihre Anwendung nicht zu lange mit dem Starten eines Ablaufs warten.
var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using requestFlowOperation.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
Teste den Ablauf der In-App-Überprüfung deiner App, um zu bestätigen, dass die Integration korrekt funktioniert.