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