In-App-Rezensionen einbinden (Kotlin oder Java)

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

Entwicklungsumgebung einrichten

Die Play In-App-Rezensionsbibliothek ist Teil der Google Play Core Libraries. Füge die folgende Gradle-Abhängigkeit ein, um die Play In-App-Rezensionsbibliothek einzubinden.

Cool

// 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.1'

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

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.1")

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

ReviewManager erstellen

ReviewManager ist die Oberfläche, über die deine App einen In-App-Überprüfungsvorgang starten kann. Sie rufen ihn ab, indem Sie mit ReviewManagerFactory eine Instanz erstellen.

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

ReviewInfo-Objekt anfordern

Folge der Anleitung zum Anfordern von In-App-Rezensionen, um geeignete Punkte im Nutzerfluss deiner App zu ermitteln und den Nutzer zu einer Überprüfung aufzufordern, z. B. wenn er ein Level in einem Spiel abschließt. Wenn die Anwendung einen dieser Punkte erreicht, verwenden Sie die Instanz ReviewManager, um eine Anfrageaufgabe zu erstellen. Bei Erfolg gibt die API das Objekt ReviewInfo 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 Objekt ReviewInfo ist nur für einen begrenzten Zeitraum gültig. Deine App sollte vorab ein ReviewInfo-Objekt anfordern (vorab im Cache speichern), aber erst dann, wenn du sicher bist, dass deine App den In-App-Überprüfungsvorgang startet.

In-App-Überprüfungsprozess starten

Verwende 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 :Tritt während der In-App-Überprüfung ein Fehler auf, informiere den Nutzer nicht und ändere nicht den normalen Nutzerfluss deiner App. Fahren Sie nach dem Aufruf von onComplete mit dem normalen Nutzerfluss der App fort.

Nächste Schritte

Teste den In-App-Überprüfungsvorgang deiner App, um zu prüfen, ob die Integration korrekt funktioniert.