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

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

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

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

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

OpenUPM-CLI

अगर आपके पास OpenUPM CLI इंस्टॉल है, तो इस कमांड का इस्तेमाल करके OpenUPM रजिस्ट्री इंस्टॉल की जा सकती है:

openupm add com.google.play.review

OpenUPM

1. पैकेज मैनेजर की सेटिंग खोलें. इसके लिए, Unity मेन्यू का विकल्प बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर चुनें.

2. पैकेज मैनेजर विंडो में, OpenUPM को ऐसी रजिस्ट्री के तौर पर जोड़ें जो उसके स्कोप में हो:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
     com.google.play.common
     com.google.play.core
     com.google.play.review
   

3. पैकेज मैनेजर मेन्यू खोलने के लिए, Unity मेन्यू का विकल्प Window > Package Manager चुनें.

4. मैनेजर स्कोप ड्रॉप-डाउन को सेट करके, मेरी रजिस्ट्री चुनें.

5. पैकेज की सूची से, Unity के लिए Google Play Integrity प्लगिन पैकेज चुनें और इंस्टॉल करें दबाएं.

GitHub से इंपोर्ट करें

1. GitHub से .unitypackage का सबसे नया वर्शन डाउनलोड करें.

2. .unitypackage फ़ाइल को इंपोर्ट करने के लिए, Unity मेन्यू का विकल्प चुनें ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज और सभी आइटम इंपोर्ट करें.

ध्यान दें: Google Play Unity प्लगिन डाउनलोड और इस्तेमाल करने का मतलब है कि आपने Play Core सॉफ़्टवेयर डेवलपमेंट किट की सेवा की शर्तों को स्वीकार कर लिया है.

ReviewManager बनाना

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

using Google.Play.Review;

// 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 ऑब्जेक्ट दिखाता है. आपके ऐप्लिकेशन को इन-ऐप्लिकेशन समीक्षा फ़्लो लॉन्च करने के लिए, इस ऑब्जेक्ट की ज़रूरत होती है. उदाहरण में, एसिंक्रोनस ऑपरेशन को पूरा करने के लिए, कोरूटीन के अंदर कॉल किया जाता है. इससे मुख्य थ्रेड ब्लॉक नहीं होता. कॉल को एसिंक्रोनस तरीके से किया जाता है. इसलिए, इसमें कुछ सेकंड लग सकते हैं. इस वजह से, आपके ऐप्लिकेशन को कॉल तब करना चाहिए, जब उपयोगकर्ता आपके ऐप्लिकेशन के उस फ़्लो तक न पहुंचा हो जहां आपको इन-ऐप्लिकेशन समीक्षा दिखानी है.

ऐप्लिकेशन में समीक्षा करने की सुविधा लॉन्च करना

आपके ऐप्लिकेशन को 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 launchFlowOperation.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.

अगले चरण

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