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