يوضّح هذا الدليل كيفية دمج المراجعات داخل التطبيق في تطبيقك باستخدام Kotlin أو Java. هناك أدلة دمج منفصلة إذا كنت تستخدم الإعلانات المدمجة مع المحتوى الرمز أو الانسجام
إعداد بيئة التطوير
"مكتبة المراجعات داخل التطبيق" على Play هي جزء من مكتبات Google Play الأساسية. يُرجى تضمين الاعتمادية التالية لنظام Gradle المتوافق مع Google Play داخل التطبيق مكتبة المراجعات:
Groovy
// In your app’s build.gradle file: ... dependencies { // This dependency is downloaded from the Google’s Maven repository. // So, make sure you also include that repository in your project's build.gradle file. implementation 'com.google.android.play:review:2.0.1' // For Kotlin users also add the Kotlin extensions library for Play In-App Review: implementation 'com.google.android.play:review-ktx:2.0.1' ... }
Kotlin
// In your app’s build.gradle.kts file: ... dependencies { // This dependency is downloaded from the Google’s Maven repository. // So, make sure you also include that repository in your project's build.gradle file. implementation("com.google.android.play:review:2.0.1") // For Kotlin users also import the Kotlin extensions library for Play In-App Review: implementation("com.google.android.play:review-ktx:2.0.1") ... }
إنشاء ReviewManager
ReviewManager
هي الواجهة التي تتيح لتطبيقك بدء عملية مراجعة داخل التطبيق. احصل عليه بواسطة
إنشاء مثيل باستخدام ReviewManagerFactory
Kotlin
val manager = ReviewManagerFactory.create(context)
Java
ReviewManager manager = ReviewManagerFactory.create(context)
طلب عنصر ReviewInfo
اتّباع الإرشادات حول حالات الطلب داخل التطبيق
المراجعات لتحديد النقاط الجيدة
في مسار المستخدم الخاص بالتطبيق
لطلب مراجعة من المستخدم (على سبيل المثال، عند
إكمال المستخدم لمستوى في لعبة). عندما يصل تطبيقك إلى إحدى هذه النقاط،
استخدام ReviewManager
لإنشاء مهمة طلب. وفي حال نجاحها، ستعرض واجهة برمجة التطبيقات
كائن ReviewInfo
اللازمة لبدء تدفق المراجعة داخل التطبيق.
Kotlin
val request = manager.requestReviewFlow() request.addOnCompleteListener { task -> if (task.isSuccessful) { // We got the ReviewInfo object val reviewInfo = task.result } else { // There was some problem, log or handle the error code. @ReviewErrorCode val reviewErrorCode = (task.getException() as ReviewException).errorCode } }
Java
ReviewManager manager = ReviewManagerFactory.create(this); Task<ReviewInfo> request = manager.requestReviewFlow(); request.addOnCompleteListener(task -> { if (task.isSuccessful()) { // We can get the ReviewInfo object ReviewInfo reviewInfo = task.getResult(); } else { // There was some problem, log or handle the error code. @ReviewErrorCode int reviewErrorCode = ((ReviewException) task.getException()).getErrorCode(); } });
بدء مسار المراجعة داخل التطبيق
استخدام ReviewInfo
مثال لبدء تدفق المراجعة داخل التطبيق. انتظر حتى يكمل المستخدم
تدفق المراجعة داخل التطبيق قبل أن يواصل التطبيق تدفق المستخدم العادي (مثل
والتقدم إلى المستوى التالي).
Kotlin
val flow = manager.launchReviewFlow(activity, reviewInfo) flow.addOnCompleteListener { _ -> // 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. }
Java
Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo); flow.addOnCompleteListener(task -> { // 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. });
الخطوات التالية
يمكنك اختبار مسار المراجعة داخل التطبيق من أجل والتحقق من أن عملية الدمج تعمل بشكل صحيح.