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

يجب أن تختبر التكامل خلال عملية التطوير. للاختبار خلال مرحلة التطوير، ننصحك بالاستعانة بمختبِري التراخيص ومركز الفوترة في 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، راجع استخدام الأجهزة.

برنامج الفوترة في Play

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

تتيح لك ميزة "الفوترة في Play" الاختبارية إجراء ما يلي خلال الاختبار:

لوحة البيانات في Play Billing Lab
الشكل 2. لوحة بيانات برنامج Play Billing Lab.

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

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

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

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

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

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

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

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

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

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

    اختبار عملية شراء ببطاقة اختبار بطيء مرفوضة
    الشكل 3. اختبار عملية شراء ببطاقة اختبار بطيء مرفوضة

  2. إجراء عملية شراء باستخدام طريقة دفع متأخرة "بطاقة الاختبار البطيئة، تتم الموافقة بعد بضع دقائق"، كما هو موضح في الشكل 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، يمكن لمختبِر الترخيص اختبار الفترة التجريبية المجانية أو العروض التمهيدية واستخدامها لعدد غير محدود من المرات من خلال وضع علامة في مربّع الاختيار "اختبار فترة تجريبية مجانية أو عرض تمهيدي" وتطبيق التغيير. بهذه الطريقة، لن تحتاج إلى إنشاء حسابات متعدّدة لاختبار عرض الفترة التجريبية المتوفّر فقط للمشتركين الجدد.

عروض الفترات التجريبية التجريبية
الشكل 5. عروض الفترات التجريبية التجريبية

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

يمكنك أيضًا الاستعانة ببرنامج الفوترة في Play ومختبِري التراخيص لاختبار التغييرات في أسعار الاشتراكات بدون التأثير في المشتركين النشطين الآخرين، وذلك باتّباع الخطوات التالية:

  1. انقر على إدارة في بطاقة إعدادات الاشتراك في لوحة البيانات.
  2. اختَر الاشتراك النشِط الذي تريد اختباره.
  3. أدخِل السعر الجديد.
  4. ضَع علامة في مربّع الاختيار إيقاف اشتراك المستخدم أو أزِل العلامة لكل متطلبات الاختبار.
  5. انقر على تطبيق.
تغيير في سعر الاشتراك التجريبي
الشكل 6. تغيير في سعر الاشتراك التجريبي:

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

يجب أخذ الاعتبارات التالية في الاعتبار عند التخطيط لفترات الاختبار:

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

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

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

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

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

اختبار المعاملات التي في انتظار المراجعة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. يمكنك تسجيل مستخدم فوترة التطبيق كمختبِر للترخيص.
  2. تسجيل الدخول إلى برنامج "الفوترة في Play" باستخدام المستخدِم نفسه
  3. اختَر البلد المطلوب وطبِّق التغيير في الميزة الاختبارية "الفوترة في Play".
  4. ابدأ مسار الشراء في التطبيق قيد الاختبار.
تجربة الشراء في مناطق مختلفة
الشكل 7. تجربة تجربة الشراء في مناطق مختلفة:

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