In-App-Rezensionen einbinden (Unity)

In diesem Leitfaden wird beschrieben, wie Sie In-App-Rezensionen mithilfe von Unity in Ihre App einbinden. Es gibt separate Integrationsleitfäden für Kotlin oder Java, nativen Code und Unreal Engine.

Unity SDK – Übersicht

Die Play In-App Review API gehört zur 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 Ihre App den Status der Anfrage mit ReviewErrorCode prüfen.

Entwicklungsumgebung einrichten

OpenUPM-CLI

Wenn Sie die OpenUPM-Befehlszeile installiert haben, können Sie die OpenUPM-Registry mit dem folgenden Befehl installieren:

openupm add com.google.play.review

OpenUPM

  1. Öffnen Sie die Einstellungen des Paketmanagers, indem Sie die Unity-Menüoption Bearbeiten > Projekteinstellungen > Paketmanager auswählen.

  2. Fügen Sie OpenUPM als bereichsbezogene Registry im Fenster „Package Manager“ 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

  3. Öffnen Sie das Paketmanager-Menü, indem Sie die Unity-Menüoption Window > Package Manager auswählen.

  4. Wählen Sie im Drop-down-Menü für den Managerbereich Meine Registries aus.

  5. Wählen Sie das Paket Google Play Integrity-Plug-in für Unity aus der Paketliste aus und klicken Sie auf Installieren.

Aus GitHub importieren

  1. Laden Sie die neueste .unitypackage-Version von GitHub herunter.

  2. Importieren Sie die Datei .unitypackage, indem Sie die Unity-Menüoption Assets > Import package > Custom Package auswählen und alle Elemente importieren.

ReviewManager erstellen

Erstelle eine Instanz von ReviewManager, die die Kommunikation zwischen deiner 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 unter Wann In-App-Rezensionen angefordert werden sollten, um geeignete Stellen im User-Flow Ihrer App zu finden, an denen Sie den Nutzer um eine Rezension bitten können (z. B. nachdem ein Nutzer den Zusammenfassungsbildschirm am Ende eines Levels in einem Spiel geschlossen hat). Wenn Ihre Anwendung einen dieser Punkte erreicht, 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 benötigt, um den Ablauf für In-App-Rezensionen zu starten. Im Beispiel wird der Aufruf innerhalb einer Koroutine ausgeführt, um den asynchronen Vorgang auszuführen. Dadurch wird der Hauptthread nicht blockiert. Da der Aufruf asynchron erfolgt, kann es bis zu ein paar Sekunden dauern. Ihre App sollte den Aufruf also ausführen, bevor sie den Punkt im User-Flow erreicht, an dem die In-App-Rezension angezeigt werden soll.

In-App-Überprüfung starten

Nachdem deine App die PlayReviewInfo-Instanz erhalten hat, kann sie den In-App-Rezensionsablauf starten. Das PlayReviewInfo-Objekt ist nur für eine begrenzte Zeit gültig. Ihre App sollte daher 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 Ablauf für In-App-Rezensionen in Ihrer App, um zu prüfen, ob die Integration ordnungsgemäß funktioniert.