In-App-Rezensionen einbinden (Unity)

In diesem Leitfaden wird beschrieben, wie Sie In-App-Rezensionen mit Unity in Ihre App einbinden. Für die Verwendung von Kotlin oder Java, nativem Code oder der Unreal Engine 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-Registrierung 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 „Paketmanager“ 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ü „Package Manager“, indem Sie die Unity-Menüoption Window > Package Manager (Fenster > Paketmanager) auswählen.

  4. Wählen Sie im Drop-down-Menü für den Verwaltungsbereich Meine Repositories 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. Importieren Sie die Datei .unitypackage. Wählen Sie dazu die Unity-Menüoption Assets > Import Package > Custom Package aus und importieren Sie alle Elemente.

ReviewManager erstellen

Erstellen Sie eine Instanz von ReviewManager, die die Kommunikation zwischen Ihrer App und der Google Play 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 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 benötigt, um den In-App-Überprüfungsvorgang zu starten. Im Beispiel wird der Aufruf innerhalb 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 Ihre Integration ordnungsgemäß funktioniert.