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

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

مختبرو الترخيص

لضبط مختبِري الترخيص، يُرجى الاطّلاع على اختبار الفوترة داخل التطبيقات من خلال ترخيص التطبيق

ويوفّر الاستعانة بمختبِري الترخيص المزايا التالية:

  • يتم عادةً حظر "مكتبة الفوترة في Google Play" على التطبيقات غير التابعة وأن يكون محمَّلاً على 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. يعمل بنظام التشغيل Android 1.6 أو إصدار أحدث. ويُظهر أحدث إصدار من تطبيق يجب تثبيت تطبيق 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 دقائق.

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

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

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

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

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

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

عروض الفترات التجريبية

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك اختبار تجربة الشراء مع برنامج "الفوترة في Play" أو بدونه من خلال اتّباع الخطوات التالية:

الاختبار باستخدام

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

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

الاختبار بدون

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

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

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

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