يجب اختبار عملية الدمج طوال فترة التطوير. لاختبار الميزة أثناء مرحلة التطوير، ننصحك بالاستفادة من مختبِري التراخيص وبرنامج Play Billing Lab لتنفيذ السيناريوهات الموضّحة في هذا القسم.
مختبرو الترخيص
لضبط إعدادات مختبِري الترخيص، راجِع مقالة اختبار الفوترة داخل التطبيقات من خلال ترخيص التطبيق.
يوفّر استخدام مختبِري الترخيص المزايا التالية:
- في العادة، تكون "مكتبة الفوترة في Google Play" محظورة للتطبيقات التي لم يتم توقيعها وتحميلها إلى Google Play. يمكن لمختبِري الترخيص تجاوز عملية التحقّق هذه، ما يعني أنّه يمكنك تثبيت التطبيقات من مصدر غير معروف لاختبارها، حتى بالنسبة إلى التطبيقات التي تستخدم إصدارات تصحيح الأخطاء مع توقيعات تصحيح الأخطاء بدون الحاجة إلى تحميلها إلى الإصدار الجديد من تطبيقك. يُرجى العلم أنّ اسم الحزمة يجب أن يتطابق مع اسم التطبيق الذي تم إعداده لـ Google Play، ويجب أن يكون حساب Google مختبِر ترخيص لحساب Google Play Console.
- يمكن لمختبِري الترخيص الوصول إلى طرق الدفع التجريبية التي تتجنّب تحصيل رسوم حقيقية من المختبِرين مقابل عمليات الشراء. يمكنك أيضًا استخدام methods methods لاختبار مواقف معيّنة، مثل رفض payment methods. يعرض الشكل 1 نماذج الدفع التجريبية هذه كما تظهر في مسار الشراء.
- يمكن لمختبِري الترخيص اختبار ميزات الاشتراك بسرعة.
في ما يلي بعض التفاصيل الإضافية حول عملية الشراء التجريبية:
- تستخدِم عمليات الشراء التجريبية مسار الشراء نفسه في التطبيق الذي تستخدِمه عمليات الشراء الفعلية.
- لا يتم احتساب الضرائب على عمليات الشراء التجريبية.
- يشير Google Play إلى عملية الشراء التجريبية من خلال عرض إشعار في وسط مربّع حوار الشراء.
يمكنك تأكيد الحساب الذي يُجري عملية الشراء من خلال توسيع مربع diálogo de compra. ملاحظات:
- يجب أن تكون الحسابات الاختبارية على جهاز Android الخاص بالمختبِر.
- إذا كان الجهاز يتضمّن أكثر من حساب واحد، تتم عملية الشراء باستخدام الحساب الذي تم تنزيل التطبيق من خلاله.
- إذا لم ينزِّل أي من الحسابات التطبيق، تتم عملية الشراء باستخدام الحساب الأول.
قبل توزيع تطبيقك، يمكنك الاستفادة من قنوات الاختبار في Google Play للقيام بعمليات تحقّق إضافية. على سبيل المثال، يمكنك الاستفادة من مسارات الاختبار لإجازة فريق تأكيد الجودة لإصدار جديد.
من خلال مسارات الاختبار، يمكن للمستخدمين تثبيت تطبيقك من Google Play واختبار إصدار من تطبيقك غير متاح للجميع بعد. يمكن للمستخدمين إجراء عمليات شراء حقيقية باستخدام أي من طرق الدفع في Google Play.
لاختبار عملية دمج Google Play Billing Library باستخدام مسارات الاختبار، عليك تنفيذ خطوات التالية:
- انشر تطبيقك على أحد مسارات الاختبار. يُرجى العِلم أنّه بعد نشر تطبيق على مسار اختبار، قد يستغرق التطبيق بضع ساعات ليتمكّن المختبِرون من الوصول إليه.
- تأكَّد من أنّ كل مختبِر يوافق على اختبار تطبيقك. في عنوان URL الخاص بإعداد الإصدارات التجريبية، يظهر للمختبِرين شرحًا عما يمثّله الانضمام إلى المختبِرين، بالإضافة إلى رابط للموافقة على المشاركة.
يمكنك اختبار عملية الدمج على أي جهاز Android يعمل بالإصدار 1.6 من نظام التشغيل Android أو إصدار أحدث. يجب تثبيت أحدث إصدار من تطبيق Google Play على الجهاز. للحصول على معلومات عامة حول كيفية إعداد جهاز لاستخدامه في تطوير تطبيقات Android، يُرجى الاطّلاع على مقالة استخدام الأجهزة.
برنامج الفوترة في Play
"برنامج الفوترة في Play" هو تطبيق Android يساعد المطوّرين على اختبار عملية دمج تطبيقاتهم مع نظام الفوترة في Google Play. وتوفّر هذه الطريقة للمطوّرين طريقة سهلة ومريحة لاختبار ميزات الفوترة والدمج بشكل أسرع وإطلاق التطبيقات بثقة أكبر. يمكنك تنزيل "برنامج الفوترة في Play" وتثبيته من متجر Play.
يتيح لك برنامج "الفوترة في Play" إجراء ما يلي أثناء الاختبار:
- غيِّر بلد Play من داخل Play Billing Lab وطبِّق الإعدادات على الاختبار. يتيح ذلك اختبار تجارب المستخدمين المخصّصة في بلدان أو مناطق مختلفة بغض النظر عن مكان اختبار المختبِر الجغرافي
- اختبار الفترات التجريبية أو العروض الترويجية التمهيدية بشكل متكرّر باستخدام الحساب نفسه
- اختبار تغييرات أسعار الاشتراك بدون التأثير في المشتركين النشطين الآخرين
- تسريع عمليات تجديد الاشتراكات لتسريع عملية الاختبار
اختبار المنتجات التي يتم تحصيل سعرها مرة واحدة
اختبار المنتجات الاستهلاكية
عند اختبار المنتجات الاستهلاكية، عليك اختبار مجموعة متنوعة من الحالات، بما في ذلك ما يلي:
- عملية شراء ناجحة يتلقّى فيها المستخدم سلعة باستخدام مختبِر الترخيص، يمكنك استخدام طريقة الدفع أداة اختبار، والموافقة دائمًا.
- عملية شراء تعذّر فيها تحصيل الرسوم من طريقة الدفع، ومن المفترض أن لا يستلم المستخدم السلعة. باستخدام مختبِر الترخيص، يمكنك استخدام طريقة الدفع أداة اختبار، والرفض دائمًا.
- تأكَّد من إمكانية شراء العناصر عدة مرات.
تأكَّد من أنّ عمليات الشراء يتم الردّ عليها بشكل صحيح كما هو موضّح في معالجة عمليات الشراء. بالنسبة إلى عمليات الشراء التي يجريها مختبِرو الترخيص، سيتم ردّ الأموال المدفوعة مقابل عملية الشراء بعد 3 دقائق إذا لم يُقرّ تطبيقك بعملية الشراء، وستتلقّى رسالة إلكترونية بشأن الإلغاء. يمكنك أيضًا الانتقال إلى علامة التبويب الطلبات في Google Play Console لمعرفة ما إذا تم ردّ أموال طلب بعد 3 دقائق.
اختبار المنتجات غير الاستهلاكية
يجب اختبار العناصر غير الاستهلاكية بالطريقة نفسها التي يتم بها اختبار العناصر الاستهلاكية، ولكن يجب التأكّد من أنّه لا يمكن شراء العنصر مرة أخرى داخل تطبيقك. احرص على التحقّق من إقرار الشراء لكل من العناصر غير الاستهلاكية والعناصر الاستهلاكية (عند الضرورة) لأنّ منطق معالجة كل نوع من النوعَين من عمليات الشراء يختلف.
اختبار عمليات الشراء المعلّقة
اختبِر عملية شراء في انتظار المراجعة حيث من المفترض أن يتم منح المنتج عندما تصبح حالة الشراءPURCHASED
. يمكن لمختبِري الترخيص استخدام أداتين للتحقّق من طرق الدفع التي تستغرق وقتًا أطول لإتمام عملية الدفع أو إلغائها تلقائيًا بعد بضع دقائق.
إجراء عملية شراء باستخدام طريقة دفع بطيئة بطاقة اختبار بطيء، الرفض بعد بضع دقائق، كما هو موضّح في الشكل 3 أعِد تشغيل التطبيق، وتأكَّد من أنّه لم يتم منح إذن الشراء.
إجراء عملية شراء باستخدام طريقة دفع بطيئة بطاقة اختبار بطيء، الموافقة بعد بضع دقائق، كما هو موضّح في الشكل 4 انتظِر بضع دقائق، ثمّ التحقّق من أنّه تم منح الإذن بإجراء عملية الشراء
يمكنك الاطّلاع على مزيد من المعلومات في مقالة معالجة المعاملات المعلّقة.
اختبار الميزات الخاصة بالاشتراك
تُعدّ عمليات الشراء للمنتجات التي يتم تحصيل سعرها لمرة واحدة والاشتراكات متشابهة، ولكن تتضمن الاشتراكات سيناريوهات إضافية، مثل عمليات تجديد الاشتراك الناجحة أو المرفوضة. لاختبار عمليات التجديد، يمكنك استخدام بطاقة الاختبار، والموافقة دائمًا، وبطاقة الاختبار، والرفض دائمًا طرق الدفع المتاحة لمختبِري الترخيص، كما هو موضّح في الرسم 1. استخدِم أدوات الدفع هذه لاختبار سيناريوهات أخرى غير سيناريو الاشتراك الناجح.
على غرار المنتجات التي يتم تحصيل سعرها مرة واحدة، تأكَّد من أنّ عمليات الشراء تتم الاعتذار عنها بشكل صحيح على النحو الموضّح في معالجة عمليات الشراء. بالنسبة إلى عمليات الشراء التي يجريها مختبِرو الترخيص، يتم ردّ الأموال المدفوعة بعد 3 دقائق إذا لم يتلقّ تطبيقك تأكيدًا على عملية الشراء، وستتلقّى رسالة إلكترونية بشأن الإلغاء. يمكنك أيضًا الانتقال إلى علامة التبويب الطلبات في Google Play Console للاطّلاع على ما إذا تم ردّ أموال طلب معيّن بعد 3 دقائق.
فترات التجديد
يتم تجديد الاشتراكات التجريبية بشكل أسرع من الاشتراكات الفعلية، ويمكن تجديد الاشتراكات التجريبية ست مرات كحد أقصى، باستثناء الفترات التجريبية والمرحلة التمهيدية المجانية.
يسرد الجدول التالي أوقات تجديد الاختبار للاشتراكات التي تبلغ مدّتها مددًا مختلفة. هذه الأوقات تقريبية. قد تلاحظ اختلافات صغيرة في الوقت الدقيق لأحد الأحداث. للتعويض عن الاختلاف، يمكنك استدعاء واجهة برمجة التطبيقات للاطّلاع على الحالة الحالية بعد كل تاريخ انتهاء صلاحية اشتراك.
فترة اشتراك مرحلة الإنتاج | اختبار تجديد الاشتراك |
أسبوع واحد | ٥ دقائق |
شهر واحد | ٥ دقائق |
3 أشهر | 10 دقائق |
6 أشهر | 15 دقيقة |
سنة واحدة | 30 دقيقة |
يتم أيضًا تقصير ميزات الاشتراك المستندة إلى الوقت، مثل الفترات التجريبية المجانية، بغرض الاختبار. يحدِّد الجدول التالي الفترات الزمنية للاختبار المرتبطة بميزات الاشتراك المستندة إلى الوقت:
الميزة | فترة الاختبار |
إشعار بالاستلام | ٥ دقائق |
تجربة مجانية | 3 دقائق |
فترة السعر التمهيدي | مثل فترة اختبار الاشتراك |
فترة السماح (كل من 3 و7 أيام) | ٥ دقائق |
تعليق الحساب | 10 دقائق |
إيقاف مؤقت (لمدة شهر واحد) | ٥ دقائق |
إيقاف مؤقت (شهران) | 10 دقائق |
الإيقاف المؤقت (3 أشهر) | 15 دقيقة |
تسريع التجديد
يمكنك أيضًا استخدام Play Billing Lab ومختبِري الترخيص لتسريع فترات تجديد الاشتراكات التجريبية باتّباع الخطوات التالية:
- انقر على إدارة في بطاقة إعدادات الاشتراك في لوحة البيانات.
- اختَر الاشتراك النشط الذي تريد اختباره.
- انقر على تجديد الآن.
بعد النقر على الزر تجديد الآن، سيتم تجديد الاشتراك التجريبي بعد ذلك بوقت قصير.
يُرجى مراعاة ما يلي:
- يجب الموافقة على الاشتراكات التجريبية قبل استخدام ميزة "التجديد المُسرَّع"، وإلا سيتم إلغاء الاشتراك.
- قد تستغرق عملية التجديد بضع ثوانٍ.
- لا يتوفّر الزر تجديد الآن عندما يكون تغيير السعر ساريًا.
- لا تتوفّر ميزة تغيير سعر الاشتراك عند تجديده.
عروض الفترات التجريبية
باستخدام ميزة اختبار العروض التجريبية في Play Billing Lab، يمكن لختبِر الترخيص استخدام الفترات التجريبية المجانية أو العروض التمهيدية واختبارها عددًا محدودًا من المرات من خلال وضع علامة في مربّع الاختيار اختبار الفترة التجريبية المجانية أو العرض الترويجي التمهيدي وتطبيق التغيير. ويؤدي ذلك إلى عدم الحاجة إلى إنشاء عدة حسابات لاختبار عرض ترويجي تجريبي متاح للمشتركين الجدد فقط.
تغييرات السعر
يمكنك أيضًا استخدام Play Billing Lab ومختبِري الترخيص لاختبار تغييرات سعر الاشتراك بدون التأثير في المشتركين النشطين الآخرين باتّباع الخطوات التالية:
- انقر على إدارة في بطاقة إعدادات الاشتراك في لوحة البيانات.
- اختَر الاشتراك النشط الذي تريد اختباره.
- أدخِل السعر الجديد.
- ضَع علامة في مربّع الاختيار إيقاف الميزة من قِبل المستخدم أو أزِلها وفقًا لمتطلبات الاختبار.
- انقر على تطبيق.
بعد تطبيق التغييرات، يتم تعديل السعر بدءًا من عملية التجديد التالية للمختبِر فقط. ولن يتأثّر المشتركون النشطون الآخرون. تنطبق جميع قواعد مختبِري الترخيص على الاشتراك التجريبي. يمكن للمختبِر بعد ذلك اختبار تطبيقه بحثًا عن العمليات التي يتم بدءها بعد تغيير السعر، مثل إشعارات تغيير السعر.
يُرجى مراعاة الاعتبارات التالية عند التخطيط لفترات الاختبار:
- بسبب مدة التجديد القصيرة لمختبِري الترخيص، من المحتمل أنّ عملية نقل الأسعار التي يتم إجراؤها من وحدة التحكّم لن يتم تسجيلها لمختبِري الترخيص. لضمان إمكانية اختبار الإشعارات عبر البريد الإلكتروني وإشعارات تغيير السعر، على المطوّرين تأجيل الفوترة لمدة ساعة واحدة على الأقل بعد إجراء تغيير في السعر.
- لا يتم إرسال إشعارات بشأن انخفاض الأسعار. يتم إرسال إشعار إلى المستخدمين بشأن انخفاض السعر بعد فترة قصيرة من نقل بيانات المجموعة النموذجية. ولا يتغيّر هذا الإعداد عند الاختبار.
- بالنسبة إلى الزيادات في الأسعار، يتم احتساب أوقات إرسال الإشعارات التجريبية بالطريقة نفسها التي يتم بها احتساب مدة إرسال الإشعارات عند حدوث الزيادات الفعلية:
- يتم تحصيل الرسوم من المستخدم لأول مرة في الذكرى السنوية الأولى للفوترة بعد فترة إشعار إلزامية.
- يتم احتساب أوقات الإشعارات تنازليًا من تاريخ تحصيل الرسوم لأول مرة.
- يظهر الإشعار النهائي دائمًا قبل دقيقة واحدة من تحصيل الرسوم، بغض النظر عن فترة الفوترة.
يعرض الجدول التالي فترات الفوترة التجريبية والإشعارات لعدة فترات فوترة فعلية:
مدة الفوترة الفعلية للخطة الأساسية | فترة الفوترة التجريبية | فترة الإشعار التجريبي (المناطق التي تم تفعيل الميزة فيها والمناطق التي تم إيقاف الميزة فيها مع إشعار مسبق مدّته 30 يومًا) | فترة إرسال الإشعارات التجريبية (للمناطق التي تم إيقاف الميزة فيها مع إرسال إشعار مسبق مدّته 60 يومًا) |
أسبوع واحد | ٥ دقائق | ٥ دقائق | 10 دقائق |
شهر واحد | ٥ دقائق | ٥ دقائق | 10 دقائق |
3 أشهر | 10 دقائق | 3 دقائق | ٦ دقائق |
6 أشهر | 15 دقيقة | دقيقتان | 4 دقائق |
سنة واحدة | 30 دقيقة | 3 دقائق | ٦ دقائق |
حالات الاختبار
وسِّع القسم التالي بالنقر على إظهار/إخفاء لعرض سيناريوهات الاختبار التي يجب استخدامها للتحقّق من عملية دمج الاشتراك.
اختبار المعاملات المعلّقة
يجب اختبار معالجة المعاملات التي في انتظار المراجعة بشكل صحيح وتعديل الأذونات
وفقًا لذلك عندما تصبح حالة الشراء PURCHASED
. يمكن لمختبِري التراخيص
الوصول إلى أداتَي اختبار لأشكال الدفع التي تتأخّر فيها اكتمال عملية الدفع أو إلغاؤها تلقائيًا بعد بضع دقائق.
إجراء عملية شراء باستخدام طريقة دفع بطيئة بطاقة اختبار بطيء، الرفض بعد بضع دقائق، كما هو موضّح في الشكل 8 أعِد تشغيل التطبيق، وتأكَّد من أنّه لم يتم منح إذن الشراء.
إجراء عملية شراء باستخدام طريقة دفع بطيئة بطاقة اختبار بطيء، الموافقة بعد بضع دقائق، كما هو موضّح في الشكل 9. انتظِر بضع دقائق، ثمّ تحقَّق مما إذا تم منح الإذن بإجراء عملية الشراء.
اختبار الرموز الترويجية
يمكنك استخدام Google Play Console للقيام بما يلي: إنشاء رموز لاختبار تطبيقك بنفسك. يُرجى العِلم أنّه يمكنك إنشاء 500 رمز ترويجي فقط كل ربع سنة في كل المنتجات المُدارة في التطبيق.
عليك اختبار سيناريوهات تحصيل قيمة الرمز الترويجي التالية:
- عند إدخال الرمز الترويجي في مربّع حوار الشراء الذي تمّ إطلاقه داخل تطبيقك.
- عند تحصيل قيمة الرمز الترويجي في تطبيق "متجر Google Play"
- عند تحصيل قيمة الرمز الترويجي على الرابط https://play.google.com/store باستخدام الزر تحصيل القيمة في شريط التنقّل الأيمن
ضمن هذه السيناريوهات، يجب اختبار رموز تحصيل القيمة بأكبر عدد ممكن من الطرق. عليك إجراء الاختبارات التالية على الأقل:
- تحصيل قيمة البطاقة قبل تثبيت التطبيق
- تحصيل القيمة أثناء تشغيل التطبيق في المقدّمة يُرجى العِلم أنّه لإجراء هذا الاختبار، ستحتاج إلى جهاز آخر للاختبار باستخدام تطبيق "متجر Google Play". احرص على اختبار عمليات تحصيل القيمة من شاشات مختلفة في تطبيقك.
- تحصيل القيمة باستخدام وضع النوافذ المتعددة، حيث يتم عرض تطبيقك وتطبيق "متجر Google Play" في الوقت نفسه
في كل اختبار، تأكَّد من رصد العنصر بشكل صحيح ومن إعلام العميل.
اختبار تجربة الشراء في مناطق مختلفة
يمكنك اختبار تجربة الشراء باستخدام تطبيق Play Billing Lab أو بدونه:
الاختبار باستخدام
يتيح لك تطبيق برنامج الفوترة في Play لأجهزة Android اختبار مجرى الشراء في أي منطقة. ومع ذلك، يجب أن تكون مختبِرًا للترخيص لاستخدام "برنامج Play Billing Lab". اتّبِع الخطوات التالية للاختبار:
- سجِّل مستخدم الفوترة داخل التطبيق كأحد مختبِري الترخيص.
- سجِّل الدخول إلى تطبيق "برنامج الفوترة في Play" باستخدام المستخدم نفسه.
- اختَر البلد المطلوب وطبِّق التغيير في "برنامج الفوترة في Play".
- ابدأ عملية الشراء في التطبيق الذي يتم اختباره.
الاختبار بدون
يمكنك أيضًا اختبار عملية الشراء في أي منطقة بدون استخدام Play Billing Lab. اتّبِع الخطوات التالية للاختبار:
- أنشئ حساب Gmail جديدًا. يمكن إنشاء الحساب في أي بلد.
- يمكنك اختياريًا إعداد المستخدم كمختبِر ترخيص.
- استخدام شبكة VPN للاتصال بالبلد المطلوب اختباره
- ابدأ مسار الشراء.
يمكنك محو بيانات "متجر Play" وذاكرة التخزين المؤقت، ثم تكرار الخطوتَين 3 و4 مع أي بلد تريد اختباره. بعد التبديل إلى بلد جديد، عليك محو البيانات في "متجر Google Play" لإزالة البيانات المرتبطة بالبلد السابق.
تتيح لك كلتا الطريقتَين لاختبار عمليات الشراء اختبار الأهلية الإقليمية للعرض وتجربة المستخدم في أي منطقة، بغض النظر عن مكان إجراء الاختبار.