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

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

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

ReviewInfo-Objekt anfordern

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

Kotlin

val request = manager.requestReviewFlow()
request.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // 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()) {
        // 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 die In-App-Rezension zu starten. Warte, bis der Nutzer den In-App-Überprüfungsablauf abgeschlossen hat, bevor deine App mit dem normalen Nutzerablauf fortfährt (z. B. zum nächsten Level wechselt).

Kotlin

val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
    // The flow has finished. The API doesn't indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, continue your app flow.
}

Java

Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
    // The flow has finished. The API doesn't indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, continue your 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.