In diesem Leitfaden wird beschrieben, wie Sie In-App-Rezensionen in Ihre App mit Kotlin oder Java einbinden. Für nativen Code, Unity oder die Unreal Engine 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 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 das Symbol ReviewManager
können Sie in Ihrer App einen In-App-Überprüfungsvorgang starten. Sie können sie mit dem Befehl ReviewManagerFactory
erstellen.
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 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 Instanz ReviewManager
eine Anfrageaufgabe. 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(); } });
In-App-Überprüfung starten
Verwenden Sie die Instanz ReviewInfo
, um den In-App-Überprüfungsvorgang zu starten. Warten Sie, bis der Nutzer den In-App-Überprüfungsvorgang abgeschlossen hat, bevor Ihre App mit dem normalen Nutzerfluss fortfährt (z. B. mit dem Wechsel zum nächsten Level).
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-Überprüfungsablauf Ihrer App, um zu prüfen, ob Ihre Integration ordnungsgemäß funktioniert.