دمج المراجعات داخل التطبيق (Unity)

يوضِّح هذا الدليل كيفية دمج المراجعات داخل التطبيق في تطبيقك باستخدام Unity. هناك أدلة تكامل منفصلة إذا كنت تستخدم Kotlin أو Java أو الرمز الأصلي.

نظرة عامة على حزمة تطوير البرامج (SDK) في Unity

إنّ واجهة برمجة التطبيقات Play In-App Review API هي جزء من Play Core. مجموعة حزم تطوير البرامج (SDK). واجهة برمجة التطبيقات يوفّر Unity حزمة ReviewManager. لطلب بدء المسار وإطلاقه باستخدام RequestReviewFlow وLaunchReviewFlow الطرق. بعد تقديم طلب، يمكن لتطبيقك التحقّق من حالته. باستخدام ReviewErrorCode.

إعداد بيئة التطوير

يمكنك تنزيل أحدث إصدار من مكوّن Unity الإضافي لمراجعة In-App Review في Play من حِزم Google الانسجام:

ملاحظة: يخضع تنزيل مكوّنات Unity الإضافية من Google Play واستخدامها لـ بنود خدمة حزمة تطوير البرامج الأساسية في Play من خلال تنزيل مكوّنات Unity الإضافية من Google Play واستخدامها، يعني ذلك أنّك توافق على بنود خدمة "حزمة تطوير البرامج الأساسية":

إنشاء 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 الذي يحتاجه تطبيقك لبدء مسار المراجعة داخل التطبيق. في المثال، يتم إجراء الاتصال داخل كوروتين لإجراء العملية غير المتزامنة (فهذا لا يحظر سلسلة التعليمات الرئيسية). لأنّ يتم إجراء المكالمة بشكل غير متزامن، وقد يستغرق ذلك بضع ثوانٍ، لذا يجب أن يجري تطبيقك الاتصال قبل أن يصل التطبيق إلى النقطة التي واجهها الذي تريد عرض المراجعة داخل التطبيق فيه

بدء مسار المراجعة داخل التطبيق

بعد أن يتلقّى تطبيقك 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.

الخطوات التالية

يمكنك اختبار مسار المراجعة داخل التطبيق من أجل والتحقق من أن عملية الدمج تعمل بشكل صحيح.