ইন্টিগ্রেট ইন-অ্যাপ রিভিউ (ইউনিটি)

এই নির্দেশিকাটি বর্ণনা করে যে কীভাবে ইউনিটি ব্যবহার করে আপনার অ্যাপে অ্যাপ-মধ্যস্থ পর্যালোচনাগুলিকে একীভূত করতে হয়। আপনি যদি Kotlin বা Java বা নেটিভ কোড ব্যবহার করেন তার জন্য আলাদা ইন্টিগ্রেশন গাইড রয়েছে।

ইউনিটি SDK ওভারভিউ

প্লে ইন-অ্যাপ রিভিউ API হল Play Core SDK পরিবারের অংশ। RequestReviewFlow এবং LaunchReviewFlow পদ্ধতি ব্যবহার করে এপিআই ফর ইউনিটি একটি ReviewManager ক্লাসের প্রস্তাব দেয়। একটি অনুরোধ করার পরে, আপনার অ্যাপ ReviewErrorCode ব্যবহার করে অনুরোধের স্থিতি পরীক্ষা করতে পারে।

আপনার উন্নয়ন পরিবেশ সেট আপ করুন

OpenUPM-CLI

আপনার যদি OpenUPM CLI ইনস্টল করা থাকে তবে আপনি নিম্নলিখিত কমান্ডের সাহায্যে OpenUPM রেজিস্ট্রি ইনস্টল করতে পারেন:

openupm add com.google.play.review

OpenUPM

  1. ইউনিটি মেনু বিকল্পটি সম্পাদনা > প্রকল্প সেটিংস > প্যাকেজ ম্যানেজার নির্বাচন করে প্যাকেজ ম্যানেজার সেটিংস খুলুন।

  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. ইউনিটি মেনু বিকল্প উইন্ডো > প্যাকেজ ম্যানেজার নির্বাচন করে প্যাকেজ ম্যানেজার মেনু খুলুন।

  4. আমার রেজিস্ট্রি নির্বাচন করতে ম্যানেজার স্কোপ ড্রপ-ডাউন সেট করুন।

  5. প্যাকেজ তালিকা থেকে ইউনিটি প্যাকেজের জন্য Google Play Integrity প্লাগইনটি নির্বাচন করুন এবং Install টিপুন।

GitHub থেকে আমদানি করুন

  1. GitHub থেকে সর্বশেষ .unitypackage রিলিজ ডাউনলোড করুন।

  2. ইউনিটি মেনু বিকল্প সম্পদ > আমদানি প্যাকেজ > কাস্টম প্যাকেজ নির্বাচন করে এবং সমস্ত আইটেম আমদানি করে .unitypackage ফাইলটি আমদানি করুন।

রিভিউ ম্যানেজার তৈরি করুন

ReviewManager এর একটি উদাহরণ তৈরি করুন যা আপনার অ্যাপ এবং API-এর মধ্যে যোগাযোগ পরিচালনা করে।

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

রিভিউ ইনফো অবজেক্টের জন্য অনুরোধ করুন

আপনার অ্যাপের ব্যবহারকারীর প্রবাহে ভাল পয়েন্ট নির্ধারণ করতে কখন অ্যাপ-মধ্যস্থ পর্যালোচনার অনুরোধ করতে হবে সে সম্পর্কে নির্দেশিকা অনুসরণ করুন যাতে ব্যবহারকারীকে পর্যালোচনার জন্য অনুরোধ জানানো হয় (উদাহরণস্বরূপ, কোনও ব্যবহারকারী একটি গেমের একটি স্তরের শেষে সারাংশ স্ক্রীন খারিজ করার পরে)। যখন আপনার অ্যাপ এই পয়েন্টগুলির একটির কাছাকাছি চলে যায়, তখন একটি অ্যাসিঙ্ক অপারেশন তৈরি করতে 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 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.

পরবর্তী পদক্ষেপ

আপনার ইন্টিগ্রেশন সঠিকভাবে কাজ করছে কিনা তা যাচাই করতে আপনার অ্যাপের ইন-অ্যাপ পর্যালোচনা প্রবাহ পরীক্ষা করুন