اختبار دمج "مكتبة الفوترة في Play"

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

عند استخدام مختبِري الترخيص، يمكنك الاستفادة من المزايا التالية:

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

في ما يلي بعض التفاصيل الإضافية عن عملية الشراء التجريبي:

  • تستخدم عمليات الشراء الاختبارية مسار شراء التطبيق نفسه الذي تستخدمه عمليات الشراء الفعلية.
  • لا يتم احتساب الضرائب على عمليات الشراء التجريبية.
  • ويشير Google Play إلى عملية شراء تجريبية من خلال عرض إشعار في منتصف مربّع حوار الشراء.

يمكنك التأكّد من الحساب الذي يجري عملية شراء من خلال توسيع مربّع الحوار "شراء". ملاحظات:

  • يجب أن تكون حسابات الاختبار على جهاز Android الخاص بالمختبِر.
  • إذا كان الجهاز يحتوي على أكثر من حساب واحد، يتم إجراء عملية الشراء باستخدام الحساب الذي نزَّل التطبيق.
  • إذا لم يتم تنزيل التطبيق من خلال أي حساب من الحسابات، يتم إجراء عملية الشراء باستخدام الحساب الأول.

قبل توزيع تطبيقك، يمكنك الاستفادة من مسارات الاختبار على Google Play لإجراء عمليات تحقّق إضافية. على سبيل المثال، يمكنك الاستفادة من مسارات الاختبار لجعل فريق ضمان الجودة لديك يتأهل لإصدار جديد.

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

لاختبار دمج Google Play Billing Library باستخدام مسارات الاختبار، عليك اتّباع الخطوات التالية:

  1. انشر تطبيقك في مسار اختبار. يُرجى العِلم بأنّه بعد نشر تطبيق في مسار اختبار، قد تستغرق إتاحة التطبيق للمختبِرين بضع ساعات.
  2. تأكَّد من أنّ كل مختبِر يوافق على اختبار تطبيقك. على عنوان URL لإعداد الإصدارات التجريبية في الاختبار، سيرى المختبِرون شرحًا لما يعنيه الانضمام إلى المختبِرين مع رابط للموافقة على المشاركة.

يمكنك اختبار عملية الدمج على أي جهاز يعمل بنظام التشغيل Android يعمل بالإصدار 1.6 من نظام التشغيل Android أو إصدار أحدث. ويجب تثبيت أحدث إصدار من تطبيق Google Play على الجهاز. للحصول على معلومات عامة حول كيفية إعداد جهاز للاستخدام في تطوير تطبيقات Android، يُرجى الاطّلاع على استخدام الأجهزة.

اختبار المنتجات التي يتم تحصيل سعرها مرة واحدة

اختبار المنتجات الاستهلاكية

عند اختبار المنتجات الاستهلاكية، نوصي باختبار مجموعة متنوعة من الحالات، بما في ذلك ما يلي:

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

عليك أيضًا التأكّد من أنّ عمليات الشراء قد تم الإقرار بها، كما هو موضّح في معالجة عمليات الشراء. بالنسبة إلى عمليات الشراء التي يجريها مختبِرو الترخيص، سيتم ردّ الأموال المدفوعة في عملية الشراء بعد مرور 3 دقائق إذا لم يؤكّد تطبيقك على عملية الشراء وستتلقّى رسالة إلكترونية بشأن عملية الإلغاء. يمكنك أيضًا مراجعة علامة التبويب الطلبات في Google Play Console لمعرفة ما إذا تم ردّ أموال الطلب بعد 3 دقائق.

اختبار المنتجات غير الاستهلاكية

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

اختبار عمليات الشراء المعلّقة

عليك اختبار عملية شراء معلّقة والحصول على السلعة عندما تصبح حالة الشراء PURCHASED. يمكن لمختبِري الترخيص الوصول إلى أداتين من أدوات الاختبار لطرق الدفع المتأخرة، حيث تكتمل عملية الدفع تلقائيًا أو يتم إلغاؤها بعد بضع دقائق.

  1. إجراء عملية شراء باستخدام طريقة دفع متأخرة "بطاقة اختبار بطيء، يرفض الدفع بعد بضع دقائق"، كما هو موضح في الشكل 2. أعِد تشغيل التطبيق وتحقّق من عدم الموافقة على عملية الشراء.

    اختبار عملية شراء باستخدام بطاقة اختبار بطيئة مرفوضة
    الشكل 2. اختبِر عملية شراء باستخدام بطاقة اختبار بطيئة مرفوضة.

  2. إجراء عملية شراء باستخدام طريقة دفع متأخرة "بطاقة اختبار بطيء، يوافق عليها بعد بضع دقائق"، كما هو موضح في الشكل 3. انتظر بضع دقائق، تحقق من أنه تم منح عملية الشراء.

    اختبار عملية شراء باستخدام بطاقة اختبار بطيئة موافَق عليها
    الشكل 3. اختبِر عملية الشراء باستخدام بطاقة اختبار بطيئة موافَق عليها.

يمكنك الاطّلاع على مزيد من المعلومات في المقالة التعامل مع المعاملات في انتظار المراجعة.

اختبار الميزات الخاصة بالاشتراك

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

على غرار المنتجات التي يتم تحصيل سعرها مرة واحدة، عليك أيضًا التأكّد من الإقرار الصحيح بعمليات الشراء، كما هو موضَّح في معالجة عمليات الشراء. بالنسبة إلى عمليات الشراء التي يجريها مختبِرو الترخيص، سيتم ردّ الأموال المدفوعة في عملية الشراء بعد مرور 3 دقائق إذا لم يؤكّد تطبيقك على أنّها عملية الشراء، وستتلقّى رسالة إلكترونية بشأن عملية الإلغاء. يمكنك أيضًا مراجعة علامة التبويب "الطلبات" في Google Play Console لمعرفة ما إذا تم ردّ أموال الطلب بعد 3 دقائق.

