واجهة برمجة التطبيقات Google Play In-App Review API

تتيح لك واجهة برمجة التطبيقات الخاصة بالمراجعات داخل التطبيق على Google Play طلب تقييمات ومراجعات من المستخدمين في "متجر Play" بدون الحاجة إلى مغادرتهم تطبيقك أو لعبتك.

بشكل عام، يمكن بدء عملية المراجعة داخل التطبيق (راجِع الشكل 1) في أي وقت أثناء رحلة المستخدم في تطبيقك. وخلال هذه العملية، يمكن للمستخدم تقييم تطبيقك باستخدام نظام التقييم من 1 إلى 5 نجوم وإضافة تعليق اختياري. بعد إرسال المراجعة، يتم إرسالها إلى "متجر Play" ويتم عرضها في النهاية.

لحماية خصوصية المستخدمين وتجنُّب إساءة استخدام واجهة برمجة التطبيقات، هناك إرشادات صارمة يجب أن يليمها تطبيقك بشأن حالات طلب المراجعات داخل التطبيق وتصميم الطلب.

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

الشكل 1: مسار المراجعة داخل التطبيق للمستخدم

متطلبات الأجهزة

لا تعمل المراجعات داخل التطبيق إلا على الأجهزة التالية:

  • أجهزة Android (الهواتف والأجهزة اللوحية) التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث والتي تم تثبيت "متجر Google Play" عليها
  • أجهزة ChromeOS التي تم تثبيت "متجر Google Play" عليها

متطلبات مكتبة Play Core

لدمج ميزة "المراجعات داخل التطبيق" في تطبيقك، يجب أن يستخدم تطبيقك الإصدار 1.8.0 أو إصدارًا أحدث من مكتبة Play Core.

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

اتّبِع الإرشادات التالية لمساعدتك في تحديد الوقت المناسب لطلب مراجعات من المستخدِمين داخل التطبيق:

  • ابدأ عملية المراجعة داخل التطبيق بعد أن يحصل المستخدم على تجربة كافية في تطبيقك أو لعبتك لتقديم ملاحظات مفيدة.
  • لا تطلب من المستخدم تقديم مراجعة بشكل مفرط. تساعد هذه الطريقة في تقليل انزعاج المستخدمين والحدّ من استخدام واجهة برمجة التطبيقات (اطّلِع على القسم الخاص بالحصص).
  • يجب ألا يطرح تطبيقك أي أسئلة على المستخدم قبل عرض زر التقييم أو البطاقة أو أثناء عرضهما، بما في ذلك أسئلة عن رأيه (مثل "هل يعجبك التطبيق؟") أو أسئلة توقّعية (مثل "هل يمكنك تقييم هذا التطبيق بـ 5 نجوم؟").

إرشادات التصميم

اتّبِع الإرشادات التالية عند تحديد كيفية دمج المراجعات داخل التطبيق في تطبيقك:

  • اعرض البطاقة كما هي، بدون العبث بالتصميم الحالي أو تعديله بأي شكل من الأشكال، بما في ذلك الحجم أو الشفافية أو الشكل أو السمات الأخرى.
  • لا تُضِف أيّ طبقة فوق البطاقة أو حولها.
  • يجب أن تكون البطاقة وخلفيتها في الطبقة العليا. بعد ظهور البطاقة، لا تزيلها آليًا. تتم إزالة البطاقة تلقائيًا استنادًا إلى إجراء واضح من المستخدم أو آلية داخلية في "متجر Play".

الحصص

لتوفير تجربة رائعة للمستخدم، يفرض Google Play حصة زمنية على عدد المرات التي يمكن أن يظهر فيها مربّع الحوار للمراجعة للمستخدم. بسبب هذه الحصة، قد لا يؤدي استدعاء طريقة launchReviewFlow أكثر من مرة خلال فترة زمنية قصيرة (مثلاً، أقل من شهر) إلى عرض مربّع حوار في بعض الأحيان.

ولأنّ الحصة تخضع للتغيير، من المهم تطبيق منطقك الخاص واستهداف أفضل لحظة ممكنة لطلب إجراء مراجعة. على سبيل المثال، يجب عدم تضمين خيار لحث المستخدم على اتّخاذ إجراء (مثل زر) لتشغيل واجهة برمجة التطبيقات، لأنّ المستخدم قد يكون قد بلغ حصته ولن يتم عرض المسار، ما يؤدي إلى تقديم تجربة متعطّلة للمستخدم. في حالة الاستخدام هذه، يمكنك إعادة توجيه المستخدم إلى "متجر Play" بدلاً من ذلك.

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

تعرَّف على كيفية دمج المراجعات داخل التطبيق، استنادًا إلى بيئة التطوير التي تستخدمها:

بنود الخدمة وسلامة البيانات

يعني الوصول إلى "مكتبة المراجعات داخل التطبيقات" على Play أو استخدامها موافقتك على بنود خدمة "مجموعة تطوير البرامج الأساسية" (Play Core). يُرجى قراءة كلّ البنود والسياسات السارية وفهمها قبل الوصول إلى المكتبة.

أمان البيانات

مكتبات Play Core هي واجهة وقت تشغيل تطبيقك مع "متجر Google Play". ولذلك، عند استخدام Play Core في تطبيقك، ينفِّذ "متجر Play" عملياته الخاصة، بما في ذلك معالجة البيانات وفقًا لبنود خدمة Google Play. توضّح المعلومات التالية كيفية معالجة مكتبات Play Core للبيانات لمعالجة طلبات معيّنة من تطبيقك.

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

البيانات التي يتم جمعها استنادًا إلى الاستخدام البيانات التي يُدخلها المستخدم (التقييم والمراجعة النصية الحرة)
الغرض من جمع البيانات يتم استخدام البيانات التي يتم جمعها لكتابة مراجعة على "متجر Play".
ترميز البيانات يتم تشفير البيانات.
مشاركة البيانات يتم استخدام البيانات التي يتم جمعها في مراجعة علنية على "متجر Play"، أو تتم مشاركة البيانات التي يتم جمعها مع مطوّر التطبيق بشكل خاص إذا كان التطبيق في مسار اختبار مغلق.
حذف البيانات يمكن للمستخدمين حذف مراجعاتهم في حسابهم على "متجر Google Play" أو حساب Google.

على الرغم من أنّنا نسعى إلى أن نكون شفافين قدر الإمكان، إلا أنّك وحدك المسؤول عن تحديد كيفية الردّ على نموذج قسم "أمان البيانات" في Google Play بشأن ممارسات جمع بيانات المستخدمين ومشاركتها والحفاظ على أمانها في تطبيقك.