ويجب أن تختبر عملية الدمج خلال عملية التطوير. ولإجراء الاختبار أثناء مرحلة التطوير، ننصحك بالاستعانة بمختبِري الترخيص ومركز الفوترة في 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 Billing Lab إجراء ما يلي أثناء الاختبار:
- غيِّر البلد على Play من مركز الفوترة في Play وطبِّق الإعدادات على الاختبار. يتيح ذلك اختبار تجارب مستخدم مخصّصة في بلدان/مناطق مختلفة بغض النظر عن المكان الذي يُجري فيه المختبِر الاختبار فعليًا.
- يمكنك اختبار العروض التجريبية أو العروض التمهيدية بشكل متكرر باستخدام الحساب نفسه.
- اختبِر تغييرات أسعار الاشتراكات بدون التأثير في المشتركين النشطين الآخرين.
اختبار المنتجات التي يتم تحصيل سعرها مرة واحدة
اختبار المنتجات الاستهلاكية
عند اختبار المنتجات الاستهلاكية، نوصي باختبار مجموعة متنوعة من الحالات، بما في ذلك ما يلي:
- يشير ذلك المصطلح إلى عملية شراء ناجحة يتلقّى المستخدم فيها سلعة. من خلال مختبِر الترخيص، يمكنك استخدام أداة الاختبار، والموافقة دائمًا على طريقة الدفع.
- عملية شراء تعذّر فيها تحصيل الرسوم من طريقة الدفع، ومن المفترض ألا يتسلّم المستخدم المنتج. من خلال أحد مختبِري الترخيص، يمكنك استخدام طريقة الدفع أداة الاختبار، ويتم رفض دائمًا.
- تأكَّد من إمكانية شراء السلع عدة مرات.
عليك أيضًا التأكّد من أنّ عمليات الشراء قد تم الإقرار بها، كما هو موضّح في معالجة عمليات الشراء. بالنسبة إلى عمليات الشراء التي يجريها مختبِرو الترخيص، سيتم ردّ الأموال المدفوعة في عملية الشراء بعد مرور 3 دقائق إذا لم يؤكّد تطبيقك على عملية الشراء وستتلقّى رسالة إلكترونية بشأن عملية الإلغاء. يمكنك أيضًا مراجعة علامة التبويب الطلبات في Google Play Console لمعرفة ما إذا تم ردّ أموال الطلب بعد 3 دقائق.
اختبار المنتجات غير الاستهلاكية
يجب اختبار المواد غير الاستهلاكية بالطريقة نفسها المتّبعة لاختبار المواد الاستهلاكية، ولكن عليك التأكّد من تعذُّر شراء أحد العناصر مرة أخرى داخل تطبيقك. واحرص على التحقّق من إقرار الشراء لكل من المواد الاستهلاكية غير الاستهلاكية والمستهلكة (إن أمكن) لأنّ منطق معالجة كلا نوعَي عمليات الشراء يختلفان.
اختبار عمليات الشراء المعلّقة
عليك اختبار عملية شراء معلّقة والحصول على السلعة عندما
تصبح حالة الشراء PURCHASED. يمكن لمختبِري الترخيص الوصول إلى أداتين من أدوات الاختبار لطرق الدفع المتأخرة، حيث تكتمل عملية الدفع تلقائيًا أو يتم إلغاؤها بعد بضع دقائق.
إجراء عملية شراء باستخدام طريقة دفع متأخرة "بطاقة اختبار بطيء، يرفض الدفع بعد بضع دقائق"، كما هو موضح في الشكل 2. أعِد تشغيل التطبيق وتحقّق من عدم الموافقة على عملية الشراء.
الشكل 3. اختبِر عملية شراء باستخدام بطاقة اختبار بطيئة مرفوضة. إجراء عملية شراء باستخدام طريقة دفع متأخرة "بطاقة اختبار بطيء، يوافق عليها بعد بضع دقائق"، كما هو موضح في الشكل 3. انتظر بضع دقائق، تحقق من أنه تم منح عملية الشراء.
الشكل 4. اختبِر عملية الشراء باستخدام بطاقة اختبار بطيئة موافَق عليها.
يمكنك الاطّلاع على مزيد من المعلومات في المقالة التعامل مع المعاملات في انتظار المراجعة.
اختبار الميزات الخاصة بالاشتراك
تتشابه مسارات الشراء للاشتراكات والمنتجات التي يتم تحصيل سعرها مرة واحدة، ولكن للاشتراكات سيناريوهات إضافية، مثل عمليات تجديد الاشتراك الناجحة أو المرفوضة. لاختبار عمليات التجديد، يمكنك استخدام أداة الاختبار، والموافقة دائمًا واختبار وسيلة الدفع، ويتم رفض دائمًا طرق الدفع المتاحة لمختبِري الترخيص، كما هو موضّح في الشكل 1. استخدِم وسائل الدفع هذه لاختبار سيناريوهات تتجاوز سيناريو الاشتراك الناجح.
على غرار المنتجات التي يتم تحصيل سعرها مرة واحدة، عليك أيضًا التأكّد من الإقرار الصحيح بعمليات الشراء، كما هو موضَّح في معالجة عمليات الشراء. بالنسبة إلى عمليات الشراء التي يجريها مختبِرو الترخيص، سيتم ردّ الأموال المدفوعة في عملية الشراء بعد مرور 3 دقائق إذا لم يؤكّد تطبيقك على أنّها عملية الشراء، وستتلقّى رسالة إلكترونية بشأن عملية الإلغاء. يمكنك أيضًا مراجعة علامة التبويب "الطلبات" في Google Play Console لمعرفة ما إذا تم ردّ أموال الطلب بعد 3 دقائق.
فترات التجديد
يتم تجديد الاشتراكات التجريبية بشكل أسرع من الاشتراكات الفعلية، ويمكن تجديد الاشتراكات التجريبية ست مرات كحد أقصى، بدون احتساب الفترات التجريبية المجانية والفترات التمهيدية.
يسرد الجدول التالي أوقات تجديد الاختبار للاشتراكات ذات المدد المختلفة. هذه الأوقات تقريبية. قد ترى اختلافات طفيفة في الوقت المحدد للحدث. لتعويض الاختلاف، يمكنك طلب بيانات من واجهة برمجة التطبيقات لعرض الحالة الحالية بعد كل تاريخ انتهاء صلاحية اشتراك
| فترة الاشتراك في قناة الإصدار العلني | اختبار تجديد الاشتراك |
| أسبوع واحد | 5 دقائق |
| شهر واحد | 5 دقائق |
| 3 أشهر | 10 دقائق |
| 6 أشهر | 15 دقيقة |
| سنة واحدة | 30 دقيقة |
تم أيضًا اختصار ميزات الاشتراك المستند إلى الوقت، مثل الفترات التجريبية المجانية، بغرض الاختبار. يحدد الجدول التالي الفترات الزمنية للاختبار المرتبطة بميزات الاشتراك المستندة إلى الوقت:
| الميزة | فترة الاختبار |
| إقرار الشراء | 5 دقائق |
| فترة تجريبية مجانية | 3 دقائق |
| فترة السعر التمهيدي | نفس فترة اختبار الاشتراك |
| فترة السماح (تتراوح بين 3 أيام و7 أيام) | 5 دقائق |
| فترة تعليق الاشتراك | 10 دقائق |
| إيقاف مؤقت (لمدة شهر واحد) | 5 دقائق |
| إيقاف مؤقت (شهران) | 10 دقائق |
| الإيقاف المؤقت (3 أشهر) | 15 دقيقة |
عروض الفترات التجريبية
من خلال ميزة اختبار العروض التجريبية في Play Billing Lab، يمكن لمختبِر الترخيص اختبار واستخدام العروض التجريبية المجانية أو العروض التمهيدية بعدد غير محدود من المرات عن طريق وضع علامة في مربّع الاختيار "اختبار فترة تجريبية مجانية أو عرض تمهيدي" وتطبيق التغيير. لن تحتاج بالتالي إلى إنشاء حسابات متعددة لاختبار عرض الفترة التجريبية المتاح فقط للمشتركين الجدد.
تغييرات السعر
يمكنك أيضًا الاستعانة ببرنامج Play Billing Lab ومختبِري الترخيص لاختبار التغييرات في أسعار الاشتراكات بدون التأثير على المشتركين النشطين الآخرين من خلال اتّباع الخطوات التالية:
- انقر على إدارة في بطاقة إعدادات الاشتراك في لوحة البيانات.
- اختَر الاشتراك النشِط الذي تريد اختباره.
- أدخِل السعر الجديد.
- ضَع علامة في مربّع الاختيار إيقاف المستخدم أو أزِل العلامة وفقًا لمتطلبات الاختبار.
- انقر على تطبيق.
بعد تطبيق التغييرات، سيتم تعديل السعر بدءًا من التجديد التالي للمختبِر فقط. ولن يتأثر المشتركون النشطون الآخرون. سيتم تطبيق جميع قواعد مختبِري الترخيص على الاشتراك التجريبي. ويمكن للمختبِر بعد ذلك اختبار تطبيقه بحثًا عن عمليات البيع التي تؤدي إلى حدوث تغيير في السعر، مثل الإشعارات بتغيير السعر.
يُرجى مراعاة الاعتبارات التالية عند التخطيط لفترات الاختبار:
- نظرًا إلى قلة مدة التجديد لمختبِري الترخيص، من المحتمل ألّا يؤدي تغيير السعر الذي يتم من خلال وحدة التحكّم إلى تسجيل مختبِري الترخيص. لضمان إمكانية اختبار الإشعارات والرسائل الإلكترونية حول تغيّر السعر، على المطوّرين تأجيل الفوترة لمدة ساعة واحدة على الأقل بعد تغيير السعر.
- لا تتوفّر فترة إشعار لانخفاضات السعر. يتم إشعار المستخدمين بانخفاض السعر بعد وقت قصير من نقل المجموعة النموذجية. لن يتغير هذا عند الاختبار.
- عند احتساب الزيادات في الأسعار، يتم احتساب مدة إرسال الإشعارات التجريبية بالطريقة نفسها التي يتم بها احتساب
الزيادات الفعلية:
- يتم تحصيل رسوم من المستخدم لأول مرة في الذكرى السنوية الأولى للفوترة بعد مدة الإشعار الإلزامية.
- يتم احتساب أوقات إرسال الإشعارات متأخرة من تاريخ تحصيل الرسوم الأول.
- ويكون الإشعار الأخير دائمًا قبل دقيقة واحدة من تحصيل الرسوم، بغض النظر عن مدة الفوترة.
يعرض الجدول التالي مُدد الفوترة التجريبية والإشعارات لعدّة مُدد فوترة فعلية:
| المدة الزمنية الفعلية للفوترة في الخطة الأساسية | مدة الفوترة التجريبية | اختبار الفترة الزمنية للإشعار (في المناطق التي يتم تفعيل الميزة فيها وإيقافها من خلال إرسال إشعار قبل 30 يومًا) | فترة الإشعار التجريبية (إيقاف الميزة في المناطق التي تتلقّى إشعارًا قبل 60 يومًا) |
| أسبوع واحد | 5 دقائق | 5 دقائق | 10 دقائق |
| شهر واحد | 5 دقائق | 5 دقائق | 10 دقائق |
| 3 أشهر | 10 دقائق | 3 دقائق | 6 دقائق |
| 6 أشهر | 15 دقيقة | دقيقتان | ٤ دقائق |
| سنة واحدة | 30 دقيقة | 3 دقائق | 6 دقائق |
حالات الاختبار
يمكنك توسيع القسم التالي من خلال النقر على إظهار/إخفاء لإظهار سيناريوهات الاختبار التي يجب استخدامها للتحقّق من دمج الاشتراك.
اختبار المعاملات في انتظار المراجعة
عليك اختبار أنه يتم التعامل بشكل صحيح مع المعاملات المعلّقة، ويتم تعديل الاستحقاقات وفقًا لذلك عندما تصبح حالة الشراء PURCHASED. يمكن لمختبِري الترخيص
الوصول إلى أداتي اختبار لطرق الدفع المتأخرة، حيث
تكتمل عملية الدفع تلقائيًا أو يتم إلغاؤها بعد بضع دقائق.
إجراء عملية شراء باستخدام طريقة دفع متأخرة "بطاقة اختبار بطيء، يرفض الدفع بعد بضع دقائق"، كما هو موضح في الشكل 2. أعِد تشغيل التطبيق وتحقّق من عدم الموافقة على عملية الشراء.
الشكل 2. اختبِر عملية شراء باستخدام بطاقة اختبار بطيئة مرفوضة. إجراء عملية شراء باستخدام طريقة دفع متأخرة "بطاقة اختبار بطيء، يوافق عليها بعد بضع دقائق"، كما هو موضح في الشكل 3. انتظر بضع دقائق، تحقق من أنه تم منح عملية الشراء.
الشكل 3. اختبِر عملية الشراء باستخدام بطاقة اختبار بطيئة موافَق عليها.
اختبار الرموز الترويجية
يمكنك استخدام Google Play Console لإنشاء رموز للاختبار الخاص بك. ضع في اعتبارك أنه لا يمكنك إنشاء أكثر من 500 رمز ترويجي كل ربع سنة عبر جميع المنتجات المُدارة في تطبيق معيّن.
عليك اختبار السيناريوهات التالية لتحصيل قيمة الرمز الترويجي:
- عند إدخال الرمز الترويجي في مربّع حوار الشراء الذي تم إطلاقه داخل تطبيقك
- عند تحصيل قيمة الرمز الترويجي في تطبيق "متجر Google Play"
- عند تحصيل قيمة الرمز الترويجي على https://play.google.com/store باستخدام زر تحصيل القيمة في شريط التنقّل الأيمن.
في هذه السيناريوهات، يجب عليك اختبار تحصيل قيمة الرموز بقدر الإمكان. ننصح بإجراء الاختبارات التالية على الأقلّ:
- تحصيل القيمة قبل تثبيت التطبيق
- تحصيل القيمة أثناء تشغيل التطبيق في المقدّمة. ملاحظة: لإجراء هذا الاختبار، أنت بحاجة إلى جهاز آخر لاختباره باستخدام تطبيق "متجر Google Play". احرص على اختبار عمليات تحصيل القيمة على شاشات مختلفة في تطبيقك.
- تحصيل القيمة باستخدام وضع النوافذ المتعددة، حيث يتم عرض تطبيقك وتطبيق "متجر Google Play" في الوقت نفسه
بالنسبة إلى كل اختبار، تأكد من اكتشاف العنصر بشكل صحيح ومن إبلاغ المستخدم.
اختبِر تجربة الشراء في مناطق مختلفة.
ويتيح لك أيضًا برنامج Play Billing Lab ومختبِري الترخيص اختبار مسار الشراء في أي منطقة بدون الحاجة إلى طريقة دفع حقيقية في ذلك البلد. اتّبع الخطوات التالية للاختبار:
- عليك تسجيل مستخدم الفوترة في التطبيق كمختبِر للترخيص.
- سجِّل الدخول إلى مركز الفوترة في Play باستخدام المستخدم نفسه.
- اختَر البلد المطلوب وطبِّق التغيير في مركز الفوترة في Play.
- بدء مسار الشراء في التطبيق الذي يخضع للاختبار.
تتيح لك طريقة اختبار عمليات الشراء هذه اختبار الأهلية على المستوى الإقليمي وتجربة المستخدم في أي منطقة، بغض النظر عن المكان الذي تُجري فيه الاختبار.