فترات التجديد

يتم تجديد الاشتراكات التجريبية بشكل أسرع من الاشتراكات الفعلية، ويمكن تجديد الاشتراكات التجريبية ست مرات كحد أقصى.

يسرد الجدول التالي أوقات تجديد الاختبار للاشتراكات ذات المدد المختلفة. هذه الأوقات تقريبية. قد ترى اختلافات طفيفة في الوقت المحدد للحدث. لتعويض الاختلاف، يمكنك طلب بيانات من واجهة برمجة التطبيقات لعرض الحالة الحالية بعد كل تاريخ انتهاء صلاحية اشتراك

فترة الاشتراك في قناة الإصدار العلني اختبار تجديد الاشتراك
أسبوع واحد 5 دقائق
شهر واحد 5 دقائق
3 أشهر 10 دقائق
6 أشهر 15 دقيقة
سنة واحدة 30 دقيقة

تم أيضًا اختصار ميزات الاشتراك المستند إلى الوقت، مثل الفترات التجريبية المجانية، بغرض الاختبار. يحدد الجدول التالي الفترات الزمنية للاختبار المرتبطة بميزات الاشتراك المستندة إلى الوقت:

الميزة فترة الاختبار
إقرار الشراء 5 دقائق
فترة تجريبية مجانية 3 دقائق
فترة السعر التمهيدي نفس فترة اختبار الاشتراك
فترة السماح (تتراوح بين 3 أيام و7 أيام) 5 دقائق
الاشتراكات ضمن تعليق حساب 10 دقائق
إيقاف مؤقت (لمدة شهر واحد) 5 دقائق
إيقاف مؤقت (شهران) 10 دقائق
الإيقاف المؤقت (3 أشهر) 15 دقيقة

تغييرات السعر

يمكنك أيضًا الاستعانة بمختبِري الترخيص لاختبار تغييرات الأسعار. ضع الاعتبارات التالية في الاعتبار عند التخطيط لفترات الاختبار:

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

يعرض الجدول التالي مُدد الفوترة التجريبية والإشعارات لعدّة مُدد فوترة فعلية:

المدة الزمنية الفعلية للفوترة في الخطة الأساسية مدة الفوترة التجريبية اختبار الفترة الزمنية للإشعار (في المناطق التي يتم تفعيل الميزة فيها وإيقافها من خلال إرسال إشعار قبل 30 يومًا) فترة الإشعار التجريبية (إيقاف الميزة في المناطق التي تتلقّى إشعارًا قبل 60 يومًا)
أسبوع واحد 5 دقائق 5 دقائق 10 دقائق
شهر واحد 5 دقائق 5 دقائق 10 دقائق
3 أشهر 10 دقائق 3 دقائق ‫6 دقائق
6 أشهر 15 دقيقة دقيقتان ٤ دقائق
سنة واحدة 30 دقيقة 3 دقائق ‫6 دقائق

حالات الاختبار

يمكنك توسيع القسم التالي من خلال النقر على إظهار/إخفاء لإظهار سيناريوهات الاختبار التي يجب استخدامها للتحقّق من دمج الاشتراك.

اختبار الرموز الترويجية

يمكنك استخدام Google Play Console لإنشاء رموز للاختبار الخاص بك. ضع في اعتبارك أنه لا يمكنك إنشاء أكثر من 500 رمز ترويجي كل ربع سنة عبر جميع المنتجات المُدارة في تطبيق معيّن.

عليك اختبار السيناريوهات التالية لتحصيل قيمة الرمز الترويجي:

  • عند إدخال الرمز الترويجي في مربّع حوار الشراء الذي تم إطلاقه داخل تطبيقك
  • عند تحصيل قيمة الرمز الترويجي في تطبيق "متجر Google Play"
  • عند تحصيل قيمة الرمز الترويجي على https://play.google.com/store باستخدام زر تحصيل القيمة في شريط التنقّل الأيمن.

في هذه السيناريوهات، يجب عليك اختبار تحصيل قيمة الرموز بقدر الإمكان. ننصح بإجراء الاختبارات التالية على الأقلّ:

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

بالنسبة إلى كل اختبار، تأكد من اكتشاف العنصر بشكل صحيح ومن إبلاغ المستخدم.

اختبِر تجربة الشراء في مناطق مختلفة.

ويسمح لك مختبِرو الترخيص أيضًا باختبار مسار الشراء في أي منطقة بدون الحاجة إلى طريقة دفع حقيقية في ذلك البلد. اتّبِع الخطوات التالية للاختبار:

  1. أنشِئ حسابًا جديدًا على Gmail. يمكن إنشاء الحساب في أي بلد.
  2. يمكنك إعداد المستخدم كمختبِر للتراخيص.
  3. شبكة VPN في البلد المطلوب لاختباره
  4. ابدأ مسار الشراء.

يمكنك محو بيانات "متجر Play" وذاكرة التخزين المؤقت، ثم تكرار الخطوتين 3 و4 مع أي بلد تريد اختباره. بعد التبديل إلى بلد جديد، يجب عليك محو البيانات المتعلقة بمتجر Google Play لإزالة البيانات المتعلقة بالبلد السابق.

تتيح لك طريقة اختبار عمليات الشراء هذه اختبار الأهلية على المستوى الإقليمي وتجربة المستخدم في أي منطقة، بغض النظر عن المكان الذي تُجري فيه الاختبار.