In-App-Rezensionen einbinden (Kotlin oder Java)

In diesem Leitfaden wird beschrieben, wie Sie In-App-Rezensionen mit Kotlin oder Java in Ihre App einbinden. Wenn Sie nativen Code, Unity oder Unreal Engine verwenden, finden Sie separate Integrationsleitfäden.

Entwicklungsumgebung einrichten

Die Play In-App Review Library ist Teil der Google Play Core-Bibliotheken. Fügen Sie die folgende Gradle-Abhängigkeit hinzu, um die Play In-App Review Library einzubinden.

Groovy

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:review:2.0.2'

    // For Kotlin users also add the Kotlin extensions library for Play In-App Review:
    implementation 'com.google.android.play:review-ktx:2.0.2'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:review:2.0.2")

    // For Kotlin users also import the Kotlin extensions library for Play In-App Review:
    implementation("com.google.android.play:review-ktx:2.0.2")
    ...
}

ReviewManager erstellen

Über die Schnittstelle ReviewManager kann deine App einen In-App-Rezensionsablauf starten. Sie erhalten sie, indem Sie eine Instanz mit ReviewManagerFactory erstellen.

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

ReviewInfo-Objekt anfordern

Folge den Hinweisen dazu, wann In-App-Rezensionen angefordert werden sollten, um geeignete Zeitpunkte im User-Flow deiner App zu finden, an denen du den Nutzer um eine Rezension bitten kannst (z. B. wenn der Nutzer ein Level in einem Spiel abgeschlossen hat). Wenn Ihre App einen dieser Punkte erreicht, verwenden Sie die ReviewManager-Instanz, um eine Anfrage zu erstellen. Bei erfolgreicher Ausführung gibt die API das ReviewInfo-Objekt zurück, das zum Starten des Ablaufs für In-App-Rezensionen erforderlich ist.

Kotlin

val request = manager.requestReviewFlow()
request.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // We got the ReviewInfo object
        val reviewInfo = task.result
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode val reviewErrorCode = (task.getException() as ReviewException).errorCode
    }
}

Java

ReviewManager manager = ReviewManagerFactory.create(this);
Task<ReviewInfo> request = manager.requestReviewFlow();
request.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // We can get the ReviewInfo object
        ReviewInfo reviewInfo = task.getResult();
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode int reviewErrorCode = ((ReviewException) task.getException()).getErrorCode();
    }
});

In-App-Überprüfung starten

Verwende die Instanz ReviewInfo, um den Ablauf für In-App-Rezensionen zu starten. Warte, bis der Nutzer den In-App-Rezensionsprozess abgeschlossen hat, bevor deine App mit dem normalen Nutzer-Flow fortfährt (z. B. zum nächsten Level wechselt).

Kotlin

val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
    // 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.
}

Java

Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
    // 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 die Integration ordnungsgemäß funktioniert.