Integracja opinii w aplikacji (kotlin lub Java)

Z tego przewodnika dowiesz się, jak zintegrować opinie w aplikacji za pomocą języka Kotlin lub Java. Jeśli używasz kodu natywnego, Unity lub Unreal Engine, dostępne są oddzielne przewodniki po integracji.

Konfigurowanie środowiska programistycznego

Biblioteka opinii w aplikacji w Google Play jest częścią podstawowych bibliotek Google Play. Aby zintegrować bibliotekę opinii w aplikacji w Google Play, dodaj to zależności Gradle.

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

Utwórz obiekt ReviewManager

ReviewManager to interfejs, który umożliwia aplikacji rozpoczęcie procesu oceny w aplikacji. Możesz go uzyskać, tworząc instancję za pomocą ReviewManagerFactory.

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

Obiekt Request a ReviewInfo

Postępuj zgodnie z wytycznymi dotyczącymi momentów, w których warto prosić o opinie w aplikacji, aby określić odpowiednie punkty w ścieżce użytkownika, w których można poprosić go o opinię (np. gdy użytkownik ukończy poziom w grze). Gdy aplikacja osiągnie jeden z tych punktów, użyj instancji ReviewManager, aby utworzyć zadanie żądania. Jeśli operacja się powiedzie, interfejs API zwróci obiekt ReviewInfo potrzebny do rozpoczęcia procesu oceniania w aplikacji.

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

Uruchamianie procesu sprawdzania w aplikacji

Użyj instancji ReviewInfo, aby uruchomić proces opinii w aplikacji. Zanim aplikacja przejdzie do normalnego trybu działania (np. do następnego poziomu), zaczekaj, aż użytkownik zakończy proces wystawiania opinii w aplikacji.

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

Dalsze kroki

Przetestuj przepływ opinii w aplikacji, aby sprawdzić, czy integracja działa prawidłowo.