اختبار المكافآت

‫Play Billing Lab هو تطبيق مصاحب يساعدك في اختبار عمليات التكامل مع نظام الفوترة في Google Play. يمكنك استخدام ميزة اختبار النسخة الحصرية من عمليات الشراء خارج التطبيق (OOAP) في Play Billing Lab للتحقّق من أنّ الخلفية تم إعدادها بشكل صحيح للتعامل مع العناصر التي يتم الحصول عليها خارج تطبيقك، بما في ذلك مكافآت "ألعاب Google Play".

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

المتطلبات الأساسية

قبل استخدام تطبيق Play Billing Lab لاختبار مسارات الشراء خارج التطبيق (OOAP) من أجل التحقّق من صحة إعداد مكافآت "ألعاب Google Play"، تأكَّد من استيفاء المتطلبات التالية:

1. التسجيل في برنامج الاستخدام المبكر لمكافآت "ألعاب Google Play"

2. حالة المختبِر الحائز على ترخيص: يجب تسجيل حسابك التجريبي كمختبِر حائز على ترخيص للّعبة. لمعرفة التفاصيل، يُرجى الاطّلاع على مستندات مختبِري Google Play المرخَّصين.

   ملاحظة: يمكن لأي مستخدم الاطّلاع على تطبيق Play Billing Lab، ولكن لا يمكن إلا للمختبِرين المرخَّصين لدى مطوّري برنامج الاستخدام المبكر (EAP) المدرَجين في القائمة المسموح بها ضبط عمليات تجاوز OOAP وتفعيلها.

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

التنزيل والتثبيت

يمكنك تنزيل تطبيق Play Billing Lab وتثبيته من Google Play:

• متجر Google Play (أجهزة Android): تطبيق Play Billing Lab
• مسار اختبار الويب: الموافقة على استخدام Play Billing Lab على الويب

دليل مفصّل حول دمج واختبار برنامج استخدام المنتج قبل إطلاقه (EAP)

توضّح الخطوات التالية بالتفصيل كيفية دمج مكافآت "ألعاب Google Play" واختبارها باستخدام Play Billing Lab.

الخطوة 1: تشغيل تطبيق Play Billing Lab وتسجيل الدخول

عند فتح تطبيق Play Billing Lab لأول مرة بعد تثبيته:

• انقر على تسجيل الدخول باستخدام حساب Google.
• اختَر حساب Google المسجَّل كمختبِر مرخَّص لتطبيقك.
• بعد تسجيل الدخول، ستظهر لك لوحة البيانات الرئيسية.

لوحة بيانات Play Billing Lab

الخطوة 2: الانتقال إلى اختبار عمليات الشراء خارج التطبيق

• في لوحة البيانات، ابحث عن بطاقة عمليات الشراء خارج التطبيق.
• انقر على اختبار لفتح شاشة إعداد OOAP.

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

الخطوة 3: تحديد اسم حزمة التطبيق ومعرّف المنتج

في شاشة إعداد OOAP، أدخِل معرّفات التطبيقات المطلوبة:

1. اسم الحزمة: اسم حزمة Android الدقيق لتطبيقك (على سبيل المثال، com.example.app).
2. نوع المنتج: استخدِم القائمة المنسدلة لاختيار منتج مدفوع لمرة واحدة (منتج داخل التطبيق) أو اشتراك.
3. معرّف المنتج (رمز التخزين التعريفي): معرّف المنتج داخل التطبيق أو الاشتراك الذي تريد اختباره.

تحديد اسم حزمة التطبيق ومعرّف المنتج

الخطوة 4: اختيار عرض مؤهَّل

بعد إدخال اسم الحزمة ومعرّف المنتج ونوعه، يرسل Play Billing Lab طلبات بحث إلى الخلفية ويعرض قائمة بالعروض المتاحة لهذا المنتج.

تنبيه: لا يتم عرض واختيار سوى العروض المؤهَّلة حاليًا لحساب المختبِر المحدّد. إذا كان حسابك يتضمّن حقًا غير مستخدَم لمنتج معيّن، لن يظهر هذا المنتج.

