In-App-Rezensionen einbinden (Unity)

In diesem Leitfaden wird beschrieben, wie Sie In-App-Rezensionen mit Unity in Ihre App einbinden. Für Kotlin oder Java oder nativen Code gibt es separate Integrationsanleitungen.

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 mithilfe der Methoden RequestReviewFlow und LaunchReviewFlow angefordert und gestartet werden kann. Nach einer Anfrage 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 dem Fenster „Package Manager“ als eingeschränkte Registry 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 Menü des Paketmanagers, indem Sie die Unity-Menüoption Fenster > Paketmanager auswählen.

  4. Wählen Sie im Drop-down-Menü „Verwaltungskonto“ die Option Meine Registrierungen aus.

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

Aus GitHub importieren

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

  2. Importiere die .unitypackage-Datei, indem du die Unity-Menüoption Assets > Import package > Custom Package auswählst und alle Elemente importierst.

ReviewManager erstellen

Erstelle eine Instanz von ReviewManager, die die Kommunikation zwischen deiner App und der API verwaltet.

// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();

ReviewInfo-Objekt anfordern

Folgen Sie der Anleitung unter Wann Sie In-App-Rezensionen anfordern sollten, um geeignete Stellen im Nutzerfluss Ihrer App zu ermitteln, an denen Sie Nutzer zu einer Rezension auffordern 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 benötigt, um den In-App-Überprüfungsvorgang zu starten. Im Beispiel wird der Aufruf in einer Coroutine ausgeführt, um den asynchronen Vorgang auszuführen. Dadurch wird der Haupt-Thread nicht blockiert. Da der Aufruf asynchron erfolgt, kann es einige Sekunden dauern. Daher sollte Ihre App den Aufruf starten, bevor sie den Punkt im Nutzerfluss erreicht, an dem Sie die In-App-Überprüfung anzeigen möchten.

In-App-Überprüfung starten

Nachdem Ihre App die Instanz PlayReviewInfo erhalten hat, kann der In-App-Überprüfungsvorgang gestartet werden. Das PlayReviewInfo-Objekt ist nur für eine begrenzte Zeit gültig. Ihre App sollte daher nicht zu lange warten, bevor ein Ablauf gestartet wird.

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

Testen Sie den In-App-Überprüfungsablauf Ihrer App, um zu prüfen, ob die Integration ordnungsgemäß funktioniert.