इन-ऐप्लिकेशन समीक्षाओं को इंटिग्रेट करना (Unity)

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

Unity SDK टूल के बारे में खास जानकारी

Play In-App Review API, Play Core SDK टूल फ़ैमिली का हिस्सा है. Unity के लिए एपीआई, RequestReviewFlow और LaunchReviewFlow तरीकों का इस्तेमाल करके, फ़्लो का अनुरोध करने और उसे लॉन्च करने के लिए ReviewManager क्लास उपलब्ध कराता है. अनुरोध करने के बाद, आपका ऐप्लिकेशन ReviewErrorCode का इस्तेमाल करके, अनुरोध की स्थिति देख सकता है.

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

openupm add com.google.play.review

ReviewManager बनाना

ReviewManager का एक इंस्टेंस बनाएं, जो आपके ऐप्लिकेशन और एपीआई के बीच कम्यूनिकेशन मैनेज करता है.

// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();

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

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

var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using requestFlowOperation.Error.ToString().
    yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();

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

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

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

var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using requestFlowOperation.Error.ToString().
    yield break;
}
// 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.

अगले चरण

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