• بالنسبة إلى المنتجات المدفوعة لمرة واحدة: اختَر خيار الشراء أو العرض المناسب.

  

  اختَر عرضًا مؤهلاً.

الخطوة 5: بدء اختبار OOAP

بعد اختيار العرض، انقر على بدء الاختبار. يتم حفظ الإعدادات ومزامنتها مع خوادم Google Play الخلفية.

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

• فترة الاختبار: تظلّ إعدادات اختبار OOAP النشطة مفعَّلة لمدة ساعتَين تلقائيًا قبل انتهاء صلاحيتها تلقائيًا.

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

  

  ابدأ اختبار OOAP.

الخطوة 6: اختبار عملية الاكتساب الشاملة للعروض الترويجية خارج التطبيق

أثناء تفعيل اختبار OOAP في Play Billing Lab، افتح تطبيق متجر Google Play بعد تسجيل الدخول باستخدام حساب المختبِر الحائز على ترخيص نفسه:

1. محو ذاكرة التخزين المؤقت في "متجر Google Play":
   1. افتح تطبيق الإعدادات على الجهاز.
   2. انقر على التطبيقات > متجر Google Play.
   3. انقر على مساحة التخزين وذاكرة التخزين المؤقت، ثم انقر على محو ذاكرة التخزين المؤقت ومحو مساحة التخزين.
2. افتح تطبيق "متجر Google Play".
3. انتقِل إلى صفحة تفاصيل تطبيقك.

4. إكمال عملية شراء تجريبية (تراكب Play Express): انقر على بطاقة المنتج. تظهر البطاقة السفلية لعملية الدفع السريع في Google Play فوق المحتوى في "متجر Google Play".

   • راجِع السعر ووسيلة الدفع (وسيلة اختبار للمختبِرين المرخَّصين) وتفاصيل العرض.
   • انقر على الشراء بنقرة واحدة لإكمال المعاملة.

   

   اختبار مسار الاكتساب الشامل

5. التحقّق من عملية الدمج في الخلفية:

   • بعد إتمام عملية الشراء بنجاح، تأكَّد من أنّ Google Play يرسل إشعارًا في الوقت الفعلي خاصًا بالمطوّرين (RTDN) إلى خادم الخلفية.
     • ملاحظة: يرسل برنامج "مكافآت Google Play" أيضًا إشعارًا في الوقت الفعلي للمطوّرين.
   • تأكَّد من أنّ خادمك يطلب من Google Play Developer API الإقرار بعملية الشراء ومنح المستخدم الإذن بالوصول إلى المحتوى.
   • تحقَّق من سجلّ الشراء الخاص بالمستخدم في تطبيق "متجر Google Play" للتأكّد من تسجيل طلب الاختبار.

ملاحظة: تضمن هذه الخطوة أنّ الخلفية جاهزة للتعامل مع المكافآت. ترسل مكافآت "ألعاب Google Play" إشعارًا مشابهًا في الوقت الفعلي للمطوّرين (RTDN)، وتتطلّب استخدام واجهة Google Play Developer API نفسها لإعلامنا باستلام الاستحقاق ومنحه، وتسجّل معاملة بقيمة 0 دولار أمريكي في سجلّ شراء المستخدم في تطبيق "متجر Google Play".

الخطوة 7: إيقاف اختبار OOAP ومحو بياناته

بعد الانتهاء من الاختبار:

1. انتقِل إلى صفحة عمليات الشراء خارج التطبيق.
2. انقر على محو الاختبار لإيقاف اختبار OOAP ومحو إعداداته.

محو اختبار OOAP

تعديل إعدادات الاختبار

لا يمكنك تغيير اسم الحزمة أو معرّف المنتج أو اختيار العرض أو تغيير إعدادات تجاهل بلد "متجر Google Play" أثناء إجراء اختبار معاينة OOAP بشكل نشط.

