يجب أن تختبر التكامل خلال عملية التطوير. لإجراء الاختبار خلال مرحلة التطوير، ننصحك بالاستعانة بمختبِري التراخيص ومركز الفوترة في Play للتعرّف على السيناريوهات الموضّحة في هذا القسم.
مختبرو الترخيص
لإعداد مختبِري الترخيص، يُرجى الاطّلاع على اختبار الفوترة داخل التطبيقات من خلال ترخيص التطبيق.
ويوفّر الاستعانة بمختبِري الترخيص المزايا التالية:
- يتم عادةً حظر واجهة برمجة التطبيقات Google Play Billing Library على التطبيقات التي لم يتم توقيعها وتحميلها إلى Google Play. ويمكن لمختبِري الترخيص تجاوز عملية الفحص هذه، ما يعني أنّه يمكنكم تثبيت التطبيقات من مصدر غير معروف لاختبارها، حتى في التطبيقات التي تستخدم إصدارات تصحيح الأخطاء التي تتضمّن توقيعات لتصحيح الأخطاء بدون الحاجة إلى تحميلها إلى الإصدار الجديد من التطبيق. يُرجى العِلم أنّ اسم الحزمة يجب أن يتطابق مع اسم التطبيق الذي تم إعداده من أجل Google Play، ويجب أن يكون حساب Google مختبِرًا للترخيص لحساب Google Play Console.
- يمكن لمختبري الترخيص اختبار طرق الدفع التي تتجنب تحصيل رسوم حقيقية من المختبرين مقابل عمليات الشراء. يمكنك أيضًا استخدام طرق دفع تجريبية لمحاكاة مواقف معينة، مثل حالة رفض دفعة. يوضح الشكل 1 طرق الدفع الاختبارية هذه كما تظهر في مسار الشراء.
- يمكن لمختبِري الترخيص اختبار ميزات الاشتراك بسرعة.
في ما يلي بعض التفاصيل الإضافية عن عملية الشراء التجريبية:
- تستخدم عمليات الشراء التجريبية مسار شراء التطبيق نفسه المستخدَم في عمليات الشراء الفعلية.
- لا يتم احتساب الضرائب على عمليات الشراء التجريبية.
- ويشير Google Play إلى عملية شراء تجريبية من خلال عرض إشعار في منتصف مربّع حوار الشراء.
يمكنك تأكيد الحساب الذي يُجري عملية شراء من خلال توسيع مربّع حوار الشراء. ملاحظات:
- يجب أن تكون حسابات الاختبار على جهاز Android الخاص بالمختبِر.
- إذا كان الجهاز يتضمن أكثر من حساب، فسيتم إجراء عملية الشراء باستخدام الحساب الذي تم تنزيل التطبيق من خلاله.
- إذا لم يتم تنزيل التطبيق من أي حساب، يتم إجراء عملية الشراء باستخدام الحساب الأول.
قبل توزيع تطبيقك، يمكنك الاستفادة من مسارات الاختبار في Google Play لإجراء عمليات تحقّق إضافية. على سبيل المثال، يمكنك الاستفادة من مسارات الاختبار ليكون فريق ضمان الجودة مؤهلاً لإصدار جديد.
من خلال مسارات الاختبار، يمكن للمستخدمين تثبيت تطبيقك من Google Play واختبار إصدار تطبيقك غير المتاح للجميع إلى الآن. يمكن للمستخدمين إجراء عمليات شراء حقيقية باستخدام أي من طرق الدفع المتوفرة لديهم في Google Play.
لاختبار دمج Google Play Billing Library باستخدام مسارات الاختبار، عليك إجراء ما يلي:
- انشر تطبيقك في مسار اختبار. يُرجى ملاحظة أنّه بعد نشر تطبيق في مسار اختبار، قد تستغرق إتاحة التطبيق للمختبِرين بضع ساعات.
- تأكّد من أن كل مختبِر يوافق على اختبار تطبيقك. على عنوان URL لإعداد الإصدارات التجريبية لتفعيل الاختبار، سيظهر للمختبِرين شرحًا لما يعنيه الانضمام إلى المختبِرين مع رابط للموافقة على المشاركة.
يمكنك اختبار التكامل على أي جهاز يعمل بنظام التشغيل Android يعمل بالإصدار 1.6 من نظام التشغيل Android أو إصدار أحدث. يجب تثبيت أحدث إصدار من تطبيق Google Play على الجهاز. للحصول على معلومات عامة حول كيفية إعداد جهاز للاستخدام في تطوير تطبيقات Android، راجع استخدام الأجهزة.
برنامج الفوترة في Play
Play Billing Lab هو تطبيق Android يساعد المطوّرين على اختبار دمجهم مع نظام الفوترة في Google Play. توفّر هذه الأداة طريقة سهلة ومريحة للمطوّرين لاختبار ميزات الفوترة ودمجها بشكل أسرع وإطلاقها بثقة أكبر. يمكنك تنزيل برنامج Play Billing Lab وتثبيته من متجر Play.
تتيح لك ميزة "الفوترة في Play" الاختبارية إجراء ما يلي خلال الاختبار:
- غيِّر البلد في Play من داخل برنامج "الفوترة في Play" وطبِّق الإعدادات على الاختبار. يتيح ذلك اختبار تجارب مستخدِم مخصّصة في بلدان أو مناطق مختلفة بغضّ النظر عن المكان الذي يجري فيه المختبِر الاختبار.
- اختبِر العروض التجريبية أو العروض التمهيدية بشكل متكرّر باستخدام الحساب نفسه
- تجربة تغييرات أسعار الاشتراكات بدون التأثير في المشتركين النشطين الآخرين
- تسريع عمليات تجديد الاشتراكات لتسريع عملية الاختبار
- اختبار الحملات باستخدام طرق دفع حقيقية لتجاوز إشارات معيّنة لمخاطر مسار الشراء
اختبار المنتجات التي يتم تحصيل سعرها مرة واحدة
اختبار المنتجات الاستهلاكية
عند اختبار المنتجات الاستهلاكية، اختبِر مجموعة متنوعة من الحالات، بما في ذلك ما يلي:
- عملية شراء ناجحة يحصل فيها المستخدم على سلعة. مع مختبِر الترخيص، يمكنك استخدام أداة الاختبار والموافقة دائمًا على طريقة الدفع.
- عملية شراء لم يتم فيها تحصيل رسوم من طريقة الدفع، ولا يجب على المستخدم استلام المنتج. يمكنك الاستعانة بأحد مختبِري الترخيص لاستخدام طريقة الدفع أداة الاختبار، ويتم رفضها دائمًا.
- التأكّد من إمكانية شراء السلع عدّة مرات
تأكَّد من الإقرار بشكل صحيح باستلام عمليات الشراء على النحو الموضّح في معالجة عمليات الشراء. وبالنسبة إلى عمليات الشراء التي أجراها مختبِرو الترخيص، سيتم ردّ الأموال المدفوعة في عملية الشراء بعد 3 دقائق إذا لم يوافق تطبيقك على عملية الشراء وستتلقّى رسالة إلكترونية بشأن عملية الإلغاء. يمكنك أيضًا الاطّلاع على علامة التبويب الطلبات في "وحدة تحكُّم Google Play" لمعرفة ما إذا تمّ ردّ أموال أحد الطلبات بعد 3 دقائق.
اختبار المنتجات غير الاستهلاكية
يجب أن يتم اختبار المواد غير الاستهلاكية بالطريقة نفسها المستخدَمة للاستهلاك، ولكن يجب التأكّد من أنّه لا يمكن شراء سلعة مرة أخرى داخل التطبيق. وعليك التأكّد من تأكيد إقرار الشراء لكل من السلع غير الاستهلاكية والمستهلكين (عند الاقتضاء) لأنّ المنطق اللازم لمعالجة نوعَي الشراء يختلفان.
اختبار عمليات الشراء المعلّقة
اختبار عملية شراء معلّقة يجب من خلالها منح السلعة عندما
تتغيّر حالة الشراء إلى PURCHASED يمكن لمختبِري الترخيص استخدام اثنين من أدوات الاختبار لطرق الدفع المتأخرة، ويتم إكمال عملية الدفع أو إلغاؤها تلقائيًا بعد مرور بضع دقائق.
إجراء عملية شراء باستخدام طريقة دفع متأخرة بطاقة اختبار بطيء، ورفض الطلب بعد بضع دقائق، كما هو موضّح في الشكل 3. أعد تشغيل التطبيق، وتأكد من أنه لم يتم منح عملية الشراء.
الشكل 3. اختبار عملية شراء ببطاقة اختبار بطيء مرفوضة إجراء عملية شراء باستخدام طريقة دفع متأخرة بطاقة اختبار بطيء، تتم الموافقة بعد بضع دقائق، كما هو موضّح في الشكل 4. انتظر بضع دقائق، وتحقق من منح عملية الشراء.
الشكل 4. يجب اختبار عملية شراء باستخدام بطاقة اختبار بطيء موافَق عليها.
يمكنك العثور على مزيد من المعلومات في صفحة التعامل مع المعاملات المعلَّقة.
اختبار الميزات الخاصة بالاشتراكات
تعتبر خطوات شراء المنتجات التي يتم تحصيل سعرها مرة واحدة والاشتراكات متشابهة، ولكن بالنسبة إلى الاشتراكات هناك سيناريوهات إضافية، مثل عمليات تجديد الاشتراك الناجحة أو المرفوضة. لاختبار عمليات التجديد، يمكنك استخدام بطاقة الاختبار، والموافقة دائمًا، وبطاقة الاختبار، والرفض دائمًا طرق الدفع المتاحة لمختبِري الترخيص، كما هو موضّح في الرسم 1. يمكنك استخدام وسائل الدفع هذه لاختبار سيناريوهات خارج نطاق سيناريو الاشتراك الناجح.
كما هي الحال مع المنتجات التي يتم تحصيل سعرها مرة واحدة، تأكّد من أنّه يتم قبول عمليات الشراء بشكل صحيح كما هو موضّح في معالجة عمليات الشراء. وبالنسبة إلى عمليات الشراء التي أجراها مختبِرو الترخيص، يتم ردّ أموال عملية الشراء بعد 3 دقائق إذا لم يؤكّد تطبيقك عملية الشراء، وتلقيت رسالة إلكترونية بشأن عملية الإلغاء. يمكنك أيضًا مراجعة علامة التبويب الطلبات في Google Play Console لمعرفة ما إذا تم ردّ أموال الطلب بعد 3 دقائق.
فترات التجديد
يتم تجديد الاشتراكات التجريبية بسرعة أكبر من الاشتراكات الفعلية، ويمكن تجديد الاشتراكات التجريبية ست مرات كحدّ أقصى، بدون احتساب الفترات التجريبية المجانية والفترات التمهيدية.
يسرد الجدول التالي أوقات تجديد الاختبار للاشتراكات ذات المدد المختلفة. هذه الأوقات تقريبية. قد ترى اختلافات صغيرة في الوقت المحدد لحدث ما. للتعويض عن الاختلاف، يمكنك طلب بيانات واجهة برمجة التطبيقات لعرض الحالة الحالية بعد كل تاريخ لانتهاء صلاحية الاشتراك.
| فترة الاشتراك في قناة الإصدار العلني | تجديد الاشتراك التجريبي |
| أسبوع واحد | ٥ دقائق |
| شهر واحد | ٥ دقائق |
| 3 أشهر | 10 دقائق |
| 6 أشهر | 15 دقيقة |
| سنة واحدة | 30 دقيقة |
ويتم أيضًا اختصار ميزات الاشتراك التي تستند إلى الوقت، مثل الفترات التجريبية المجانية، للاختبار. يحدد الجدول التالي الفترات الزمنية للاختبار المرتبطة بميزات الاشتراك المستندة إلى الوقت:
| الميزة | فترة الاختبار |
| الإقرار بالشراء | ٥ دقائق |
| تجربة مجانية | 3 دقائق |
| فترة السعر التمهيدي | فترة اختبار الاشتراك نفسها |
| فترة السماح | ٥ دقائق |
| تعليق الحساب | 10 دقائق |
| إيقاف مؤقت (لمدة شهر واحد) | ٥ دقائق |
| إيقاف مؤقت (شهران) | 10 دقائق |
| إيقاف مؤقت (3 أشهر) | 15 دقيقة |
تسريع التجديد
يمكنك أيضًا الاستعانة ببرنامج الفوترة في Play ومختبِري التراخيص لتسريع فترات تجديد الاشتراكات التجريبية باتّباع الخطوات التالية:
- انقر على إدارة في بطاقة إعدادات الاشتراك في لوحة البيانات.
- اختَر الاشتراك النشِط الذي تريد اختباره.
- انقر على التجديد الآن.
بعد النقر على الزر التجديد الآن، سيتمّ تجديد الاشتراك التجريبي بعد ذلك بقليل.
تجدر الإشارة إلى ما يلي:
- يجب الإقرار بالاشتراكات التجريبية قبل استخدام ميزة "التجديد السريع"، وإلا سيتم إلغاء الاشتراك.
- قد يستغرق تنفيذ عملية التجديد بضع ثوانٍ.
- لا يكون زر التجديد الآن متاحًا عندما يكون تغيير السعر ساريًا.
- عند تجديد الاشتراك، لا تكون ميزة تغيير سعر الاشتراك متاحة.
عروض الفترات التجريبية
من خلال ميزة اختبار عرض الفترة التجريبية المجانية من Play Billing Lab، يمكن لمختبِر الترخيص اختبار الفترة التجريبية المجانية أو العروض التمهيدية واستخدامها لعدد غير محدود من المرات من خلال وضع علامة في مربّع الاختيار اختبار الفترة التجريبية المجانية أو العرض التمهيدي وتطبيق التغيير. بهذه الطريقة، لن تحتاج إلى إنشاء حسابات متعدّدة لاختبار عرض الفترة التجريبية المتوفّر فقط للمشتركين الجدد.
تغييرات السعر
يمكنك أيضًا الاستعانة ببرنامج الفوترة في Play ومختبِري التراخيص لاختبار التغييرات في أسعار الاشتراكات بدون التأثير في المشتركين النشطين الآخرين، وذلك باتّباع الخطوات التالية:
- انقر على إدارة في بطاقة إعدادات الاشتراك في لوحة البيانات.
- اختَر الاشتراك النشِط الذي تريد اختباره.
- أدخِل السعر الجديد.
- ضَع علامة في مربّع الاختيار إيقاف اشتراك المستخدم أو أزِل العلامة لكل متطلبات الاختبار.
- انقر على تطبيق.
بعد تطبيق التغييرات، يتم تحديث السعر بدءًا من التجديد التالي فقط للمختبِر. ولن يؤثّر ذلك في المشتركين النشطين الآخرين. تسري جميع قواعد مختبِري الترخيص على الاشتراك التجريبي. ويمكن للمختبِر بعد ذلك اختبار تطبيقه للتأكّد من العمليات التي تؤدّي إلى مرحلة ما بعد بيع المنتج والتي تسببت في تغيير السعر، مثل إشعارات تغيير السعر.
يجب أخذ الاعتبارات التالية في الاعتبار عند التخطيط لفترات الاختبارات:
- قد يؤدي تغيير السعر من وحدة التحكّم إلى عدم التسجيل لمختبِري الترخيص بسبب فترة تجديد الاشتراكات الصغيرة. ولضمان إمكانية اختبار الإشعارات والرسائل الإلكترونية المتعلّقة بتغيير الأسعار، على المطوّرين تأجيل الفوترة لمدة ساعة على الأقل بعد تغيير السعر.
- لا تتضمّن الانخفاضات في الأسعار فترة إشعار. ويتم إشعار المستخدمين بانخفاض السعر بعد وقت قصير من نقل المجموعة النموذجية. لم يتغير هذا عند الاختبار.
- بالنسبة إلى الزيادات في الأسعار، يتم احتساب أوقات الإشعارات الخاصة بالاختبار تمامًا كما يتم احتسابها مع الزيادات الفعلية:
- يتم تحصيل الرسوم من المستخدم لأول مرة في الذكرى السنوية الأولى للفوترة بعد مرور فترة إشعار إلزامية.
- يتم احتساب أوقات الإشعارات بشكل سابق من تاريخ تحصيل الرسوم الأول.
- يتم دائمًا إرسال الإشعار الأخير قبل دقيقة واحدة من تحصيل الرسوم، بغض النظر عن مدة الفوترة.
يعرض الجدول التالي الفوترة التجريبية ومُدد الإشعارات لعدة مُدد فوترة فعلية:
| المدة الزمنية الفعلية للفوترة للخطة الأساسية | مدة الفوترة التجريبية | فترة الإشعار التجريبية (المناطق التي تتيح تفعيل الميزة وإيقافها مع إرسال إشعار قبل 30 يومًا) | فترة الإشعار التجريبية (المناطق التي تتيح الإيقاف وإرسال إشعار قبل 60 يومًا) |
| أسبوع واحد | ٥ دقائق | ٥ دقائق | 10 دقائق |
| شهر واحد | ٥ دقائق | ٥ دقائق | 10 دقائق |
| 3 أشهر | 10 دقائق | 3 دقائق | ٦ دقائق |
| 6 أشهر | 15 دقيقة | دقيقتان | 4 دقائق |
| سنة واحدة | 30 دقيقة | 3 دقائق | ٦ دقائق |
أُطُر الاختبار
وسِّع القسم التالي بالنقر على إظهار/إخفاء لعرض سيناريوهات الاختبار التي يجب استخدامها للتحقّق من دمج الاشتراك.
اختبار المعاملات التي في انتظار المراجعة
عليك اختبار المعاملات التي لا تزال في انتظار المراجعة ليتم التعامل معها بشكلٍ صحيح، ويتم
تعديل الأذونات وفقًا لذلك عندما تصبح حالة الشراء PURCHASED. يمكن لمختبِري الترخيص الوصول إلى أداتين اختباريتين لطرق الدفع المتأخرة، بحيث يتم إكمال عملية الدفع أو إلغاؤها تلقائيًا بعد مرور بضع دقائق.
إجراء عملية شراء باستخدام طريقة دفع متأخرة بطاقة اختبار بطيء، وترفض بعد بضع دقائق، كما هو موضّح في الشكل 8. أعد تشغيل التطبيق، وتأكد من أنه لم يتم منح عملية الشراء.
الشكل 8. اختبار عملية شراء ببطاقة اختبار بطيء مرفوضة إجراء عملية شراء باستخدام طريقة دفع متأخرة بطاقة اختبار بطيء، تتم الموافقة بعد بضع دقائق، كما هو موضّح في الشكل 9. انتظر بضع دقائق، وتحقق من منح عملية الشراء.
الشكل 9. يجب اختبار عملية شراء باستخدام بطاقة اختبار بطيء موافَق عليها.
اختبار الرموز الترويجية
يمكنك استخدام Google Play Console لإنشاء رموز لاختبارك الخاص. يُرجى العلم أنّه يمكنك إنشاء 500 رمز ترويجي فقط كل ربع سنة على مستوى جميع المنتجات المُدارة في تطبيق واحد.
يجب اختبار السيناريوهات التالية لتحصيل قيمة الرموز الترويجية:
- عند إدخال الرمز الترويجي في مربّع حوار الشراء الذي تم إطلاقه داخل تطبيقك
- عند تحصيل قيمة الرمز الترويجي في تطبيق "متجر Google Play"
- عند تحصيل قيمة الرمز الترويجي على https://play.google.com/store باستخدام الزر تحصيل القيمة في قائمة التنقّل اليمنى.
في هذه السيناريوهات، يجب اختبار تحصيل قيمة الرموز بأكبر عدد ممكن من الطرق. قم بإجراء الاختبارات التالية على الأقل:
- سيتم تحصيل القيمة قبل تثبيت التطبيق.
- تحصيل القيمة أثناء تشغيل التطبيق في المقدّمة يُرجى ملاحظة أنّه لإجراء هذا الاختبار، يجب استخدام جهاز آخر للاختبار باستخدام تطبيق "متجر Google Play". يُرجى التأكّد من اختبار عمليات تحصيل القيم من شاشات مختلفة في تطبيقك.
- يمكنك الاستفادة من العرض باستخدام وضع النوافذ المتعددة، حيث يتم عرض كل من تطبيقك وتطبيق "متجر Google Play" في الوقت نفسه.
في كل اختبار، تأكد من اكتشاف العنصر بشكل صحيح ومن أنه تم إشعار المستخدم.
اختبار تجربة الشراء في مناطق مختلفة
يمكنك اختبار تجربة الشراء مع برنامج "الفوترة في Play" أو بدونه من خلال اتّباع الخطوات التالية:
الاختبار باستخدام
يتيح لك تطبيق Play Billing Lab المتوافق مع Android اختبار مسار الشراء في أي منطقة. ومع ذلك، لكي تتمكّن من استخدام Play Billing Lab، يجب أن تكون مختبِرًا للترخيص. اتّبِع الخطوات التالية لاختبار ما يلي:
- يمكنك تسجيل مستخدم فوترة التطبيق كمختبِر للترخيص.
- سجِّل الدخول إلى تطبيق Play Billing Lab باستخدام المستخدم نفسه.
- اختَر البلد المطلوب وطبِّق التغيير في الميزة الاختبارية "الفوترة في Play".
- ابدأ مسار الشراء في التطبيق قيد الاختبار.
الاختبار بدون
يمكنك أيضًا اختبار مسار الشراء في أي منطقة بدون استخدام Play Billing Lab. اتّبِع الخطوات التالية لإجراء الاختبار:
- أنشئ حسابًا جديدًا على Gmail. ويمكن إنشاء الحساب في أي بلد.
- اختياريًا، يمكنك إعداد المستخدم كمختبِر للترخيص.
- شبكة VPN في البلد المطلوب اختباره.
- ابدأ مسار الشراء.
يمكنك محو بيانات "متجر Play" وذاكرة التخزين المؤقت، ثم تكرار الخطوتَين رقم 3 و4 مع أي بلد تريد اختباره. بعد التبديل إلى بلد جديد، عليك "محو البيانات" من "متجر Google Play" لإزالة البيانات المتعلقة بالبلد السابق.
تتيح لك هاتان الطريقتان لاختبار عمليات الشراء إمكانية اختبار مدى الأهلية على مستوى منطقة معيّنة وتجربة المستخدم في أي منطقة، بغض النظر عن المكان الذي تُجري فيه الاختبار.
اختبار تجربة الشراء باستخدام طرق دفع حقيقية
يمكنك اختبار تجربة الشراء باستخدام طرق دفع حقيقية من خلال تطبيق Android Play Billing Lab.
اتّبِع الخطوات التالية لاختبار طُرق دفع حقيقية:
- سجِّل مستخدم حساب Google كمختبِر للترخيص.
- تسجيل الدخول إلى تطبيق Play Billing Lab باستخدام المستخدم نفسه
- فعِّل طرق دفع حقيقية في تطبيق Play Billing Lab.
- يُرجى إعادة بدء مسار الشراء في التطبيق الذي يخضع للاختبار.