In-App-Rezensionen einbinden (Kotlin oder Java)

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

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-Rezensionsbibliothek zu integrieren.

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 ReviewManager können Sie in Ihrer App einen In-App-Überprüfungsvorgang starten. Erstellen Sie dazu eine Instanz mithilfe von ReviewManagerFactory.

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

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. wenn der Nutzer ein Level in einem Spiel abschließt). Wenn Ihre App einen dieser Punkte erreicht, verwenden Sie die ReviewManager-Instanz, um eine Anfrageaufgabe zu erstellen. Bei Erfolg gibt die API das ReviewInfo-Objekt zurück, das zum Starten des In-App-Überprüfungsvorgangs 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();
    }
});

Hinweis: Das ReviewInfo-Objekt ist nur für einen begrenzten Zeitraum gültig. Ihre App sollte ein ReviewInfo-Objekt im Voraus anfordern (Pre-Cache), aber erst, wenn Sie sicher sind, dass Ihre App den In-App-Überprüfungsvorgang startet.

In-App-Überprüfungsprozess starten

Verwenden Sie die Instanz ReviewInfo, um den In-App-Überprüfungsvorgang zu starten. Warte, bis der Nutzer den In-App-Überprüfungsvorgang abgeschlossen hat, bevor deine App den normalen Nutzerfluss fortsetzt und z. B. zur nächsten Ebene gelangt.

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.
});

Wichtig: Wenn während des In-App-Überprüfungsvorgangs ein Fehler auftritt, informieren Sie den Nutzer nicht und ändern Sie den normalen Nutzerfluss Ihrer App nicht. Fahren Sie nach dem Aufruf von onComplete mit dem normalen Nutzerfluss der App fort.

Nächste Schritte

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