تتيح لك واجهة برمجة التطبيقات Google Play In-App Review API إمكانية تشجيع المستخدمين على إرسال التقييمات والمراجعات من "متجر Play" بدون الحاجة إلى مغادرة التطبيق أو اللعبة.
بشكل عام، يمكن بدء عملية المراجعة داخل التطبيق (انظر الشكل 1) في أي وقت طوال رحلة المستخدم لتطبيقك. وأثناء هذه العملية، يستطيع المستخدم تقييم تطبيقك باستخدام نظام النجوم من 1 إلى 5 وإضافة تعليق اختياري. بعد إرسال المراجعة، يتم إرسالها إلى "متجر Play" وعرضها في النهاية.
لحماية خصوصية المستخدم وتجنُّب إساءة استخدام واجهة برمجة التطبيقات، هناك إرشادات صارمة يجب أن يتّبعها تطبيقك بشأن حالات طلب إجراء مراجعات داخل التطبيق وتصميم إشعار المراجعة.
الشكل 1. تدفق المراجعة داخل التطبيق للمستخدم
متطلبات الجهاز
لا تعمل المراجعات داخل التطبيق إلا على الأجهزة التالية:
- أجهزة Android (الهواتف والأجهزة اللوحية) التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث التي تم تثبيت "متجر Google Play" عليها.
- أجهزة ChromeOS التي تم تثبيت "متجر Google Play" عليها
متطلبات مكتبة Play الأساسية
لدمج المراجعات داخل تطبيقك، يجب أن يستخدم تطبيقك الإصدار 1.8.0 أو إصدارًا أحدث من مكتبة Play الأساسية.
الوقت المناسب لطلب إجراء مراجعة داخل التطبيق
اتبع هذه الإرشادات لمساعدتك في تحديد وقت طلب المراجعات داخل التطبيق من المستخدمين:
- يمكنك تشغيل تدفق المراجعة داخل التطبيق بعد أن يحصل المستخدم على قدر كافٍ من التطبيق أو اللعبة لتقديم ملاحظات مفيدة.
- لا تطلب من المستخدم كثيرًا إضافة المراجعة. ويساعد هذا المنهج في تقليل شعور المستخدمين بالاستياء والحد من استخدام واجهة برمجة التطبيقات (راجِع القسم الخاص بالحصص).
- يجب ألّا يطرح تطبيقك أي أسئلة على المستخدم قبل عرض زر أو بطاقة التقييم أو أثناء عرضه، بما في ذلك الأسئلة المتعلقة بآرائه (مثل "هل يعجبك التطبيق؟") أو أسئلة توقّعية (مثل "هل تقيّم هذا التطبيق بخمس نجوم").
إرشادات التصميم
اتبع هذه الإرشادات عند تحديد كيفية دمج المراجعات داخل التطبيق في تطبيقك:
- سطح البطاقة كما هي، بدون التلاعب بالتصميم الحالي أو تعديله بأي شكل من الأشكال، بما في ذلك الحجم أو التعتيم أو الشكل أو الخصائص الأخرى.
- لا تضِف أي تركيب فوق البطاقة أو حولها.
- يجب وضع البطاقة وخلفية البطاقة على الطبقة العلوية. بعد عرض البطاقة، يجب عدم إزالتها آليًا. تتم إزالة البطاقة تلقائيًا بناءً على الإجراء الصريح الذي اتخذه المستخدم أو آلية داخلية على "متجر Play".
الحصص
لتوفير تجربة رائعة للمستخدم، يفرض Google Play حصة محددة زمنيًا على
عدد المرات التي يمكن فيها عرض مربع حوار المراجعة للمستخدم. وبسبب هذه الحصة، قد لا يؤدي استدعاء طريقة launchReviewFlow أكثر من مرة خلال فترة زمنية قصيرة (على سبيل المثال، أقل من شهر) إلى عرض مربّع حوار دائمًا.
وبما أنّ الحصة تخضع للتغيير، من المهم تطبيق منطقك الخاص واستهداف أفضل لحظة ممكنة لطلب إجراء مراجعة. على سبيل المثال، يجب ألا يتوفّر لديك خيار الحث على اتّخاذ إجراء (مثل زر) لتشغيل واجهة برمجة التطبيقات، إذ يُحتمل أن يكون المستخدم قد بلغ حصته من مساحة التخزين ولن يظهر سير العملية، ما سيؤدي إلى تقديم تجربة غير مكتملة له. في حالة الاستخدام هذه، أعِد توجيه المستخدم إلى "متجر Play" بدلاً من ذلك.
دمج المراجعات داخل التطبيق في تطبيقك
تعرَّف على كيفية دمج المراجعات داخل التطبيق بناءً على بيئة التطوير:
بنود الخدمة وأمان البيانات
من خلال الوصول إلى "مكتبة المراجعات داخل التطبيق" في Play أو استخدامها، أنت توافق على بنود خدمة "أدوات تطوير البرامج الأساسية" في Play. يُرجى قراءة وفهم جميع البنود والسياسات السارية قبل الوصول إلى المكتبة.
أمان البيانات
مكتبات Play الأساسية هي واجهة تشغيل تطبيقك مع "متجر Google Play". بناءً على ذلك، عند استخدام Play Core في تطبيقك، ينفِّذ "متجر Play" عملياته الخاصة، والتي تتضمن معالجة البيانات وفقًا لبنود خدمة Google Play. وتوضّح المعلومات الواردة أدناه طريقة تعامل مكتبات Play الأساسية مع البيانات لمعالجة طلبات محدَّدة من تطبيقك.
المراجعات داخل التطبيق
| البيانات التي يتم جمعها عند الاستخدام | البيانات التي يُدخلها المستخدم (التقييم ومراجعة النصوص الحرة) |
| الغرض من جمع البيانات | تُستخدَم البيانات التي يتم جمعها لإضافة مراجعة على "متجر Play". |
| ترميز البيانات | البيانات مشفَّرة. |
| مشاركة البيانات | تُستخدَم البيانات التي يتم جمعها في مراجعة علنية على "متجر Play"، أو إذا كان التطبيق في مسار اختبار مغلق، تتم مشاركة البيانات التي تم جمعها بشكل خاص مع مطوِّر التطبيقات. |
| حذف البيانات | يمكن للمستخدمين حذف مراجعاتهم في حساباتهم على "متجر Google Play" أو Google. |
على الرغم من سعينا إلى الالتزام بالشفافية قدر الإمكان، فإنّك وحدك من يتحمّل مسؤولية تحديد كيفية الردّ على نموذج قسم "أمان البيانات" على Google Play بشأن ممارسات جمع بيانات المستخدمين ومشاركتها وأمانها في تطبيقك.