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

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

Unity SDK ওভারভিউ

Play In-App Review API হল Play Core SDK ফ্যামিলির অংশ। Unity-র জন্য API RequestReviewFlow এবং LaunchReviewFlow পদ্ধতি ব্যবহার করে ফ্লোর অনুরোধ করতে এবং চালু করতে ReviewManager ক্লাস অফার করে। অনুরোধ করা হয়ে গেলে, আপনার অ্যাপ 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. Unity মেনু বিকল্প থেকে .unitypackage ফাইল ইমপোর্ট করুন অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ এবং সব আইটেম ইমপোর্ট করুন।

মনে রাখবেন: 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();

কল সফল হলে, API PlayReviewInfo অবজেক্ট ফিরিয়ে দেয় যা আপনার অ্যাপের ইন-অ্যাপ রিভিউ ফ্লো লঞ্চ করার জন্য প্রয়োজন। উদাহরণে, অ্যাসিঙ্ক অপারেশন (এটি মূল থ্রেড ব্লক করে না) পারফর্ম করার জন্য coroutine-এর মধ্যে কল করা হয়। কলটি অ্যাসিঙ্ক্রোনাসভাবে করা হয় বলে, এটি করতে কয়েক সেকেন্ড সময় লাগতে পারে, তাই আপনার অ্যাপের ব্যবহারকারী ফ্লোতে যে পয়েন্টে আপনি অ্যাপ-মধ্যস্থ রিভিউ দেখাতে চান, সেখানে পৌঁছানোর আগেই আপনার অ্যাপের কল করা উচিত।

অ্যাপ-মধ্যস্থ রিভিউ ফ্লো চালু করুন

আপনার অ্যাপ 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.

পরবর্তী ধাপ

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