In-App-Rezensionen einbinden (Kotlin oder Java)

In dieser Anleitung wird beschrieben, wie Sie die Funktion für In-App-Rezensionen in Ihre App einbinden. Sie können dazu Kotlin oder Java verwenden. Wenn Sie nativen Code, Unity oder Unreal Engine verwenden, finden Sie separate Anleitungen zur Einbindung.

Entwicklungsumgebung einrichten

Die Play In-App Review Library ist Teil der Google Play Core-Bibliotheken. Fügen Sie die folgende Gradle-Abhängigkeit ein, 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

Der ReviewManager ist die Schnittstelle, mit der Ihre App einen In-App Rezensionsablauf starten kann. Sie erhalten ihn, indem Sie mit dem ReviewManagerFactory eine Instanz erstellen.

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

ReviewInfo-Objekt anfordern

Folgen Sie der Anleitung zum Anfordern von In-App-Rezensionen, um geeignete Punkte im Nutzerablauf Ihrer App zu finden, an denen Sie den Nutzer um eine Rezension bitten können (z. B. wenn der Nutzer ein Level in einem Spiel abgeschlossen hat). Wenn Ihre App einen dieser Punkte erreicht, erstellen Sie mit der ReviewManager-Instanz eine Anforderungsaufgabe. Bei Erfolg gibt die API das ReviewInfo Objekt zurück, das zum Starten des In-App-Rezensionsablaufs 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-Rezensionsablauf starten

Starten Sie mit der ReviewInfo-Instanz den In-App-Rezensionsablauf. Warten Sie, bis der Nutzer den In-App-Rezensionsablauf abgeschlossen hat, bevor Ihre App mit dem normalen Nutzerablauf fortfährt (z. B. zum nächsten Level übergeht).

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 Einbindung ordnungsgemäß funktioniert.