يتطلّب ذلك إيقاف اختبار OOAP الحالي ومحو بياناته

كيفية تعديل المنتج أو العرض

إذا كنت تجري حاليًا اختبارًا لـ OOAP وتريد اختبار منتج أو عرض مختلف:

1. افتح تطبيق Play Billing Lab وانقر على عرض في بطاقة عمليات الشراء خارج التطبيق النشطة.
2. انقر على تعديل لتعديل اسم الحزمة أو معرّف المنتج أو العرض التجريبي.
3. أكِّد إيقاف الاختبار عندما يُطلب منك ذلك. سيتم إيقاف الاختبار ومحو جميع المدخلات ذات الصلة.
4. أدخِل منتجك الجديد أو اختَر العرض الجديد، ثم أعِد تشغيل الاختبار.

تعديل المنتج أو العرض

كيفية اختبار الأسعار المترجَمة باستخدام ميزة "إلغاء السعر في بلد معيّن"

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

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

2. ضبط تجاوز البلد: بعد إيقاف اختبار OOAP، يمكنك تعديل إعداد البلد في صفحة إعدادات الضبط. اختَر البلد المستهدف (على سبيل المثال، اليابان أو المملكة المتحدة) وانقر على تطبيق.

3. إعادة تشغيل اختبار OOAP: بعد تفعيل ميزة "إلغاء البلد"، ارجع إلى بطاقة عمليات الشراء خارج التطبيق، واختَر المنتج والعرض، ثم انقر على بدء الاختبار.

   ستعرض لوحة البيانات الآن كلاً من "تجاوز البلد" النشط و"اختبار OOAP" النشط.

4. التحقّق من السعر المحلي في "متجر Play": افتح "متجر Play" وانتقِل إلى صفحة تفاصيل تطبيقك. ستعرض الآن بطاقة واجهة المستخدم الظاهرة والبطاقة السفلية في Play Express سعر المنتج بالعملة المحلية للبلد الذي تم تجاوزه.

اختبار الأسعار المحدّدة حسب المنطقة باستخدام ميزة "إلغاء السعر في بلد معيّن"

تحديد المشاكل وحلّها والأسئلة الشائعة

لماذا لا يظهر عرضي التجريبي الذي تم ضبطه في صفحة تفاصيل تطبيقي على "متجر Google Play"؟

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

لماذا لا يمكنني اختيار أي عروض أو الاطّلاع عليها عند إعداد منتج في تطبيق Play Billing Lab؟

• أهلية الاستفادة من العروض: لا يعرض تطبيق Play Billing Lab سوى العروض التي يمكن لحساب المختبِر المحدّد شراؤها حاليًا.

لماذا تعذّر إجراء عملية الشراء التجريبية في نافذة Play Express المرافِقة؟

• تأكَّد من أنّ جهازك الاختباري يعمل بنظام التشغيل Android 12 (المستوى 31 لواجهة برمجة التطبيقات) أو إصدار أحدث وأنّه مثبَّت عليه أحدث إصدار من "متجر Google Play".
• يُرجى التحقّق من دمج واجهة برمجة التطبيقات وخطاف الويب الخاص بإشعارات RTDN في الخلفية لتطبيقك. عند إجراء الاختبار من خلال متجر Google Play، تتم عمليات الشراء خارج واجهة المستخدم العادية لتطبيقك. يجب أن يتلقّى خادم الخلفية رسائل RTDN من Google Play بشكل موثوق وأن يقرّ بعمليات الشراء بشكل غير متزامن.

كيف يمكنني إيقاف اختبار نشط أو محوه قبل انتهاء الموقّت الذي تبلغ مدته ساعتين؟

• افتح تطبيق Play Billing Lab، وابحث عن البطاقة النشطة (عمليات الشراء خارج التطبيق أو إعدادات الضبط)، ثم انقر على إيقاف أو حذف. أكِّد اختيارك عندما يُطلب منك ذلك. تتم إزالة الإعدادات البديلة على الفور من خوادم Google Play.