ऐप्लिकेशन में की गई समीक्षाओं को इंटिग्रेट करना (Kotlin या Java)

इस गाइड में, Kotlin या Java का इस्तेमाल करके, अपने ऐप्लिकेशन में इन-ऐप्लिकेशन समीक्षाओं को इंटिग्रेट करने का तरीका बताया गया है. अगर नेटिव कोड या Unity का इस्तेमाल किया जा रहा है, तो इंटिग्रेशन के लिए अलग-अलग गाइड उपलब्ध हैं.

डेवलपमेंट एनवायरमेंट सेट अप करना

Play की इन-ऐप्लिकेशन समीक्षा लाइब्रेरी, Google Play की मुख्य लाइब्रेरी का हिस्सा है. Play की इन-ऐप्लिकेशन समीक्षा लाइब्रेरी को इंटिग्रेट करने के लिए, कृपया यहां दी गई 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")
    ...
}

ReviewManager बनाना

ReviewManager एक इंटरफ़ेस है, जिसकी मदद से आपके ऐप्लिकेशन में इन-ऐप्लिकेशन समीक्षा फ़्लो शुरू किया जा सकता है. ReviewManagerFactory का इस्तेमाल करके इंस्टेंस बनाकर, इसे पाएं.

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

ReviewInfo ऑब्जेक्ट का अनुरोध करना

ऐप्लिकेशन में समीक्षा का अनुरोध कब करना है के बारे में दिए गए दिशा-निर्देशों का पालन करें. इससे, आपको अपने ऐप्लिकेशन के उपयोगकर्ता फ़्लो में ऐसे पॉइंट तय करने में मदद मिलेगी जहां उपयोगकर्ता को समीक्षा करने के लिए कहा जा सकता है. उदाहरण के लिए, जब उपयोगकर्ता किसी गेम में कोई लेवल पूरा करता है. जब आपका ऐप्लिकेशन इनमें से किसी एक पॉइंट पर पहुंच जाए, तो अनुरोध टास्क बनाने के लिए, ReviewManager इंस्टेंस का इस्तेमाल करें. अगर समीक्षा पूरी हो जाती है, तो एपीआई, ऐप्लिकेशन में समीक्षा का फ़्लो शुरू करने के लिए ज़रूरी ReviewInfo ऑब्जेक्ट दिखाता है.

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

ध्यान दें: ReviewInfo ऑब्जेक्ट सिर्फ़ कुछ समय के लिए मान्य होता है. आपके ऐप्लिकेशन को पहले से ही ReviewInfo ऑब्जेक्ट का अनुरोध करना चाहिए (पहले से कैश मेमोरी में सेव करना). हालांकि, ऐसा तब ही करना चाहिए, जब आपको यह पक्का हो कि आपका ऐप्लिकेशन, इन-ऐप्लिकेशन समीक्षा फ़्लो लॉन्च करेगा.

इन-ऐप्लिकेशन समीक्षा फ़्लो लॉन्च करना

इन-ऐप्लिकेशन समीक्षा फ़्लो को लॉन्च करने के लिए, ReviewInfo उदाहरण का इस्तेमाल करें. ऐप्लिकेशन का सामान्य यूज़र फ़्लो जारी रखने से पहले, उपयोगकर्ता के ऐप्लिकेशन में समीक्षा का फ़्लो पूरा करने तक इंतज़ार करें. जैसे, अगले लेवल पर जाना.

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

अहम जानकारी: अगर ऐप्लिकेशन में समीक्षा करने के दौरान कोई गड़बड़ी होती है, तो उपयोगकर्ता को इसकी जानकारी न दें. इसके अलावा, अपने ऐप्लिकेशन के सामान्य उपयोगकर्ता फ़्लो में भी कोई बदलाव न करें. onComplete को कॉल करने के बाद, अपने ऐप्लिकेशन के सामान्य यूज़र फ़्लो को जारी रखें.

अगले चरण

अपने ऐप्लिकेशन के इन-ऐप्लिकेशन समीक्षा फ़्लो की जांच करें, ताकि यह पुष्टि की जा सके कि आपका इंटिग्रेशन सही तरीके से काम कर रहा है.